149 | | '''Note:''' the webserver needs permission to write to both the password file '''and the directory''' where it's located. |
150 | | |
151 | | For htpasswd: |
152 | | {{{ |
153 | | [account-manager] |
154 | | password_format = htpasswd |
155 | | password_file = /var/trac/trac.htpasswd |
156 | | }}} |
157 | | |
158 | | For htdigest: |
159 | | {{{ |
160 | | [account-manager] |
161 | | password_format = htdigest |
162 | | password_file = /var/trac/trac.htdigest |
163 | | htdigest_realm = TracRealm |
164 | | }}} |
165 | | |
166 | | == Form-based Login == |
167 | | |
168 | | The plugin supports allowing users to login via a form instead of HTTP authentication. You will need to turn off the default Trac login handler and enable the handler from the AccountManagerPlugin in your `trac.ini` file: |
169 | | |
| 150 | In order to use this plugin you will need to disable the default Trac login module: |
| 157 | [[Image(login-form.png)]] |
| 158 | |
| 159 | ==== Disable HTTP authentication ==== |
| 160 | |
| 161 | When using the [trac:TracStandalone tracd] server be sure '''not''' to use the "--auth" or "--basic-auth" options. Using either of these options will cause tracd to popup the username/password dialog box and you will not be able to use the HTML form. |
| 162 | |
| 163 | If you have previously enabled authentication for Trac on Apache, you will need to disable it or Apache will popup the username/password dialog and you will be unable to use the HTML form. In order to disable the authentication look for a section in the Apache configuration file like like: |
| 164 | |
| 165 | {{{ |
| 166 | <Location /trac/login> |
| 167 | # Some options like AuthType and AuthUserFile |
| 168 | Require valid-user |
| 169 | </Location> |
| 170 | }}} |
| 171 | |
| 172 | Deleting or commenting the `Require valid-user` line should be sufficient to disable HTTP authentication. After you've tested it you can probably delete or comment out the rest of the authentication options. |
| 173 | |
| 174 | === !RegistrationModule === |
| 175 | '''Package''':: acct_mgr.web_ui |
| 176 | |
| 177 | Enables users to register a new account. It adds a "Register" link on the same menu bar as the "Login" link. |
| 178 | |
| 179 | [[Image(register.png)]] |
| 180 | |