Commit a7a1e130 authored by Richard Bowen's avatar Richard Bowen
Browse files

Details about changing auth provider. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@356012 13f79535-47bb-0310-9956-ffa450edef68
parent 6eb0885b

docs/manual/howto/auth.xml

+30 −1
Original line number Diff line number Diff line
@@ -230,7 +230,7 @@ module from each group.</p> 
    in this case, optional, since <code>file</code> is the default value

    for this directive. You'll need to use this directive if you are

    choosing a different source for authentication, such as

    <module>mod_authn_dbm</module> or <module>mod_auth_dbd</module>.</p>

    <module>mod_authn_dbm</module> or <module>mod_authn_dbd</module>.</p>



    <p>The <directive module="mod_authn_file">AuthUserFile</directive>

    directive sets the path to the password file that we just
@@ -293,6 +293,8 @@ person in</title> 
    <example>

      AuthType Basic<br />

      AuthName "By Invitation Only"<br />

      # Optional line:

      AuthBasicProvider file

      AuthUserFile /usr/local/apache/passwd/passwords<br />

      AuthGroupFile /usr/local/apache/passwd/groups<br />

      Require group GroupName
@@ -341,6 +343,33 @@ person in</title> 
    different authentication method at that time.</p>

</section>



<section id="dbmdbd"><title>Alternate password storage</title>



    <p>Because storing passwords in plain text files has the above

    problems, you may wish to store your passwords somewhere else, such

    as in a database.</p>



    <p><module>mod_authn_dbm</module> and <module>mod_authn_dbd</module>

    are two modules which make this possible. Rather than selecting

    <directive module="mod_auth_basic">AuthBasicSource</directive> file,

    instead you can choose <code>dbm</code> or <code>dbd</code> as your

    storage format.</p>



    <p>To select a dbd file rather than a text file, for example:</p>



    <example>

    &lt;Directory /www/docs/private&gt;<br />

    AuthName "Private"<br />

    AuthType Basic<br />

    AuthBasicProvider dbm<br />

    AuthDBMUserFile /www/passwords/passwd.dbm<br />

    Require valid-user

    </example>



    <p>Other options are available. Consult the

    <module>mod_authn_dbm</module> documentation for more details.</p>

</section>



<section id="moreinformation"><title>More information</title>

    <p>You should also read the documentation for

    <module>mod_auth_basic</module> and <module>mod_authz_host</module> which