Changes between Version 60 and Version 61 of AccountManagerPlugin


Ignore:
Timestamp:
Nov 25, 2008 10:29:39 AM (5 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 ==