Changes between Version 11 and Version 12 of CookBook/AccountManagerPluginConfiguration


Ignore:
Timestamp:
Dec 6, 2012, 3:00:36 AM (2 years 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