Changes between Version 11 and Version 12 of CookBook/AccountManagerPluginConfiguration


Ignore:
Timestamp:
Dec 6, 2012 3:00:36 AM (20 months ago)
Author:
hasienda
Comment:

move a valuable hint from main plugin page in here, change formatting for all configuration examples

Legend:

Unmodified
Added
Removed
Modified
  • CookBook/AccountManagerPluginConfiguration

    v11 v12  
    66We'll collect some useful configuration examples here to give hints on proper use of available options. 
    77 
     8 '''Hint:''' Option names are written in !CamelCase style notation, but will get (re-)written all-lowercase, if added/updated via the Trac admin web-UI. Anyway, case doesn't really matter here. 
     9 
    810== Basic configuration/Kickstart == 
     11!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: 
     12{{{ 
     13#!cfg 
     14[components] 
     15trac.web.auth.loginmodule = disabled 
     16}}} 
     17 
    918=== !HtPasswdStore === 
    1019{{{ 
     20#!cfg 
    1121[components] 
    1222acct_mgr.admin.* = enabled 
     
    2333acct_mgr.svnserve.svnservepasswordstore = disabled 
    2434acct_mgr.web_ui.* = enabled 
    25 trac.web.auth.loginmodule = disabled 
    2635 
    2736[account-manager] 
     
    4251=== !HtDigestStore === 
    4352{{{ 
     53#!cfg 
    4454[components] 
    4555acct_mgr.admin.* = enabled 
     
    5666acct_mgr.svnserve.svnservepasswordstore = disabled 
    5767acct_mgr.web_ui.* = enabled 
    58 trac.web.auth.loginmodule = disabled 
    5968 
    6069[account-manager] 
     
    7584=== !SessionStore === 
    7685{{{ 
     86#!cfg 
    7787[components] 
    7888acct_mgr.admin.* = enabled 
     
    8999acct_mgr.svnserve.svnservepasswordstore = disabled 
    90100acct_mgr.web_ui.* = enabled 
    91 trac.web.auth.loginmodule = disabled 
    92101 
    93102[account-manager] 
     
    108117Create the first user through browser-based registration enabled by following additional lines in `components` section of `trac.ini`: 
    109118{{{ 
     119#!cfg 
    110120[components] 
    111121acct_mgr.register.* = enabled 
     
    114124Don't add another `components` section, just the configuration line with 'enabled' into an existing `components` section. After user creation you may choose to disable registration by uncommenting the [AccountManagerPlugin#RegistrationModule RegistrationModule] setting above or changing it to: 
    115125{{{ 
     126#!cfg 
    116127[components] 
    117128;need this for first user 
     
    138149=== Persistent Sessions === 
    139150{{{ 
     151#!cfg 
    140152[account-manager] 
    141153persistent_sessions = true 
     
    149161To 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: 
    150162{{{ 
     163#!cfg 
    151164[trac] 
    152165auth_cookie_path = /var/www/trac 
     
    161174 
    162175{{{ 
     176#!cfg 
    163177[components] 
    164178acct_mgr.guard.accountguard = enabled 
     
    166180 
    167181{{{ 
     182#!cfg 
    168183[account-manager] 
    169184login_attempt_max_count = 0 
     
    175190==== Hard Lock-up ==== 
    176191{{{ 
     192#!cfg 
    177193[account-manager] 
    178194login_attempt_max_count = 5 
     
    185201==== Fixed login delay ==== 
    186202{{{ 
     203#!cfg 
    187204[account-manager] 
    188205login_attempt_max_count = 3 
     
    196213==== Modestly progressing login delay ==== 
    197214{{{ 
     215#!cfg 
    198216[account-manager] 
    199217login_attempt_max_count = 2 
     
    228246==== Aggressively progressing, but limited login delay ==== 
    229247{{{ 
     248#!cfg 
    230249[account-manager] 
    231250login_attempt_max_count = 4