2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision : 1352084 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <modulesynopsis metafile="mod_authn_core.xml.meta">
27 <name>mod_authn_core</name>
28 <description>Le noyau de l'authentification</description>
30 <sourcefile>mod_authn_core.c</sourcefile>
31 <identifier>authn_core_module</identifier>
32 <compatibility>Disponible depuis la version 2.3 d'Apache</compatibility>
35 <p>Ce module fournit le coeur des fonctionnalités d'authentification
36 permettant d'accorder ou de refuser l'accès à certaines zones du
37 site web. Les directives fournies par le module
38 <module>mod_authn_core</module> sont communes à tous les
39 fournisseurs d'authentification.</p>
42 <section id="authnalias"><title>Création d'alias de fournisseurs
43 d'authentification</title>
45 <p>Il est possible de créer des fournisseurs d'authentification
46 étendus dans le fichier de configuration et de leur assigner un
47 alias. Le fournisseur ainsi nommé peut alors être référencé à l'aide
48 des directives <directive
49 module="mod_auth_basic">AuthBasicProvider</directive> ou <directive
50 module="mod_auth_digest">AuthDigestProvider</directive> tout comme
51 un fournisseur d'authentification de base. Outre la possibilité de
52 créer et attribuer un alias à un fournisseur étendu, le même
53 fournisseur d'authentification peut aussi être référencé par
54 plusieurs sections relatives à une zone du site web.</p>
56 <section id="example"><title>Exemples</title>
58 <p>Cet exemple vérifie les mots de passe dans deux fichiers
59 textes différents.</p>
61 <example><title>Vérification dans plusieurs fichiers de mots de
62 passe au format texte</title>
64 <highlight language="config">
65 # Première vérification
66 <AuthnProviderAlias file file1>
67 AuthUserFile /www/conf/passwords1
68 </AuthnProviderAlias>
70 # Vérification suivante
71 <AuthnProviderAlias file file2>
72 AuthUserFile /www/conf/passwords2
73 </AuthnProviderAlias>
75 <Directory /var/web/pages/secure>
76 AuthBasicProvider file1 file2
79 AuthName "Protected Area"
87 <p>Dans l'exemple ci-dessous, deux fournisseurs
88 d'authentification ldap sont créés à partir du fournisseur ldap
89 de base, et se voient attribuer un alias. L'authentification
90 d'une même zone peut alors être traitée par plusieurs serveurs
93 <example><title>Vérification auprès de plusieurs serveurs
95 <highlight language="config">
96 <AuthnProviderAlias ldap ldap-alias1>
97 AuthLDAPBindDN cn=youruser,o=ctx
98 AuthLDAPBindPassword yourpassword
99 AuthLDAPURL ldap://ldap.host/o=ctx
100 </AuthnProviderAlias>
101 <AuthnProviderAlias ldap ldap-other-alias>
102 AuthLDAPBindDN cn=yourotheruser,o=dev
103 AuthLDAPBindPassword yourotherpassword
104 AuthLDAPURL ldap://other.ldap.host/o=dev?cn
105 </AuthnProviderAlias>
107 Alias /secure /webpages/secure
108 <Directory /webpages/secure>
112 AuthBasicProvider ldap-other-alias ldap-alias1
115 AuthName LDAP_Protected Place
117 # Notez que Require ldap-* ne fonctionnerait pas ici, car
118 # AuthnProviderAlias ne fournit pas de configuration pour les
119 # fournisseurs d'autorisation implémentés dans le même module que le
120 # fournisseur d'authentification.
130 <name>AuthName</name>
131 <description>L'identifiant de l'autorisation à utiliser avec
132 l'authentification HTTP</description>
133 <syntax>AuthName <var>domaine d'autorisation</var></syntax>
134 <contextlist><context>directory</context><context>.htaccess</context>
136 <override>AuthConfig</override>
139 <p>Cette directive permet de définir l'identifiant d'autorisation
140 pour un répertoire. Cet identifiant est fourni au client de façon à
141 ce qu'il sache quels nom d'utilisateur et mot de passe envoyer.
142 <directive>AuthName</directive> accepte un seul argument ; s'il
143 contient des espaces, il doit être entouré de guillemets. Pour
144 pouvoir fonctionner, la directive <directive>AuthName</directive>
145 doit être utilisée en combinaison avec les directives <directive
146 module="mod_authn_core">AuthType</directive> et <directive
147 module="mod_authz_core">Require</directive>, ainsi que des
148 directives comme <directive
149 module="mod_authn_file">AuthUserFile</directive> et <directive
150 module="mod_authz_groupfile">AuthGroupFile</directive>.</p>
154 <highlight language="config">
155 AuthName "Top Secret"
158 <p>La chaîne fournie comme argument à <code>AuthName</code>
159 apparaîtra dans la boîte de dialogue d'authentification pour la
160 plupart des navigateurs.</p>
163 href="../howto/auth.html">Authentification, autorisation et contrôle
164 d'accès</a></seealso>
165 <seealso><module>mod_authz_core</module></seealso>
169 <name>AuthType</name>
170 <description>Type d'authentification utilisateur</description>
171 <syntax>AuthType None|Basic|Digest|Form</syntax>
172 <contextlist><context>directory</context><context>.htaccess</context>
174 <override>AuthConfig</override>
177 <p>Cette directive permet de définir le type d'authentification
178 utilisateur pour un répertoire. Les types d'authentification
179 disponibles sont <code>None</code>, <code>Basic</code> (implémenté
180 par <module>mod_auth_basic</module>), <code>Digest</code>
181 (implémenté par <module>mod_auth_digest</module>), et
182 <code>Form</code> (implémenté par
183 <module>mod_auth_form</module>).</p>
185 <p>Pour mettre en oeuvre l'authentification, vous devez aussi
186 utiliser les directives <directive
187 module="mod_authn_core">AuthName</directive> et <directive
188 module="mod_authz_core">Require</directive>. De plus, le serveur
189 doit pouvoir disposer d'un module fournisseur d'authentification
190 comme <module>mod_authn_file</module> et d'un module d'autorisation
191 comme <module>mod_authz_user</module>.</p>
193 <p>Le type d'authentification <code>None</code> désactive
194 l'authentification. Lorsqu'une authentification est définie, elle
195 est en général héritée par chacune des <a
196 href="../sections.html#mergin">sections de configuration</a> qui
197 suivent, à moins qu'un autre type d'authentification ne soit
198 spécifié. Si l'on ne souhaite pas mettre en oeuvre
199 d'authentification pour une sous-section d'une section authentifiée,
200 on doit utiliser le type d'authentification <code>None</code> ; dans
201 l'exemple suivant, les clients peuvent accéder au répertoire
202 <code>/www/docs/public</code> sans devoir s'authentifier :</p>
204 <highlight language="config">
205 <Directory /www/docs>
208 AuthBasicProvider file
209 AuthUserFile /usr/local/apache/passwd/passwords
213 <Directory /www/docs/public>
219 <note>Veuillez noter que, lorsque l'authentification n'est pas
220 activée, les clients qui se sont déjà authentifiés pour une autre
221 zone de l'arborescence du site continueront en général à envoyer des
222 en-tête d'authentification HTTP ou des cookies avec chaque requête,
223 sans se préoccuper de savoir si le serveur nécessite vraiment une
224 authentification pour chaque ressource.</note>
227 <seealso><a href="../howto/auth.html">Authentification, autorisation et contrôle
228 d'accès</a></seealso>
231 <directivesynopsis type="section">
232 <name>AuthnProviderAlias</name>
233 <description>Regroupe un ensemble de directives qui constituent une
234 extension d'un fournisseur d'authentification de base et lui attribue
235 l'alias spécifié</description>
236 <syntax><AuthnProviderAlias <var>alias-fournisseur</var>>
237 ... </AuthnProviderAlias></syntax>
238 <contextlist><context>server config</context>
242 <p>Les balises <code><AuthnProviderAlias></code> et
243 <code></AuthnProviderAlias></code> permettent de regrouper un
244 ensemble de directives d'authentification qui seront référencées par
245 l'alias spécifié à l'aide des directives <directive
246 module="mod_auth_basic">AuthBasicProvider</directive> ou <directive
247 module="mod_auth_digest">AuthDigestProvider</directive>.</p>