Next step: %IGStepNextText%
Up: Enable authentication of users (if desired)

Installing Foswiki: Configuring Template Login

With Template Login enabled, when Foswiki needs to authenticate the user, it will redirect to a login web page. A list of all users is shown in the Main.WikiUsers topic.

To setup Template Login, perform the following steps:

1. Configure Template Login. Under the Security Settings pane of the configure page:
   1. Select Foswiki::LoginManager::TemplateLogin for {LoginManager}.
   2. Select Foswiki::Users::HtPasswdUser for {PasswordManager}.
   3. Select Foswiki::Users::TopicUserMapping for {UserMappingManager}.
   4. Save your settings.
2. Verify that registration works. Register yourself using the System.UserRegistration topic in your Foswiki installation.
   Check that the password manager recognizes the new user by verifying that a new line is added to the foswiki/data/.htpassswd file, with the username and encrypted password. If the user and password information was not added, you probably got a path wrong, or the directory permissions on foswiki/data or foswiki/data/.htpasswd may not be set to allow the web server user to modify the file.
3. Check that authentication works. Edit a topic by clicking on the Edit link at the top or bottom of a topic. If you have been authenticated, then you will see the edit page; otherwise, you will see an error message.

As Template Login uses a wiki page for its login prompt, there is a great deal of flexibility in customizing the login page for your purposes.

Next step: %IGStepNextText%
Up: Enable authentication of users (if desired)

---

Customized versions of InstallStepConfigureTemplateLogin:

---

This topic: Support > InstallStepConfigureTemplateLogin
Topic revision: 18 Jan 2010, IsaacLin

---