Changes between Version 5 and Version 6 of CookBook/AccountManagerPluginConfiguration

Timestamp:

Dec 13, 2011, 12:10:04 AM (12 years ago)

Author:

Steffen Hoffmann

Comment:

add file store examples, explanation to SessionStore example, and clearify page structure with another section

CookBook/AccountManagerPluginConfiguration

@@ -8 +8 @@
 == Basic configuration/Kickstart ==
 === !HtPasswdStore ===
+
+== !HtPasswdStore ==
+{{{
+[components]
+acct_mgr.admin.* = enabled
+acct_mgr.api.* = enabled
+acct_mgr.db.sessionstore = enabled
+acct_mgr.htfile.htdigeststore = disabled
+acct_mgr.htfile.htpasswdstore = enabled
+acct_mgr.http.httpauthstore = disabled
+acct_mgr.notification.* = enabled
+acct_mgr.pwhash.htdigesthashmethod = disabled
+acct_mgr.pwhash.htpasswdhashmethod = disabled
+acct_mgr.svnserve.* = enabled
+acct_mgr.svnserve.svnservepasswordstore = disabled
+acct_mgr.web_ui.* = enabled
+trac.web.auth.loginmodule = disabled
+
+[account-manager]
+password_store = HtPasswdStore
+htpasswd_hash_type = md5
+;password_file = /var/trac/trac.htpasswd   # old style (acct_mgr < 0.4)
+htpasswd_file = /var/trac/trac.htpasswd   # new style (acct_mgr >= 0.4)
+}}}
+will:
+ * enable required AccountManagerPlugin core components
+ * enable [wiki:AccountManagerPlugin/AuthStores#HtPasswdStore HtPasswdStore] module for file-based password store in ''htpasswd'' format
+ * select this store as the only active one
+ * 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)
+
+''Note:''  new configuration option 'htpasswd_file' for acct_mgr-0.4
+ see [wiki:AccountManagerPlugin/AuthStores#HtPasswdStore HtPasswdStore] module documentation for more details
+
 === !HtDigestStore ===
+{{{
+[components]
+acct_mgr.admin.* = enabled
+acct_mgr.api.* = enabled
+acct_mgr.db.sessionstore = enabled
+acct_mgr.htfile.htdigeststore = enabled
+acct_mgr.htfile.htpasswdstore = disabled
+acct_mgr.http.httpauthstore = disabled
+acct_mgr.notification.* = enabled
+acct_mgr.pwhash.htdigesthashmethod = disabled
+acct_mgr.pwhash.htpasswdhashmethod = disabled
+acct_mgr.svnserve.* = enabled
+acct_mgr.svnserve.svnservepasswordstore = disabled
+acct_mgr.web_ui.* = enabled
+trac.web.auth.loginmodule = disabled
+
+[account-manager]
+password_store = HtDigestStore
+htdigest_realm = Trac
+;password_file = /var/trac/trac.htdigest   # old style (acct_mgr < 0.4)
+htdigest_file = /var/trac/trac.htdigest   # new style (acct_mgr >= 0.4)
+}}}
+will:
+ * enable required AccountManagerPlugin core components
+ * enable [wiki:AccountManagerPlugin/AuthStores#HtDigestStore HtDigestStore] module for file-based password store in ''htdigest'' format
+ * select this store as the only active one
+ * set realm to select relevant htdigest file entries to '`Trac`'
+
+''Note:''  new configuration option 'htdigest_file' for acct_mgr-0.4
+ see [wiki:AccountManagerPlugin/AuthStores#HtDigestStore HtDigestStore] module documentation for more details
+
 === !SessionStore ===
 {{{
@@ -28 +92 @@
 [account-manager]
 hash_method = HtDigestHashMethod
+db_htdigest_realm = TracDB
 password_store = SessionStore
 }}}
-
+will:
+ * enable required AccountManagerPlugin core components
+ * enable [wiki:AccountManagerPlugin/AuthStores#SessionStore SessionStore] module for file-based password store in ''htdigest'' format
+ * select this store as the only active one
+ * set realm to select relevant htdigest file entries to '`TracDB`'
+
+''Note:''  new configuration option 'db_htdigest_realm' for acct_mgr-0.4
+ see [wiki:AccountManagerPlugin/AuthStores#SessionStore SessionStore] module documentation for more details
+
+=== Create users ===
 Create the first user through browser-based registration enabled by following additional lines in `components` section of `trac.ini`:
 {{{