github.com/krum110487/go-htaccess@v0.0.0-20240316004156-60641c8e7598/tests/data/apache_2_2_34/manual/mod/mod_authn_alias.html.en (about)

     1  <?xml version="1.0" encoding="ISO-8859-1"?>
     2  <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
     3  <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
     4  <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
     5  <!--
     6          XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
     7                This file is generated from xml source: DO NOT EDIT
     8          XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
     9        -->
    10  <title>mod_authn_alias - Apache HTTP Server Version 2.2</title>
    11  <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
    12  <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
    13  <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
    14  <script src="../style/scripts/prettify.min.js" type="text/javascript">
    15  </script>
    16  
    17  <link href="../images/favicon.ico" rel="shortcut icon" /><link href="http://httpd.apache.org/docs/current/mod/mod_authn_alias.html" rel="canonical" /></head>
    18  <body>
    19  <div id="page-header">
    20  <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
    21  <p class="apache">Apache HTTP Server Version 2.2</p>
    22  <img alt="" src="../images/feather.gif" /></div>
    23  <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
    24  <div id="path">
    25  <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.2</a> &gt; <a href="./">Modules</a></div>
    26  <div id="page-content">
    27  <div class="retired"><h4>Please note</h4>
    28              <p> This document refers to a legacy release (<strong>2.2</strong>) of Apache httpd. The active release (<strong>2.4</strong>) is documented <a href="http://httpd.apache.org/docs/current">here</a>. If you have not already upgraded, please follow <a href="http://httpd.apache.org/docs/current/upgrading.html">this link</a> for more information.</p>
    29          <p>You may follow <a href="http://httpd.apache.org/docs/current/mod/mod_authn_alias.html">this link</a> to go to the current version of this document.</p></div><div id="preamble"><h1>Apache Module mod_authn_alias</h1>
    30  <div class="toplang">
    31  <p><span>Available Languages: </span><a href="../en/mod/mod_authn_alias.html" title="English">&nbsp;en&nbsp;</a> |
    32  <a href="../fr/mod/mod_authn_alias.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
    33  </div>
    34  <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides the ability to create extended authentication 
    35      providers based on actual providers</td></tr>
    36  <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr>
    37  <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>authn_alias_module</td></tr>
    38  <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_authn_alias.c</td></tr>
    39  <tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1 and later</td></tr></table>
    40  <h3>Summary</h3>
    41  
    42      <p>This module allows extended authentication providers to be created 
    43      within the configuration file and assigned an alias name.  The alias 
    44      providers can then be referenced through the directives 
    45      <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> or 
    46      <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> in
    47      the same way as a base authentication provider.  Besides the ability
    48      to create and alias an extended provider, it also allows the same 
    49      extended authentication provider to be reference by multiple 
    50      locations.</p>
    51  
    52  </div>
    53  <div id="quickview"><h3>Topics</h3>
    54  <ul id="topics">
    55  <li><img alt="" src="../images/down.gif" /> <a href="#example">Examples</a></li>
    56  </ul><h3 class="directives">Directives</h3>
    57  <ul id="toc">
    58  <li><img alt="" src="../images/down.gif" /> <a href="#authnprovideralias">&lt;AuthnProviderAlias&gt;</a></li>
    59  </ul>
    60  <ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
    61  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
    62  <div class="section">
    63  <h2><a name="example" id="example">Examples</a></h2>
    64  
    65          <p>This example checks for passwords in two different text
    66          files.</p>
    67  
    68          <div class="example"><h3>Checking multiple text password files</h3><p><code>
    69  
    70          # Check here first<br />
    71          &lt;AuthnProviderAlias file file1&gt;<br />
    72          <span class="indent">
    73              AuthUserFile /www/conf/passwords1<br />
    74          </span>
    75          &lt;/AuthnProviderAlias&gt;<br />
    76          <br />
    77          # Then check here<br />
    78          &lt;AuthnProviderAlias file file2&gt;   <br />
    79          <span class="indent">
    80              AuthUserFile /www/conf/passwords2<br />
    81          </span>
    82          &lt;/AuthnProviderAlias&gt;<br />
    83          <br />
    84          &lt;Directory /var/web/pages/secure&gt;<br />
    85          <span class="indent">
    86              AuthBasicProvider file1 file2<br />
    87              <br />
    88              AuthType Basic<br />
    89              AuthName "Protected Area"<br />
    90              Require valid-user<br />
    91          </span>
    92          &lt;/Directory&gt;<br />
    93          </code></p></div>
    94  
    95           <p>The example below creates two different ldap authentication 
    96           provider aliases based on the ldap provider.  This allows
    97           a single authenticated location to be serviced by multiple ldap
    98           hosts:</p>
    99       
   100        <div class="example"><h3>Checking multiple LDAP servers</h3><p><code>
   101        LoadModule authn_alias_module modules/mod_authn_alias.so<br /><br />
   102        &lt;AuthnProviderAlias ldap ldap-alias1&gt;<br />
   103        <span class="indent">
   104           AuthLDAPBindDN cn=youruser,o=ctx<br />
   105           AuthLDAPBindPassword yourpassword<br />
   106           AuthLDAPURL ldap://ldap.host/o=ctx<br />
   107        </span>
   108        &lt;/AuthnProviderAlias&gt;<br /><br />
   109        &lt;AuthnProviderAlias ldap ldap-other-alias&gt;<br />
   110        <span class="indent">
   111           AuthLDAPBindDN cn=yourotheruser,o=dev<br />
   112           AuthLDAPBindPassword yourotherpassword<br />
   113           AuthLDAPURL ldap://other.ldap.host/o=dev?cn<br />
   114        </span>
   115        &lt;/AuthnProviderAlias&gt;<br /><br />
   116  
   117        Alias /secure /webpages/secure<br />
   118        &lt;Directory /webpages/secure&gt;<br />
   119        <span class="indent">
   120           Order deny,allow<br />
   121           Allow from all<br /><br />
   122      
   123           AuthBasicProvider ldap-other-alias  ldap-alias1<br /><br />
   124      
   125           AuthType Basic<br />
   126           AuthName LDAP_Protected_Place<br />
   127           AuthzLDAPAuthoritative off<br />
   128           Require valid-user<br />
   129        </span>
   130        &lt;/Directory&gt;<br />
   131      </code></p></div>
   132  </div>
   133  <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
   134  <div class="directive-section"><h2><a name="AuthnProviderAlias" id="AuthnProviderAlias">&lt;AuthnProviderAlias&gt;</a> <a name="authnprovideralias" id="authnprovideralias">Directive</a></h2>
   135  <table class="directive">
   136  <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an
   137  extension of a base authentication provider and referenced by
   138  the specified alias</td></tr>
   139  <tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>&lt;AuthnProviderAlias <var>baseProvider Alias</var>&gt;
   140  ... &lt;/AuthnProviderAlias&gt;</code></td></tr>
   141  <tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
   142  <tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
   143  <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_alias</td></tr>
   144  </table>
   145      <p><code class="directive">&lt;AuthnProviderAlias&gt;</code> and
   146      <code>&lt;/AuthnProviderAlias&gt;</code> are used to enclose a group of
   147      authentication directives that can be referenced by the alias name 
   148      using one of the directives <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">
   149      AuthBasicProvider</a></code> or <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">
   150      AuthDigestProvider</a></code>.</p>
   151  
   152      <div class="note">This directive has no affect on authorization, even for modules that
   153      provide both authentication and authorization.</div>
   154  
   155  </div>
   156  </div>
   157  <div class="bottomlang">
   158  <p><span>Available Languages: </span><a href="../en/mod/mod_authn_alias.html" title="English">&nbsp;en&nbsp;</a> |
   159  <a href="../fr/mod/mod_authn_alias.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a></p>
   160  </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
   161  <script type="text/javascript"><!--//--><![CDATA[//><!--
   162  var comments_shortname = 'httpd';
   163  var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_authn_alias.html';
   164  (function(w, d) {
   165      if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
   166          d.write('<div id="comments_thread"><\/div>');
   167          var s = d.createElement('script');
   168          s.type = 'text/javascript';
   169          s.async = true;
   170          s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
   171          (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
   172      }
   173      else { 
   174          d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
   175      }
   176  })(window, document);
   177  //--><!]]></script></div><div id="footer">
   178  <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
   179  <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
   180  if (typeof(prettyPrint) !== 'undefined') {
   181      prettyPrint();
   182  }
   183  //--><!]]></script>
   184  </body></html>