| 2 | |
| 3 | == !AccountManager == |
| 4 | '''Package''':: acct_mgr.api |
| 5 | |
| 6 | This holds core code of this plugin. This component ''must'' be enabled to use any of the other components. |
| 7 | |
| 8 | Additionally one or more sources for storing authentication information are required: |
| 9 | * !PasswordFileStores |
| 10 | * [wiki:AccountManagerPlugin/AuthStores#HtDigestStore HtDigestStore] |
| 11 | * [wiki:AccountManagerPlugin/AuthStores#HtPasswdStore HtPasswdStore] |
| 12 | * [wiki:AccountManagerPlugin/AuthStores#HttpAuthStore HttpAuthStore] |
| 13 | * [wiki:AccountManagerPlugin/AuthStores#SessionStore SessionStore] |
| 14 | * [wiki:AccountManagerPlugin/AuthStores#SvnServePasswordStore SvnServePasswordStore] |
| 15 | |
| 16 | There's even some information on how to get not-yet-implemented [wiki:AccountManagerPlugin/AuthStores#LDAP LDAP authentication]. |
| 17 | |
| 18 | == !AccountManagerAdminPage == |
| 19 | '''Package''':: acct_mgr.admin |
| 20 | |
| 21 | This component adds new pages to the trac:WebAdmin section for managing user accounts: |
| 22 | * admin/accounts/config - basic configuration, i.e. !AuthStore activation and ordering |
| 23 | * ''admin/accounts/details'' - upcoming |
| 24 | * admin/accounts/notification - !AccountManager change notification settings |
| 25 | * admin/accounts/users - user account listing with some management functions, i.e. add/delete accounts, change password, etc. |
| 26 | |
| 27 | It requires the `TRAC_ADMIN` permission to access.[[BR]] |
| 28 | '''Update:''' A more granular set of permissions has been introduced with changeset [9280] and TRAC_ADMIN is not required anymore. |
| 29 | |
| 30 | [[Image(AccountManagerPlugin:account-manager-admin.png)]] |
| 31 | |
| 32 | === Configuration === |
| 33 | {{{ |
| 34 | #!cfg |
| 35 | [components] |
| 36 | acct_mgr.admin.AccountManagerAdminPage = enabled |
| 37 | }}} |
| 38 | |
| 39 | === Compatibility === |
| 40 | requires Trac >= 0.10 |
| 41 | |
| 42 | == !AccountModule == |
| 43 | '''Package''':: acct_mgr.web_ui |
| 44 | |
| 45 | 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. |
| 46 | |
| 47 | [[Image(AccountManagerPlugin:my-account.png)]] |
| 48 | |
| 49 | === Configuration === |
| 50 | {{{ |
| 51 | #!cfg |
| 52 | [components] |
| 53 | acct_mgr.web_ui.AccountModule = enabled |
| 54 | }}} |
| 55 | |
| 56 | '''Since 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 and enable !AccountChangeListener: |
| 57 | |
| 58 | {{{ |
| 59 | #!cfg |
| 60 | [components] |
| 61 | acct_mgr.notification.accountchangelistener = enabled |
| 62 | }}} |
| 63 | |
| 64 | To disable just the password reset functionality add the following line to the {{{[account-manager]}}} section: |
| 65 | |
| 66 | {{{ |
| 67 | #!cfg |
| 68 | [account-manager] |
| 69 | reset_password = False |
| 70 | }}} |
| 71 | |
| 72 | [[Image(reset-password.png)]] |
| 73 | |
| 74 | '''Since 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: |
| 75 | |
| 76 | {{{ |
| 77 | #!cfg |
| 78 | [account-manager] |
| 79 | force_passwd_change = false |
| 80 | }}} |