You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2005/12/11 21:40:23 UTC
svn commit: r356011 - in /httpd/httpd/branches/2.2.x/docs/manual/howto:
auth.html.en auth.xml
Author: rbowen
Date: Sun Dec 11 12:40:18 2005
New Revision: 356011
URL: http://svn.apache.org/viewcvs?rev=356011&view=rev
Log:
Added some details about choosing an alternate auth provider.
Modified:
httpd/httpd/branches/2.2.x/docs/manual/howto/auth.html.en
httpd/httpd/branches/2.2.x/docs/manual/howto/auth.xml
Modified: httpd/httpd/branches/2.2.x/docs/manual/howto/auth.html.en
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/howto/auth.html.en?rev=356011&r1=356010&r2=356011&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/howto/auth.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/howto/auth.html.en Sun Dec 11 12:40:18 2005
@@ -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 @@
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 @@
<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
@@ -338,6 +341,33 @@
server machine, but you can expect to see slowdowns once you
get above a few hundred entries, and may wish to consider a
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>
+ <Directory /www/docs/private><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>
Modified: httpd/httpd/branches/2.2.x/docs/manual/howto/auth.xml
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/howto/auth.xml?rev=356011&r1=356010&r2=356011&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/howto/auth.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/howto/auth.xml Sun Dec 11 12:40:18 2005
@@ -230,7 +230,7 @@
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 @@
<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
@@ -339,6 +341,33 @@
server machine, but you can expect to see slowdowns once you
get above a few hundred entries, and may wish to consider a
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>
+ <Directory /www/docs/private><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>