Changes between Version 24 and Version 25 of CookBook/AccountManagerPluginConfiguration


Ignore:
Timestamp:
May 9, 2016, 9:51:54 PM (8 years ago)
Author:
Ryan J Ollos
Comment:

Remove obsolete information.

Legend:

Unmodified
Added
Removed
Modified
  • CookBook/AccountManagerPluginConfiguration

    v24 v25  
    22
    33= Cookbook: AccountManagerPlugin configuration
     4
     5{{{#!box note
     6This page documents AccountManagerPlugin 0.4 and later with Trac 0.11 and later. If you are using older versions, please upgrade.
     7}}}
    48
    59This page lists some useful configuration examples with hints on proper use of available options.
     
    1115== Basic configuration/Kickstart
    1216
    13 !AccountManagerPlugin replaces the traditional Trac login feature with a webform, because [wiki:AccountManagerPlugin/Modules#LoginModule LoginModule] is enabled in all examples below. No additional action is required since acct_mgr-0.4, but older plugin versions required to disable the obsoleted Trac core component explicitly:
    14 {{{#!cfg
    15 [components]
    16 trac.web.auth.loginmodule = disabled
    17 }}}
     17!AccountManagerPlugin replaces the traditional Trac login feature with a webform, because [wiki:AccountManagerPlugin/Modules#LoginModule LoginModule] is enabled in all examples below.
    1818
    1919=== !HtPasswdStore
     
    2323password_store = HtPasswdStore
    2424htpasswd_hash_type = md5
    25 ;password_file = /var/trac/trac.htpasswd   ; old style (acct_mgr < 0.4)
    26 htpasswd_file = /var/trac/trac.htpasswd   ; new style (acct_mgr >= 0.4)
     25htpasswd_file = /var/trac/trac.htpasswd
    2726reset_password = false
    2827}}}
     
    4847 * use `md5` password hash type for changed/new passwords, hint: use the cryptographically strongest, that is available on your system (and still compatible with other applications in shared-use case)
    4948
    50 '''Note:''' new configuration option 'htpasswd_file' for acct_mgr-0.4 and later, see [wiki:AccountManagerPlugin/AuthStores#HtPasswdStore HtPasswdStore] module documentation for more details.
    51 
    5249=== !HtDigestStore
    5350
     
    5653password_store = HtDigestStore
    5754htdigest_realm = Trac
    58 ;password_file = /var/trac/trac.htdigest   ; old style (acct_mgr < 0.4)
    59 htdigest_file = /var/trac/trac.htdigest   ; new style (acct_mgr >= 0.4)
     55htdigest_file = /var/trac/trac.htdigest
    6056reset_password = false
    6157}}}
     
    8177 * set realm to select relevant htdigest file entries to '`Trac`'
    8278
    83 '''Note:''' new configuration option 'htdigest_file' for acct_mgr-0.4 and later, see [wiki:AccountManagerPlugin/AuthStores#HtDigestStore HtDigestStore] module documentation for more details.
    84 
    8579=== !SessionStore
    8680
     
    114108 * set realm to select relevant htdigest entries to '`TracDB`'
    115109
    116 '''Note:''' new configuration option 'db_htdigest_realm' for acct_mgr-0.4 and later, see [wiki:AccountManagerPlugin/AuthStores#SessionStore SessionStore] module documentation for more details.
    117 
    118110=== Create users
    119111
     
    181173In a setup with multiple Trac environments per domain/host chances are that users want to work with several projects simultaneously. 40 and more environments served by a single Trac install have been reported from private networks as well as seen on the web.
    182174
    183 To address the demand for authentication information sharing between some/all of the Trac environments in such a setup a login synchronization process has been introduced for acct_mgr-0.4. It relies on a non-default value for the path of `trac_auth` and `trac_auth_session` cookies. Otherwise the cookie wouldn't be recognized as related to different Trac environments by the web browser client.
     175To address the demand for authentication information sharing between some/all of the Trac environments in such a setup a login synchronization process has been introduced. It relies on a non-default value for the path of `trac_auth` and `trac_auth_session` cookies. Otherwise the cookie wouldn't be recognized as related to different Trac environments by the web browser client.
    184176
    185177In order to achieve this, set `auth_cookie_path` in the `[trac]` section of your `trac.ini` file to the '''URL''' path of your installations `TRAC_PARENT_DIR`. Assumed your projects use the URL `http://www.example.com/trac/<project_name>`, this should look like: