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 - This page was cached on 18 Oct 2018 - 05:02.

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