| <?xml version="1.0"?> |
| <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> |
| <!-- English Revision: 1673563 --> |
| <!-- French translation : Lucien GENTIS --> |
| <!-- Reviewed by : Vincent Deffontaines --> |
| |
| <!-- |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| --> |
| |
| <modulesynopsis metafile="mod_authn_anon.xml.meta"> |
| |
| <name>mod_authn_anon</name> |
| <description>Permet un accès "anonyme" à des zones |
| protégées</description> |
| <status>Extension</status> |
| <sourcefile>mod_authn_anon.c</sourcefile> |
| <identifier>authn_anon_module</identifier> |
| <compatibility>Disponible depuis la version 2.1 d'Apache</compatibility> |
| |
| <summary> |
| <p>Ce module permet aux frontaux d'authentification comme |
| <module>mod_auth_basic</module> d'authentifier les utilisateurs |
| à la manière des sites FTP anonymes, c'est à dire |
| en fournissant l'identifiant utilisateur spécial 'anonymous' et |
| l'adresse email comme mot de passe. Ces adresses email peuvent être |
| journalisées.</p> |
| |
| <p>En combinaison avec d'autres méthodes de contrôle d'accès (base |
| de données), ce module permet d'effectuer un véritable suivi des |
| utilisateurs et une personnalisation de leurs accès en fonction de |
| leur profil, tout en conservant l'accessibilité du site aux |
| utilisateurs 'non enregistrés'. Un avantage du suivi des |
| utilisateurs basé sur l'authentification réside dans le fait qu'il |
| est, à l'opposé des cookies magiques et des drôles d'URLs avec |
| préfixes ou suffixes, entièrement indépendant du navigateur et qu'il |
| permet de partager des URLs entre plusieurs utilisateurs.</p> |
| |
| <p>Si l'on utilise le module <module>mod_auth_basic</module>, le |
| module <module>mod_authn_anon</module> est invoqué en affectant la |
| valeur <code>anon</code> à la directive <directive |
| module="mod_auth_basic">AuthBasicProvider</directive>.</p> |
| </summary> |
| |
| <section id="example"><title>Exemple</title> |
| <p>L'exemple ci-dessous présente un exemple de combinaison avec |
| l'authentification à base de fichier htpasswd "normale", et permet |
| la connexion d'utilisateurs en tant qu'invités avec les propriétés |
| suivantes :</p> |
| |
| <ul> |
| <li>Il incite l'utilisateur à fournir un identifiant. |
| (<directive module="mod_authn_anon" |
| >Anonymous_NoUserID</directive>)</li> |
| |
| <li>Il incite l'utilisateur à fournir un mot de passe. |
| (<directive module="mod_authn_anon" |
| >Anonymous_MustGiveEmail</directive>)</li> |
| |
| <li>Le mot de passe fourni doit être une adresse email valide, |
| c'est à dire contenant au moins un '@' et un '.'. |
| (<directive module="mod_authn_anon" |
| >Anonymous_VerifyEmail</directive>)</li> |
| |
| <li>Les valeurs possibles pour l'identifiant utilisateur sont |
| <code>anonymous, guest, www, test ou welcome</code>, et la |
| vérification n'est <strong>pas</strong> sensible à la casse. |
| (<directive module="mod_authn_anon" |
| >Anonymous</directive>)</li> |
| |
| <li>Les adresses email entrées dans le champ passwd sont |
| enregistrées dans le fichier journal des erreurs. |
| (<directive module="mod_authn_anon" |
| >Anonymous_LogEmail</directive>)</li> |
| </ul> |
| |
| <example><title>Exemple</title> |
| <highlight language="config"> |
| <Directory "/var/www/html/private"> |
| AuthName "Use 'anonymous' & Email address for guest entry" |
| AuthType Basic |
| AuthBasicProvider file anon |
| AuthUserFile "/path/to/your/.htpasswd" |
| |
| Anonymous_NoUserID off |
| Anonymous_MustGiveEmail on |
| Anonymous_VerifyEmail on |
| Anonymous_LogEmail on |
| Anonymous anonymous guest www test welcome |
| |
| Require valid-user |
| </Directory> |
| </highlight> |
| </example> |
| </section> |
| |
| <directivesynopsis> |
| <name>Anonymous</name> |
| <description>Définit la liste des identifiants utilisateur autorisés à |
| accéder sans vérification du mot de passe</description> |
| <syntax>Anonymous <var>utilisateur</var> [<var>utilisateur</var>] |
| ...</syntax> |
| <contextlist><context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>AuthConfig</override> |
| |
| <usage> |
| <p>Une liste d'un ou plusieurs identifiants utilisateur spéciaux |
| autorisés à accéder sans vérification du mot de passe. Les |
| identifiants doivent être séparés par un espace. Pour spécifier un |
| identifiant contenant un espace, on peut utiliser les guillemets ' |
| ou ", ou le caractère d'échappement \.</p> |
| |
| <p>Veuillez noter que la vérification <strong>n'est pas sensible à |
| la casse</strong>.<br /> |
| Il est fortement conseillé d'intégrer l'utilisateur spécial |
| '<code>anonymous</code>' dans la liste des identifiants.</p> |
| |
| <example><title>Exemple:</title> |
| <highlight language="config"> |
| Anonymous anonymous "Not Registered" "I don't know" |
| </highlight> |
| </example> |
| |
| <p>Dans cet exemple, l'utilisateur peut accéder au site sans |
| vérification du mot de passe en utilisant l'identifiant "anonymous", |
| "Not Registered", "I Don't Know" ou encore "AnonyMous".</p> |
| |
| <p>Depuis Apache 2.1, il est possible de remplacer la liste des |
| identifiants autorisés par le caractère "<code>*</code>", ce qui |
| permet d'utiliser <em>n'importe quel</em> identifiant pour pouvoir |
| accéder au site.</p> |
| </usage> |
| </directivesynopsis> |
| |
| <directivesynopsis> |
| <name>Anonymous_LogEmail</name> |
| <description>Détermine si le mot de passe fourni sera enregistré dans le |
| journal des erreurs</description> |
| <syntax>Anonymous_LogEmail On|Off</syntax> |
| <default>Anonymous_LogEmail On</default> |
| <contextlist><context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>AuthConfig</override> |
| |
| <usage> |
| <p>Lorsque cette directive est définie à <code>On</code>, valeur |
| par défaut, le 'mot de passe' fourni (censé contenir une adresse |
| email valide) est enregistré dans le journal des erreurs.</p> |
| </usage> |
| </directivesynopsis> |
| |
| <directivesynopsis> |
| <name>Anonymous_MustGiveEmail</name> |
| <description>Détermine si l'abscence de mot de passe est |
| autorisée</description> |
| <syntax>Anonymous_MustGiveEmail On|Off</syntax> |
| <default>Anonymous_MustGiveEmail On</default> |
| <contextlist><context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>AuthConfig</override> |
| |
| <usage> |
| <p>Détermine si l'utilisateur doit spécifier une adresse email comme |
| mot de passe. Lorsque cette directive est définie à <code>On</code>, |
| l'abscence de mot de passe est interdite.</p> |
| </usage> |
| </directivesynopsis> |
| |
| <directivesynopsis> |
| <name>Anonymous_NoUserID</name> |
| <description>Détermine si le champ identifiant peut être |
| vide</description> |
| <syntax>Anonymous_NoUserID On|Off</syntax> |
| <default>Anonymous_NoUserID Off</default> |
| <contextlist><context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>AuthConfig</override> |
| |
| <usage> |
| <p>Lorsque cette directive est définie à <code>On</code>, les |
| utilisateurs peuvent laisser le champ identifiant vide (et peut-être |
| aussi le champ mot de passe selon la définition de la directive |
| <directive |
| module="mod_authn_anon">Anonymous_MustGiveEmail</directive>). Ceci |
| peut s'avérer très utile pour les utilisateurs de MS-Explorer qui |
| n'ont pour seule possibilité que d'appuyer sur Entrée ou de cliquer |
| directement sur le bouton OK, ce qui semble être une réaction |
| naturelle.</p> |
| </usage> |
| </directivesynopsis> |
| |
| <directivesynopsis> |
| <name>Anonymous_VerifyEmail</name> |
| <description>Détermine s'il faut vérifier que le format de l'adresse |
| email fournie comme mot de passe est correct</description> |
| <syntax>Anonymous_VerifyEmail On|Off</syntax> |
| <default>Anonymous_VerifyEmail Off</default> |
| <contextlist><context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>AuthConfig</override> |
| |
| <usage> |
| <p>Lorsque cette directive est définie à <code>On</code>, Apache |
| vérifie que le 'mot de passe' entré contient au moins un '@' et un |
| '.' afin d'inciter les utilisateurs à fournir des adresses email |
| valides (voir ci-dessus la directive <directive |
| module="mod_authn_anon">Anonymous_LogEmail</directive>).</p> |
| </usage> |
| </directivesynopsis> |
| |
| </modulesynopsis> |
