granicus.if.org Git - apache/blob - docs/manual/mod/mod_authn_default.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
   4
   5 <!--
   6  Copyright 2002-2004 The Apache Software Foundation
   7
   8  Licensed under the Apache License, Version 2.0 (the "License");
   9  you may not use this file except in compliance with the License.
  10  You may obtain a copy of the License at
  11
  12      http://www.apache.org/licenses/LICENSE-2.0
  13
  14  Unless required by applicable law or agreed to in writing, software
  15  distributed under the License is distributed on an "AS IS" BASIS,
  16  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  See the License for the specific language governing permissions and
  18  limitations under the License.
  19 -->
  20
  21 <modulesynopsis metafile="mod_authn_default.xml.meta">
  22
  23 <name>mod_authn_default</name>
  24 <description>Authentication fallback module</description>
  25 <status>Base</status>
  26 <sourcefile>mod_authn_default.c</sourcefile>
  27 <identifier>authn_default_module</identifier>
  28 <compatibility>Available in Apache 2.1 and later</compatibility>
  29
  30 <summary>
  31     <p>This module is designed to be the fallback module, if you don't
  32     have configured an authentication module like
  33     <module>mod_auth_basic</module>. It simply rejects any
  34     credentials supplied by the user.</p>
  35 </summary>
  36
  37 <directivesynopsis>
  38 <name>AuthDefaultAuthoritative</name>
  39 <description>Sets whether authentication is passed to lower level
  40 modules</description>
  41 <syntax>AuthDefaultAuthoritative On|Off</syntax>
  42 <default>AuthDefaultAuthoritative On</default>
  43 <contextlist><context>directory</context><context>.htaccess</context>
  44 </contextlist>
  45 <override>AuthConfig</override>
  46
  47 <usage>
  48     <p>Setting the <directive>AuthDefaultAuthoritative</directive> directive
  49     explicitly to <code>Off</code> allows for authentication to be passed on
  50     to lower level modules (as defined in the <code>modules.c</code>
  51     files).</p>
  52
  53     <note><title>Note</title>
  54       <p>Normally there are no lower level modules, since
  55       <module>mod_authn_default</module> is defined to be already on
  56       a <em>very low</em> level. Therefore you should leave the value of
  57       <directive>AuthDefaultAuthoritative</directive> as default
  58       (<code>On</code>).</p>
  59     </note>
  60 </usage>
  61 </directivesynopsis>
  62
  63 </modulesynopsis>