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)

  • Set IGVariant =

Customized versions of InstallStepConfigureTemplateLogin:

Topic revision: r1 - 18 Jan 2010, IsaacLin
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy