From: Rich Bowen <rbowen@apache.org>
Date: Sun, 11 Dec 2005 20:40:18 +0000 (+0000)
Subject: Added some details about choosing an alternate auth provider.
X-Git-Tag: 2.2.1~201
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9ca2153ed500676be6be33adf39e3f0f81578f8f;p=thirdparty%2Fapache%2Fhttpd.git

Added some details about choosing an alternate auth provider.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@356011 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/howto/auth.html.en b/docs/manual/howto/auth.html.en
index bd189bee480..226b7da0f0f 100644
--- a/docs/manual/howto/auth.html.en
+++ b/docs/manual/howto/auth.html.en
@@ -35,6 +35,7 @@
 <li><img alt="" src="../images/down.gif" /> <a href="#lettingmorethanonepersonin">Letting more than one
 person in</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#possibleproblems">Possible problems</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#dbmdbd">Alternate password storage</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#moreinformation">More information</a></li>
 </ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -233,7 +234,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
-    <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> or <code class="module"><a href="../mod/mod_auth_dbd.html">mod_auth_dbd</a></code>.</p>
+    <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> or <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>.</p>
 
     <p>The <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
     directive sets the path to the password file that we just
@@ -292,6 +293,8 @@ person in</a></h2>
     <div class="example"><p><code>
       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
@@ -340,6 +343,33 @@ person in</a></h2>
     different authentication method at that time.</p>
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
+<h2><a name="dbmdbd" id="dbmdbd">Alternate password storage</a></h2>
+
+    <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><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> and <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>
+    are two modules which make this possible. Rather than selecting
+    <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicsource">AuthBasicSource</a></code> 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>
+
+    <div class="example"><p><code>
+    &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
+    </code></p></div>
+
+    <p>Other options are available. Consult the
+    <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> documentation for more details.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
 <h2><a name="moreinformation" id="moreinformation">More information</a></h2>
     <p>You should also read the documentation for
     <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> and <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> which
diff --git a/docs/manual/howto/auth.xml b/docs/manual/howto/auth.xml
index cb6d0608329..f0b3d397406 100644
--- a/docs/manual/howto/auth.xml
+++ b/docs/manual/howto/auth.xml
@@ -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