Changeset 8623

Timestamp:

08/21/10 15:16:25 (21 months ago)

Author:

PaulHarvey

Message:

Item9415: Deleted too much

Location:

trunk/core/data/System

Files:

• InstallationGuide.txt (modified) (1 diff)
• UserAuthentication.txt (modified) (2 diffs)

trunk/core/data/System/InstallationGuide.txt

@@ -159 +159 @@
 ---++++ Template Login authentication
 %INCLUDE{"UserAuthentication" section="TemplateLogin" INSTALLGUIDE="1"}%
+
+---++++ Apache Login authentication
+
+With Apache Login enabled, when Foswiki needs to authenticate the user, the standard HTTP authentication mechanism is used: the browser itself will prompt for a user name and password.
+
+*Note:* Apache Login is required for Apache-based login methods such as mod_ldap.
+
+To setup Apache Login, perform the following steps:
+
+   1 *Configure Apache Login.* Under the =Security and Authentication= pane on the =Login= tab in =configure=:
+      1 Select =Foswiki::LoginManager::ApacheLogin= for ={LoginManager}=.
+      1 Select =Foswiki::Users::HtPasswdUser= for ={PasswordManager}=.
+      1 Select =Foswiki::Users::TopicUserMapping= for ={UserMappingManager}=.
+      1 Save your settings.
+      1 Configure your Apache settings for HTTP authentication. Use the Foswiki:Support.ApacheConfigGenerator tool or the =foswiki/bin/.htaccess= file to set the following Apache directives on the =bin= scripts:<sticky><verbatim>
+      <FilesMatch "(attach|edit|manage|rename|save|upload|mail|logon|rest|.*auth).*">
+      require valid-user
+      </FilesMatch></verbatim></sticky>
+      You can also refer to the sample =foswiki_httpd_conf.txt= and =bin/.htaccess.txt= files to see how the appropriate Apache directives are specified.
+%INCLUDE{"UserAuthentication" section="TESTING"}%
 
 #SearchAlgorithm

trunk/core/data/System/UserAuthentication.txt

@@ -77 +77 @@
       1 Navigate to the =Passwords= tab. Select the appropriate =PasswordManager= for your system - the default is =Foswiki::Users::HtPasswdUser=.
       <blockquote class="foswikiHelp">%H% There is also an EXPERT configure setting ={TemplateLogin}{PreventBrowserRememberingPassword}= that you can set to prevent Browsers from remembering username and passwords if you are concerned about public terminal usage.</blockquote>
-   1 Verify that registration works by registering yourself with the [[%SYSTEMWEB%.UserRegistration]] topic. If there are problems, try these troubleshooting tips: %IF{
+%STARTSECTION{"TESTING"}%   1 Verify that registration works by registering yourself with the [[%SYSTEMWEB%.UserRegistration]] topic. If there are problems, try these troubleshooting tips: %IF{
       "'%INSTALLGUIDE%'='1'"
       then="$n      1 If you are reading this from the INSTALL.html file, you can enter [[%SYSTEMWEB%.UserRegistration]] into the 'Jump' box in the top right of any Foswiki page."}%
@@ -84 +84 @@
    1 Create a new topic (in [[Sandbox.WebHome][Sandbox]] web for example) to confirm that authentication works.
    1 *Add users to the %USERSWEB%.AdminGroup*. Edit the %USERSWEB%.AdminGroup topic in the %USERSWEB% web to include users that should have administrator status. Read [[InstallationGuide#DefineAdminUser][defining adminstrator user(s)]] for more information.
-   <blockquote class="foswikiHelp"> %X% *This is a very important step*, as users in this group can access _all_ topics, independent of %WIKITOOLNAME% access controls.</blockquote>
+   <blockquote class="foswikiHelp"> %X% *This is a very important step*, as users in this group can access _all_ topics, independent of %WIKITOOLNAME% access controls.</blockquote>%ENDSECTION{"TESTING"}%
 
 AccessControl has more information on setting up access controls.