[Mod-auth-commit] mod_auth_webspace/htdocs/docs/mod_authn_dbi index.xml,1.6,1.7
Brought to you by:
firechipmunk,
honx
Menu
▾
▴
[Mod-auth-commit] mod_auth_webspace/htdocs/docs/mod_authn_dbi index.xml,1.6,1.7
|
From: <ho...@us...> - 2003-11-11 00:03:06
|
Update of /cvsroot/mod-auth/mod_auth_webspace/htdocs/docs/mod_authn_dbi
In directory sc8-pr-cvs1:/tmp/cvs-serv21812
Modified Files:
index.xml
Log Message:
more documentation, yay! :-}
Index: index.xml
===================================================================
RCS file: /cvsroot/mod-auth/mod_auth_webspace/htdocs/docs/mod_authn_dbi/index.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** index.xml 4 Nov 2003 02:22:40 -0000 1.6
--- index.xml 11 Nov 2003 00:03:02 -0000 1.7
***************
*** 123,127 ****
these records without having to change the structure
of the table. Also, migration from file-based authentication
! (htpasswd,htdigest) is very easy.
</p>
<p>
--- 123,127 ----
these records without having to change the structure
of the table. Also, migration from file-based authentication
! (<code>htpasswd</code>,<code>htdigest</code>) is very easy.
</p>
<p>
***************
*** 206,241 ****
<section id="advanced">
<title>Advanced configuration of mod_authn_dbi</title>
!
</section>
! <directivesynopsis>
! <name>AuthnDbiDriver</name>
! <description>Sets the Driver that DBI Uses.</description>
! <syntax>AuthUserFile <var>mysql|pgsql|sqlite</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p>Docs here</p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiDriverDir</name>
! <description>The directory containing the DBI drivers</description>
! <syntax>AuthnDbiDriverDir <var>PATH</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> The name of the driver that is passed to libdbi. The default
! value is "<code>mysql</code>". The possible values depend on what
! libdbi drivers you have installed. At the moment,
! libdbi-drivers supports:
!
! <ul>
! <table>
<tr><th>Keyword</th><th>Database</th></tr>
<tr><td><code>mysql</code></td><td>MySQL</td></tr>
--- 206,231 ----
<section id="advanced">
<title>Advanced configuration of mod_authn_dbi</title>
! <p>
! insert kung-foo here...
! </p>
</section>
! <directivesynopsis>
! <name>AuthnDbiDriver</name>
! <description>Sets the Driver that DBI Uses.</description>
! <syntax>AuthDbiDriver <var>DbiConfigName</var> <var>mysql|pgsql|sqlite</var></syntax>
! <default>mysql</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The name of the driver that is passed to libdbi. The default
! value is "<code>mysql</code>". The possible values depend on what
! libdbi drivers you have installed. At the moment,
! libdbi-drivers supports:
!
! <ul>
! <table>
<tr><th>Keyword</th><th>Database</th></tr>
<tr><td><code>mysql</code></td><td>MySQL</td></tr>
***************
*** 244,348 ****
<tr><td><code>msql</code></td><td>mSQL</td></tr>
</table>
! </ul>
! More drivers should be available soon.
! Check <a
! href="http://libdbi-drivers.sourceforge.net/"><code>http://libdbi-drivers.sourceforge.net/</code></a>
!
! The value is treated by <code>mod_authn_dbi</code> as an opaque string
! which is just passed to <code>libdbi</code>.<br />
!
! At the moment, only the MySQL driver is really tested, but
! others should work, ymmv...
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiHost</name>
! <description>The host for the database connection</description>
! <syntax>AuthnDbiHost <var>hostname|ip|localhost</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> This is the hostname of the database host for this configuration.
! Specify a hostname or an IP address.
! Again, this string is just passed to libdbi.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiUsername</name>
! <description>The username for the database connection</description>
! <syntax>AuthnDbiUsername <var>username</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> The username that is used when logging
! in to the database.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPassword</name>
! <description>The password for the database connection</description>
! <syntax>AuthnDbiPassword <var>password</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p>The password that is used when logging
! in to the database.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiName</name>
! <description>The name of the database containing the tables</description>
! <syntax>AuthnDbiName <var>database</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> The name of the database that will be used.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPasswordQuery</name>
! <description>The SQL query to pick the password field from</description>
! <syntax>AuthnDbiPasswordQuery <var>SQL Query</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p></p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPasswordFormat</name>
! <description>The format the password is saved as</description>
! <syntax>AuthnDbiPasswordFormat <var>Plain|Apr|AprSHA1|AprDigest</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p>This options specifies the format, value in the
! PasswordField is interpreted as.<br />
!
! Possible values are:
!
<ul>
<li><code>Plain</code>
--- 234,430 ----
<tr><td><code>msql</code></td><td>mSQL</td></tr>
</table>
! </ul>
! More drivers should be available soon.
! Check <a
! href="http://libdbi-drivers.sourceforge.net/"><code>http://libdbi-drivers.sourceforge.net/</code></a>
!
! The value is treated by <code>mod_authn_dbi</code> as an opaque string
! which is just passed to <code>libdbi</code>.<br />
!
! At the moment, only the MySQL driver is really tested, but
! others should work, ymmv (Success/failure reports are, of course, always welcome).
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiDriverDir</name>
! <description>The directory containing the DBI drivers</description>
! <syntax>AuthnDbiDriverDir <var>PATH</var></syntax>
! <default>none</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The name of a directory in which libdbi will expect its drivers. If
! this directive is not given, libdbi will use its default,compiled-in
! value. Drivers are are shared objects which end in <code>.so</code>,
! e.g. <code>libmysql.so</code>. Any driver found in this directory can
! later be used by passing its name to <code>AuthnDbiDriver</code>.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiHost</name>
! <description>The host for the database connection</description>
! <syntax>AuthnDbiHost <var>DbiConfigName</var>
! <var>hostname|ip|localhost</var></syntax>
! <default><var>localhost</var></default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! This is the hostname of the database host for this configuration.
! Specify a hostname or an IP address.
! Again, this string is just passed to libdbi.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiUsername</name>
! <description>The username for the database connection</description>
! <syntax>AuthnDbiUsername <var>DbiConfigName</var>
! <var>username</var></syntax>
! <default>root</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The username that is used when logging-in to the database.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPassword</name>
! <description>The password for the database connection</description>
! <syntax>AuthnDbiPassword <var>DbiConfigName</var>
! <var>password</var></syntax>
! <default>login without a password</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The password that is used when logging
! in to the database.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiName</name>
! <description>The name of the database containing the tables</description>
! <syntax>AuthnDbiName <var>DbiConfigName</var> <var>database</var></syntax>
! <default><code>AuthDB</code></default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The name of the database that will be used.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPasswordQuery</name>
! <description>The SQL query to pick the password field from</description>
! <syntax>AuthnDbiPasswordQuery <var>DbiConfigName</var> <var>SQL
! Query</var></syntax>
! <default><code>SELECT &{PasswordField} FROM &{Table} WHERE
! &{UsernameField}=&{GivenUsername} LIMIT 0,1</code><br />or<br />
! <code>SELECT &{PasswordField} FROM &{Table} WHERE
! &{UsernameField}=&{GivenUsername} AND &{IsActiveField}!=0
! LIMIT 0,1</code><br />
! </default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! This directive allows you to specify a custom SQL-query that
! mod_authn_dbi will use when authenticating users. It is quite flexible
! and can be used to shoot a lot of problems (including your
! foot). Changing its value may also change the behaviour of
! <code>AuthnDbiUsernameField</code>, <code>AuthnDbiPasswordField</code>,
! <code>AuthnDbiIsActiveField</code>, <code>AuthnDbiTable</code> from
! what is documented in here.
! </p>
! <p>
! For <em>each request</em> that is received (not just at configuration
! time), mod_authn_dbi will go through the following steps:
! <ol>
! <li><b>Replace variables in the query string by their corresponding
! values</b><br />
! The query string may contain any number of placeholders for variables
! of the format &{<var>variablename</var>}. For each request, this
! placeholder is replaced by the current value. The Variables supported
! variables come from the configuration of mod_authn_dbi or attributes
! of the current request. See below for a list of supported variables
! and their meaning.
! </li>
! <li><b>Execute the query in the database that was configured</b>
!
! </li>
! <li><b>Select from the result the field with the name configured by
! <code>PasswordField</code> (or its default).</b>
! </li>
! <li><b>Interpret the value according to <code>AuthnDbiPasswordFormat</code> and use it for
! authenticating the request.</b>
! </li>
! </ol>
! </p>
! <p>
! <table>
! <tr><th>Variable Name</th><th>Meaning</th></tr>
! <tr><td>AuthName</td><td>The name of the authentication section,
! configured by the <code><a href="http://httpd.apache.org/docs-2.1/mod/core.html#authname">AuthName</a></code> directive.</td></tr>
! <tr><td>ConfigHostname</td><td>The name of the configured host the current request is
! serviced by.</td></tr>
! <tr><td>GivenPassword</td><td>The Password value that was included in
! the request. This is just what the client sent, not checked in any way.</td></tr>
! <tr><td>GivenUsername</td><td>The Username that was included in the
! request. This is just what the client sent, not checked in any way.</td></tr>
! <tr><td>IsActiveField</td><td>The value set by the directive <code>AuthnDbiIsActiveField</code>.</td></tr>
! <tr><td>Name</td><td>The name of the mod_authn_dbi configuration that
! is used for the current request.</td></tr>
! <tr><td>PasswordField</td><td>The value set by the directive <code>AuthnDbiPasswordField</code>.</td></tr>
! <tr><td>PathInfo</td><td>The path info value from the current request.</td></tr>
! <tr><td>Realm</td><td>The Digest realm, only valid for digest authentication.</td></tr>
! <tr><td>RequestArgs</td><td>Any extra arguments supplied by the client
! for this request.</td></tr>
! <tr><td>RequestFile</td><td>The name of the file this request ist for.</td></tr>
! <tr><td>RequestHostname</td><td>The value of the "<code>Host:</code>"
! http field from the current request.</td></tr>
! <tr><td>RequestURI</td><td>The path info from the current request.</td></tr>
! <tr><td>Table</td><td>The name of <code>AuthnDbiTable</code> from the current mod_authn_dbi configuration.</td></tr>
! <tr><td>UsernameField</td><td>The value set by the directive <code>AuthnDbiUsernameField</code>.</td></tr>
! </table>
! This list of variables is just what looked useful at the time of
! coding. Others will be added if requested.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPasswordFormat</name>
! <description>The format the password is saved as</description>
! <syntax>AuthnDbiPasswordFormat <var>DbiConfigName</var>
! <var>Plain|Apr|AprSHA1|AprDigest</var></syntax>
! <default><code>plain</code></default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>This options specifies the format, value in the
! PasswordField is interpreted as.<br />
!
! Possible values are:
<ul>
<li><code>Plain</code>
***************
*** 365,375 ****
crypt on Unix only.
The formats are exactly the same as are used
! by htdigest.
!
! <br />An example password in crypt format would be:
! <code>O8D24p2LCO7PA</code><br />
!
An example password in md5 format would be:
! <code>$apr1$SvzPV/..$CJl3oQ/ko4Tq5eg6L2Fk..</code><br />
Just specify "Apr" as the AuthnDbiPasswordFormat,
--- 447,457 ----
crypt on Unix only.
The formats are exactly the same as are used
! by <code>htdigest</code>.
! <br /><br />
! An example password in crypt format would be:
! <code>O8D24p2LCO7PA</code>
! <br /><br />
An example password in md5 format would be:
! <code>$apr1$SvzPV/..$CJl3oQ/ko4Tq5eg6L2Fk..</code><br /><br />
Just specify "Apr" as the AuthnDbiPasswordFormat,
***************
*** 381,388 ****
<p>
Passwords are in the SHA1 format of libapr-util,
! again like they are used by htpasswd.
!
! <br />An example password in SHA1 format would be:
! <code>sha1:{SHA}C+7Hteo/D9vJXQ3UfzxbwnXaijM=</code><br />
</p>
</li>
--- 463,471 ----
<p>
Passwords are in the SHA1 format of libapr-util,
! again like they are used by <code>htpasswd</code>.
! <br /><br />
! An example password in SHA1 format would be:
! <code>sha1:{SHA}C+7Hteo/D9vJXQ3UfzxbwnXaijM=</code>
! <br /><br />
</p>
</li>
***************
*** 390,403 ****
<p>
The Passwords are in Digest MD5-like format, like
! they are used by the htdigest utility of Apache.
! <br />An example for a password in Digest format would be:
! <code>90b9659ffec980fdfd41f14c31a07887</code><br />
! Refer to the documentation of htdigest for further
information about this format.
</p>
! </li>
! </ul>
</p>
</usage>
--- 473,503 ----
<p>
The Passwords are in Digest MD5-like format, like
! they are used by the <code>htdigest</code> utility of Apache.
! <br /><br />
! An example for a password in Digest format would be:
! <code>90b9659ffec980fdfd41f14c31a07887</code>
! <br /><br />
! Refer to the documentation of <code>htdigest</code> for further
information about this format.
</p>
! </li>
! </ul>
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiTable</name>
! <description>The name of the table containing the usernames and password hashes</description>
! <syntax>AuthnDbiTable <var>DbiConfigName</var> <var>table</var></syntax>
! <default>Users</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The name of the table that will be used.
</p>
</usage>
***************
*** 405,536 ****
<directivesynopsis>
! <name>AuthnDbiTable</name>
! <description>The name of the table containing the usernames and password hashes</description>
! <syntax>AuthnDbiTable <var>table</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> The name of the table that will be used.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiUsernameField</name>
! <description>The table field that contains the username</description>
! <syntax>AuthnDbiUsernameField <var>field</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> The name of the column that mod_authn_dbi will interpret
! as usernames.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPasswordField</name>
! <description>The table field that contains the password</description>
! <syntax>AuthnDbiPasswordField <var>field</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p> The name of the column that mod_authn_dbi will interpret
! as passwords.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiIsActiveField</name>
! <description>The table field that contains the username</description>
! <syntax>AuthnDbiIsActiveField <var>field</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p>Optionally, the table you use can contain
! an IsActive-Field of integer(!) type.
! If the table-column with the configured
! name contains a 0, the account will be treated
! as disabled and the user not be let in, even
! if the correct password was given. If the column
! contains a different values, the account is seen as
! active.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnMin</name>
! <description>The Minimum Number of Database Connections</description>
! <syntax>AuthnDbiConnMin <var>number</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p></p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnSoftMax</name>
! <description>The Soft Maximum Number of Database Connections</description>
! <syntax>AuthnDbiConnSoftMax <var>number</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p></p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnHardMax</name>
! <description>The Hard Maximum Number of Database Connections</description>
! <syntax>AuthnDbiConnHardMax <var>number</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p></p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnTTL</name>
! <description>The database pool time to live for each connection.</description>
! <syntax>AuthnDbiConnTTL <var>seconds</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p></p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiOptions</name>
! <description>A list of options for this configuration</description>
! <syntax>AuthnDbiOptions [<var>AllowEmptyPasswords</var>]</syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p></p>
! </usage>
! </directivesynopsis>
</modulesynopsis>
--- 505,689 ----
<directivesynopsis>
! <name>AuthnDbiUsernameField</name>
! <description>The table field that contains the username</description>
! <syntax>AuthnDbiUsernameField <var>DbiConfigName</var> <var>field</var></syntax>
! <default>Username</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The name of the column that mod_authn_dbi will interpret
! as username.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiPasswordField</name>
! <description>The table field that contains the password</description>
! <syntax>AuthnDbiPasswordField <var>DbiConfigName</var>
! <var>field</var></syntax>
! <default>Password</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! The name of the column that mod_authn_dbi will interpret
! as passwords.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiIsActiveField</name>
! <description>The table field that contains the username</description>
! <syntax>AuthnDbiIsActiveField <var>DbiConfigName</var>
! <var>field</var></syntax>
! <default>none</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! Optionally, the table you use can contain
! an IsActive-Field of integer(!) type.
! If the table-column with the configured
! name contains a 0, the account will be treated
! as disabled and the user not be let in, even
! if the correct password was given. If the column
! contains a different values, the account is seen as
! active.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnMin</name>
! <description>The Minimum Number of Database Connections</description>
! <syntax>AuthnDbiConnMin <var>DbiConfigName</var> <var>number</var></syntax>
! <default>1</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! See <a
! href="http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html">http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html</a> for now. More info follows soon.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnSoftMax</name>
! <description>The Soft Maximum Number of Database Connections</description>
! <syntax>AuthnDbiConnSoftMax <var>DbiConfigName</var>
! <var>number</var></syntax>
! <default>5</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! See <a
! href="http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html">http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html</a> for now. More info follows soon.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnHardMax</name>
! <description>The Hard Maximum Number of Database Connections</description>
! <syntax>AuthnDbiConnHardMax <var>DbiConfigName</var>
! <var>number</var></syntax>
! <default>25</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! See <a
! href="http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html">http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html</a> for now. More info follows soon.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiConnTTL</name>
! <description>The database pool time to live for each connection.</description>
! <syntax>AuthnDbiConnTTL <var>DbiConfigName</var>
! <var>seconds</var></syntax>
! <default>600</default>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! See <a
! href="http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html">http://apr.apache.org/docs/apr-util/group__APR__Util__RL.html</a> for now. More info follows soon.
! </p>
! </usage>
! </directivesynopsis>
!
! <directivesynopsis>
! <name>AuthnDbiOptions</name>
! <description>A list of options for this configuration</description>
! <syntax>AuthnDbiOptions <var>DbiConfigName</var> [<var>AllowEmptyPasswords</var>]</syntax>
! <contextlist>
! <context>server config</context>
! </contextlist>
! <usage>
! <p>
! This directive gives a list of options to control the behaviour of a
! dbi-configuration. At the moment, only one option can be given. More
! might follow later.
!
! <table>
! <tr><th>Keyword</th><th>Meaning</th></tr>
! <tr><td><code>AllowEmptyPasswords</code></td><td>If this option is
! given, all accounts that have "<code>::</code>" as password value
! will be accepted with <em>any</em> password that the user
! supplies. With this options, you can for example implement guest-accounts.</td></tr>
! </table>
! </p>
! </usage>
! </directivesynopsis>
! <directivesynopsis>
! <name>AuthnDbiServerConfig</name>
! <description>This directive specifies the configuration to use for an
! authentication section.</description>
! <syntax>AuthnDbiServerConfig <var>DbiConfigName</var></syntax>
! <contextlist>
! <context>directory</context>
! <context>.htaccess</context>
! </contextlist>
! <usage>
! <p>
! This option invokes a configuration that was created with the other
! configuration directives. It is the only directive that may appear in a
! Directory/Location context or <code>.htaccess</code> file.
! <example>
! <pre>
! <Directory "/path/to/htdocs/to/be/area_1_protected">
! AuthType Digest
! AuthName "digest authn_dbi testing area"
! AuthDigestProvider dbi
! AuthnDbiServerConfig Server1
! Require valid-user
! </Directory>
!
! <Directory "/path/to/htdocs/to/be/area_2_protected">
! AuthType Basic
! AuthName "basic authn_mysql testing area"
! AuthBasicProvider dbi
! AuthnDbiServerConfig Server1
! Require valid-user
! </Directory>
! </pre>
! </example>
! </p>
! </usage>
! </directivesynopsis>
</modulesynopsis>
|
