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 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_authn_alias - Apache HTTP Server</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<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" /> 12<script src="/style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<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> 19<p class="apache">Apache HTTP Server Version 2.2</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Apache Module mod_authn_alias</h1> 26<div class="toplang"> 27<p><span>Available Languages: </span><a href="/en/mod/mod_authn_alias.html" title="English"> en </a> | 28<a href="/fr/mod/mod_authn_alias.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a></p> 29</div> 30<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Provides the ability to create extended authentication 31 providers based on actual providers</td></tr> 32<tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr> 33<tr><th><a href="module-dict.html#ModuleIdentifier">Module�Identifier:</a></th><td>authn_alias_module</td></tr> 34<tr><th><a href="module-dict.html#SourceFile">Source�File:</a></th><td>mod_authn_alias.c</td></tr> 35<tr><th><a href="module-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1 and later</td></tr></table> 36<h3>Summary</h3> 37 38 <p>This module allows extended authentication providers to be created 39 within the configuration file and assigned an alias name. The alias 40 providers can then be referenced through the directives 41 <code class="directive"><a href="/mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> or 42 <code class="directive"><a href="/mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> in 43 the same way as a base authentication provider. Besides the ability 44 to create and alias an extended provider, it also allows the same 45 extended authentication provider to be reference by multiple 46 locations.</p> 47 48</div> 49<div id="quickview"><h3 class="directives">Directives</h3> 50<ul id="toc"> 51<li><img alt="" src="/images/down.gif" /> <a href="#authnprovideralias"><AuthnProviderAlias></a></li> 52</ul> 53<h3>Topics</h3> 54<ul id="topics"> 55<li><img alt="" src="/images/down.gif" /> <a href="#example">Examples</a></li> 56</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> 57<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 58<div class="section"> 59<h2><a name="example" id="example">Examples</a></h2> 60 61 <p>This example checks for passwords in two different text 62 files.</p> 63 64 <div class="example"><h3>Checking multiple text password files</h3><p><code> 65 66 # Check here first<br /> 67 <AuthnProviderAlias file file1><br /> 68 <span class="indent"> 69 AuthUserFile /www/conf/passwords1<br /> 70 </span> 71 </AuthnProviderAlias><br /> 72 <br /> 73 # Then check here<br /> 74 <AuthnProviderAlias file file2> <br /> 75 <span class="indent"> 76 AuthUserFile /www/conf/passwords2<br /> 77 </span> 78 </AuthnProviderAlias><br /> 79 <br /> 80 <Directory /var/web/pages/secure><br /> 81 <span class="indent"> 82 AuthBasicProvider file1 file2<br /> 83 <br /> 84 AuthType Basic<br /> 85 AuthName "Protected Area"<br /> 86 Require valid-user<br /> 87 </span> 88 </Directory><br /> 89 </code></p></div> 90 91 <p>The example below creates two different ldap authentication 92 provider aliases based on the ldap provider. This allows 93 a single authenticated location to be serviced by multiple ldap 94 hosts:</p> 95 96 <div class="example"><h3>Checking multiple LDAP servers</h3><p><code> 97 LoadModule authn_alias_module modules/mod_authn_alias.so<br /><br /> 98 <AuthnProviderAlias ldap ldap-alias1><br /> 99 <span class="indent"> 100 AuthLDAPBindDN cn=youruser,o=ctx<br /> 101 AuthLDAPBindPassword yourpassword<br /> 102 AuthLDAPURL ldap://ldap.host/o=ctx<br /> 103 </span> 104 </AuthnProviderAlias><br /><br /> 105 <AuthnProviderAlias ldap ldap-other-alias><br /> 106 <span class="indent"> 107 AuthLDAPBindDN cn=yourotheruser,o=dev<br /> 108 AuthLDAPBindPassword yourotherpassword<br /> 109 AuthLDAPURL ldap://other.ldap.host/o=dev?cn<br /> 110 </span> 111 </AuthnProviderAlias><br /><br /> 112 113 Alias /secure /webpages/secure<br /> 114 <Directory /webpages/secure><br /> 115 <span class="indent"> 116 Order deny,allow<br /> 117 Allow from all<br /><br /> 118 119 AuthBasicProvider ldap-other-alias ldap-alias1<br /><br /> 120 121 AuthType Basic<br /> 122 AuthName LDAP_Protected_Place<br /> 123 AuthzLDAPAuthoritative off<br /> 124 Require valid-user<br /> 125 </span> 126 </Directory><br /> 127 </code></p></div> 128</div> 129<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 130<div class="directive-section"><h2><a name="AuthnProviderAlias" id="AuthnProviderAlias"><AuthnProviderAlias></a> <a name="authnprovideralias" id="authnprovideralias">Directive</a></h2> 131<table class="directive"> 132<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enclose a group of directives that represent an 133extension of a base authentication provider and referenced by 134the specified alias</td></tr> 135<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code><AuthnProviderAlias <var>baseProvider Alias</var>> 136... </AuthnProviderAlias></code></td></tr> 137<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> 138<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr> 139<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authn_alias</td></tr> 140</table> 141 <p><code class="directive"><AuthnProviderAlias></code> and 142 <code></AuthnProviderAlias></code> are used to enclose a group of 143 authentication directives that can be referenced by the alias name 144 using one of the directives <code class="directive"><a href="/mod/mod_auth_basic.html# authbasicprovider"> 145 AuthBasicProvider</a></code> or <code class="directive"><a href="/mod/mod_auth_digest.html# authdigestprovider"> 146 AuthDigestProvider</a></code>.</p> 147 148 149</div> 150</div> 151<div class="bottomlang"> 152<p><span>Available Languages: </span><a href="/en/mod/mod_authn_alias.html" title="English"> en </a> | 153<a href="/fr/mod/mod_authn_alias.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a></p> 154</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&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> 155<script type="text/javascript"><!--//--><![CDATA[//><!-- 156var comments_shortname = 'httpd'; 157var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_authn_alias.html'; 158(function(w, d) { 159 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 160 d.write('<div id="comments_thread"><\/div>'); 161 var s = d.createElement('script'); 162 s.type = 'text/javascript'; 163 s.async = true; 164 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 165 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 166 } 167 else { 168 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 169 } 170})(window, document); 171//--><!]]></script></div><div id="footer"> 172<p class="apache">Copyright 2013 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> 173<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[//><!-- 174if (typeof(prettyPrint) !== 'undefined') { 175 prettyPrint(); 176} 177//--><!]]></script> 178</body></html>