Changes between Version 60 and Version 61 of AccountManagerPlugin


Ignore:
Timestamp:
Nov 25, 2008, 10:29:39 AM (6 years ago)
Author:
hamaryns
Comment:

remove duplicate information, comment about setuptools, symbols

Legend:

Unmodified
Added
Removed
Modified
  • AccountManagerPlugin

    v60 v61  
    1111
    1212These features are new in the plugin for Trac 0.10.
    13  * send a new password to users who've forgotten their password
     13 * send a new password to users whove forgotten their password
    1414 * administration of user accounts
    1515
     
    2424== Install ==
    2525
    26 First make sure you've [trac:wiki:TracPlugins#Requirements installed setuptools].
     26First make sure you’ve [trac:wiki:TracPlugins#Requirements installed setuptools].  Make sure you have a version >= 0.6c9, since previous versions contain a bug which makes the installation fail.
    2727
    2828Then you can install the plugin using the `easy_install` application.
     
    100100
    101101[[html(<div class="system-message">)]]
    102 '''Warning:''' This password method may not work with [t:TracModPython mod_python] due to a [http://tjulo.blogspot.com/2007/03/problems-with-md5-and-modpython.html bug using Python's md5 module under mod_python].  If you experience problems try [t:TracFastCgi FastCGI], [t:wiki:TracModWSGI mod_wsgi], or [t:TracStandalone tracd].
     102'''Warning:''' This password method may not work with [t:TracModPython mod_python] due to a [http://tjulo.blogspot.com/2007/03/problems-with-md5-and-modpython.html bug using Pythons md5 module under mod_python].  If you experience problems try [t:TracFastCgi FastCGI], [t:wiki:TracModWSGI mod_wsgi], or [t:TracStandalone tracd].
    103103[[html(</div>)]]
    104104
     
    121121password_file = /var/trac/trac.htdigest
    122122
    123 ; the name of the authentication "realm"
     123; the name of the authentication “realm”
    124124; it can be any text to identify your site or project
    125125htdigest_realm = TracRealm
     
    132132
    133133[[html(<div class="system-message">)]]
    134 '''Warning:''' This password method may not work with [t:TracModPython mod_python] due to a [http://tjulo.blogspot.com/2007/03/problems-with-md5-and-modpython.html bug using Python's md5 module under mod_python].  If you experience problems try [t:TracFastCgi FastCGI], [t:wiki:TracModWSGI mod_wsgi], or [t:TracStandalone tracd].
     134'''Warning:''' This password method may not work with [t:TracModPython mod_python] due to a [http://tjulo.blogspot.com/2007/03/problems-with-md5-and-modpython.html bug using Pythons md5 module under mod_python].  If you experience problems try [t:TracFastCgi FastCGI], [t:wiki:TracModWSGI mod_wsgi], or [t:TracStandalone tracd].
    135135[[html(</div>)]]
    136136
     
    177177{{{
    178178<Directory /var/www/html/path>
    179    ...HTTP authentication configuration...
     179   …HTTP authentication configuration…
    180180   Require valid-user
    181181</Directory>
     
    225225 '''Package''':: acct_mgr.web_ui
    226226
    227 Allows users to change their password, or delete their account.  When logged in it will appear as a tab "Account" after clicking the "Preferences" link.
     227Allows users to change their password, or delete their account.  When logged in it will appear as a tab “Account” after clicking the “Preferences” link.
    228228
    229229{{{
     
    234234[[Image(my-account.png)]]
    235235
    236 '''New for Trac 0.10:''' When used in combination with the [wiki:AccountManagerPlugin#LoginModule LoginModule] it adds a link to the login page "Forgot your password?" where users can reset their password if they've forgotten it. You will need to have your SMTP server information configured in your {{{trac.ini}}} for the "Forgot your password?" link to show up.
     236'''New for Trac 0.10:''' When used in combination with the [wiki:AccountManagerPlugin#LoginModule LoginModule] it adds a link to the login page “Forgot your password?” where users can reset their password if they’ve forgotten it. You will need to have your SMTP server information configured in your {{{trac.ini}}} for the “Forgot your password?” link to show up.
    237237
    238238[[Image(reset-password.png)]]
    239239
    240 '''New for Trac 0.11:''' When a user resets their password they will be required to change their password on the next successful login.  This can be disabled via the `trac.ini` by setting `force_passwd_change = false`
     240'''New for Trac 0.11:''' When a user resets their password they will be required to change their password on the next successful login.  This can be disabled via the `trac.ini` by setting `force_passwd_change = false`.
    241241
    242242=== !LoginModule ===
     
    247247Allows users to login via a HTML form instead of using HTTP authentication.
    248248
    249 In order to use this plugin you will need to disable the default Trac login module:
    250 {{{
    251 [components]
    252 trac.web.auth.LoginModule = disabled
    253 acct_mgr.web_ui.LoginModule = enabled
    254 }}}
    255 
    256 You will also need to '''remove''' any authentication methods on the "login" page from your Apache configuration that you may have set up during cgi or mod_python setup, e.g., look for and remove something like the following lines
    257 {{{
    258 <Location /trac/myproject/login>
    259   AuthType Basic
    260   AuthName "Bio Scripts Trac Login"
    261   AuthUserFile /path/to/trac.htpasswd
    262   Require valid-user
    263 </Location>
    264 }}}
    265 
    266249[[Image(login-form.png)]]
    267250
    268251==== Disable HTTP authentication ====
    269252
    270 To use the AccountManager's form-based login system instead, add this to the
    271 "`[components]`" section of your trac.ini:
     253To use the AccountManagers form-based login system instead, add this to the
     254`[components]` section of your trac.ini:
    272255
    273256{{{
     
    275258}}}
    276259
    277 When using the [trac:TracStandalone tracd] server be sure '''not''' to use the "`--auth`" or "`--basic-auth`" options.  Using either of these options will cause tracd to popup the username/password dialog box and you will not be able to use the HTML form.
     260When using the [trac:TracStandalone tracd] server be sure '''not''' to use the `--auth` or `--basic-auth` options.  Using either of these options will cause tracd to popup the username/password dialog box and you will not be able to use the HTML form.
    278261
    279262If you have previously enabled authentication for Trac on Apache, you will need to disable it or Apache will popup the username/password dialog and you will be unable to use the HTML form.  In order to disable the authentication look for a section in the Apache configuration file like:
     
    286269}}}
    287270
    288 Deleting or commenting the `Require valid-user` line should be sufficient to disable HTTP authentication.  After you've tested it you can probably delete or comment out the rest of the authentication options.
     271Deleting or commenting the `Require valid-user` line should be sufficient to disable HTTP authentication.  After youve tested it you can probably delete or comment out the rest of the authentication options.
    289272
    290273=== !RegistrationModule ===
    291274 '''Package''':: acct_mgr.web_ui
    292275
    293 Enables users to register a new account.  It adds a "Register" link on the same menu bar as the "Login" link.
     276Enables users to register a new account.  It adds a “Register” link on the same menu bar as the “Login” link.
    294277
    295278{{{
     
    303286'''Warning:''' You must enable one of the above password storage modules for the Registration Module to work.
    304287[[html(</div>)]]
    305 '''Note:''' You must not enable `ignore_auth_case` in `trac.ini` as otherwise this module wont work.
     288'''Note:''' You must not enable `ignore_auth_case` in `trac.ini` as otherwise this module wont work.
    306289
    307290== Post Setup/Configuration ==
    308291
    309 In order to use the Account Manager plugin, while logged in as a user with TRAC_ADMIN rights, use the new "Admin" link on the menubar.
    310 
    311 Once in, you might want to enable the permissions to allow the "authenticated" user group permissions.  For instance, if you remove the anonymous group from TICKET_MODIFY, and WIKI_MODIFY, and add the "authenticated" group instead, only authenticated, logged-in (registered) users can perform ticket modifications and wiki editing.
     292In order to use the Account Manager plugin, while logged in as a user with TRAC_ADMIN rights, use the new “Admin” link on the menubar.
     293
     294Once in, you might want to enable the permissions to allow the “authenticated” user group permissions.  For instance, if you remove the anonymous group from TICKET_MODIFY, and WIKI_MODIFY, and add the “authenticated” group instead, only authenticated, logged-in (registered) users can perform ticket modifications and wiki editing.
    312295
    313296== Author/Contributors ==