2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision: 1673947 -->
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_anon.xml.meta">
27 <name>mod_authn_anon</name>
28 <description>Permet un accès "anonyme" à des zones
29 authentifiées</description>
30 <status>Extension</status>
31 <sourcefile>mod_authn_anon.c</sourcefile>
32 <identifier>authn_anon_module</identifier>
35 <p>Ce module permet aux frontaux d'authentification comme
36 <module>mod_auth_basic</module> d'authentifier les utilisateurs
37 à la manière des sites FTP anonymes, c'est à dire
38 en fournissant l'identifiant utilisateur spécial 'anonymous' et
39 l'adresse email comme mot de passe. Ces adresses email peuvent être
40 journalisées.</p>
42 <p>En combinaison avec d'autres méthodes de contrôle d'accès (base
43 de données), ce module permet d'effectuer un véritable suivi des
44 utilisateurs et une personnalisation de leurs accès en fonction de
45 leur profil, tout en conservant l'accessibilité du site aux
46 utilisateurs 'non enregistrés'. Un avantage du suivi des
47 utilisateurs basé sur l'authentification réside dans le fait qu'il
48 est, à l'opposé des cookies magiques et des drôles d'URLs avec
49 préfixes ou suffixes, entièrement indépendant du navigateur et qu'il
50 permet de partager des URLs entre plusieurs utilisateurs.</p>
52 <p>Si l'on utilise le module <module>mod_auth_basic</module>, le
53 module <module>mod_authn_anon</module> est invoqué en affectant la
54 valeur <code>anon</code> à la directive <directive
55 module="mod_auth_basic">AuthBasicProvider</directive>.</p>
58 <section id="example"><title>Exemple</title>
59 <p>L'exemple ci-dessous présente un exemple de combinaison avec
60 l'authentification à base de fichier htpasswd "normale", et permet
61 la connexion d'utilisateurs en tant qu'invités avec les propriétés
65 <li>Il incite l'utilisateur à fournir un identifiant.
66 (<directive module="mod_authn_anon"
67 >Anonymous_NoUserID</directive>)</li>
69 <li>Il incite l'utilisateur à fournir un mot de passe.
70 (<directive module="mod_authn_anon"
71 >Anonymous_MustGiveEmail</directive>)</li>
73 <li>Le mot de passe fourni doit être une adresse email valide,
74 c'est à dire contenant au moins un '@' et un '.'.
75 (<directive module="mod_authn_anon"
76 >Anonymous_VerifyEmail</directive>)</li>
78 <li>Les valeurs possibles pour l'identifiant utilisateur sont
79 <code>anonymous, guest, www, test ou welcome</code>, et la
80 vérification n'est <strong>pas</strong> sensible à la casse.
81 (<directive module="mod_authn_anon"
82 >Anonymous</directive>)</li>
84 <li>Les adresses email entrées dans le champ passwd sont
85 enregistrées dans le fichier journal des erreurs.
86 (<directive module="mod_authn_anon"
87 >Anonymous_LogEmail</directive>)</li>
90 <example><title>Exemple</title>
91 <highlight language="config">
92 <Directory "/var/www/html/private">
93 AuthName "Use 'anonymous' & Email address for guest entry"
95 AuthBasicProvider file anon
96 AuthUserFile "/path/to/your/.htpasswd"
98 Anonymous_NoUserID off
99 Anonymous_MustGiveEmail on
100 Anonymous_VerifyEmail on
101 Anonymous_LogEmail on
102 Anonymous anonymous guest www test welcome
111 <name>Anonymous</name>
112 <description>Définit la liste des identifiants utilisateur autorisés à
113 accéder sans vérification du mot de passe</description>
114 <syntax>Anonymous <var>utilisateur</var> [<var>utilisateur</var>]
116 <contextlist><context>directory</context><context>.htaccess</context>
118 <override>AuthConfig</override>
121 <p>Une liste d'un ou plusieurs identifiants utilisateur spéciaux
122 autorisés à accéder sans vérification du mot de passe. Les
123 identifiants doivent être séparés par un espace. Pour spécifier un
124 identifiant contenant un espace, on peut utiliser les guillemets '
125 ou ", ou le caractère d'échappement \.</p>
127 <p>Veuillez noter que la vérification <strong>n'est pas sensible à
128 la casse</strong>.<br />
129 Il est fortement conseillé d'intégrer l'utilisateur spécial
130 '<code>anonymous</code>' dans la liste des identifiants.</p>
132 <example><title>Exemple:</title>
133 <highlight language="config">
134 Anonymous anonymous "Not Registered" "I don't know"
138 <p>Dans cet exemple, l'utilisateur peut accéder au site sans
139 vérification du mot de passe en utilisant l'identifiant "anonymous",
140 "Not Registered", "I Don't Know" ou encore "AnonyMous".</p>
142 <p>Depuis Apache 2.1, il est possible de remplacer la liste des
143 identifiants autorisés par le caractère "<code>*</code>", ce qui
144 permet d'utiliser <em>n'importe quel</em> identifiant pour pouvoir
145 accéder au site.</p>
150 <name>Anonymous_LogEmail</name>
151 <description>Détermine si le mot de passe fourni sera enregistré dans le
152 journal des erreurs</description>
153 <syntax>Anonymous_LogEmail On|Off</syntax>
154 <default>Anonymous_LogEmail On</default>
155 <contextlist><context>directory</context><context>.htaccess</context>
157 <override>AuthConfig</override>
160 <p>Lorsque cette directive est définie à <code>On</code>, valeur
161 par défaut, le 'mot de passe' fourni (censé contenir une adresse
162 email valide) est enregistré dans le journal des erreurs.</p>
167 <name>Anonymous_MustGiveEmail</name>
168 <description>Détermine si l'abscence de mot de passe est
169 autorisée</description>
170 <syntax>Anonymous_MustGiveEmail On|Off</syntax>
171 <default>Anonymous_MustGiveEmail On</default>
172 <contextlist><context>directory</context><context>.htaccess</context>
174 <override>AuthConfig</override>
177 <p>Détermine si l'utilisateur doit spécifier une adresse email comme
178 mot de passe. Lorsque cette directive est définie à <code>On</code>,
179 fournir un mot de passe est obligatoire.</p>
184 <name>Anonymous_NoUserID</name>
185 <description>Détermine si le champ identifiant peut être
187 <syntax>Anonymous_NoUserID On|Off</syntax>
188 <default>Anonymous_NoUserID Off</default>
189 <contextlist><context>directory</context><context>.htaccess</context>
191 <override>AuthConfig</override>
194 <p>Lorsque cette directive est définie à <code>On</code>, les
195 utilisateurs peuvent laisser le champ identifiant vide (et peut-être
196 aussi le champ mot de passe selon la définition de la directive
198 module="mod_authn_anon">Anonymous_MustGiveEmail</directive>). Ceci
199 peut s'avérer très utile pour les utilisateurs de MS-Explorer qui
200 ont pour seule possibilité d'appuyer sur Entrée ou de cliquer
201 directement sur le bouton OK, ce qui semble être une réaction
207 <name>Anonymous_VerifyEmail</name>
208 <description>Détermine s'il faut vérifier que le format de l'adresse
209 email fournie comme mot de passe est correct</description>
210 <syntax>Anonymous_VerifyEmail On|Off</syntax>
211 <default>Anonymous_VerifyEmail Off</default>
212 <contextlist><context>directory</context><context>.htaccess</context>
214 <override>AuthConfig</override>
217 <p>Lorsque cette directive est définie à <code>On</code>, Apache
218 vérifie que le 'mot de passe' entré contient au moins un '@' et un
219 '.' afin d'inciter les utilisateurs à fournir des adresses email
220 valides (voir ci-dessus la directive <directive
221 module="mod_authn_anon">Anonymous_LogEmail</directive>).</p>