summaryrefslogtreecommitdiff
path: root/docs/manual/mod/mod_authn_default.xml
blob: 9b8f544df5b078ee02513c61ff4be79a533f3355 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
<modulesynopsis>

<name>mod_authn_default</name>
<description>Authentication fallback module</description>
<status>Base</status>
<sourcefile>mod_authn_default.c</sourcefile>
<identifier>authn_default_module</identifier>
<compatibility>Available in Apache 2.1 and later</compatibility>

<summary>
    <p>This module is designed to be the fallback module, if you don't
    have configured an authentication module like
    <module>mod_auth_basic</module>. It simply rejects any
    credentials supplied by the user.</p>
</summary>

<directivesynopsis>
<name>AuthDefaultAuthoritative</name>
<description>Sets whether authentication is passed to lower level
modules</description>
<syntax>AuthDefaultAuthoritative On|Off</syntax>
<default>AuthDefaultAuthoritative On</default>
<contextlist><context>directory</context><context>.htaccess</context>
</contextlist>
<override>AuthConfig</override>

<usage>
    <p>Setting the <directive>AuthDefaultAuthoritative</directive> directive
    explicitly to <code>Off</code> allows for authentication to be passed on
    to lower level modules (as defined in the <code>modules.c</code>
    files).</p>

    <note><title>Note</title>
      <p>Normally there are no lower level modules, since
      <module>mod_authn_default</module> is defined to be already on
      a <em>very low</em> level. Therefore you should leave the value of
      <directive>AuthDefaultAuthoritative</directive> as default
      (<code>On</code>).</p>
    </note>
</usage>
</directivesynopsis>

</modulesynopsis>