mirror of
https://github.com/apache/httpd.git
synced 2025-11-03 17:53:20 +03:00
8037a09fd8
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1678383 13f79535-47bb-0310-9956-ffa450edef68
226 lines
9.2 KiB
Plaintext
226 lines
9.2 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision: 1673947 -->
|
|
<!-- 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
|
|
authentifiées</description>
|
|
<status>Extension</status>
|
|
<sourcefile>mod_authn_anon.c</sourcefile>
|
|
<identifier>authn_anon_module</identifier>
|
|
|
|
<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>,
|
|
fournir un mot de passe est obligatoire.</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
|
|
ont pour seule possibilité 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>
|