From ae4e235a6c1bc2bcfdac394e0f259bbde57a16ef Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Sun, 11 Dec 2005 20:40:56 +0000
Subject: [PATCH] Details about changing auth provider.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@356012 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/howto/auth.xml | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/docs/manual/howto/auth.xml b/docs/manual/howto/auth.xml
index cb6d060832..f0b3d39740 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
-- 
2.40.0