| <?xml version="1.0"?> |
| <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> |
| <!-- English Revision: 1342921 --> |
| <!-- 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_file.xml.meta"> |
| |
| <name>mod_authn_file</name> |
| <description>Authentification utilisateur à l'aide de fichiers |
| texte</description> |
| <status>Base</status> |
| <sourcefile>mod_authn_file.c</sourcefile> |
| <identifier>authn_file_module</identifier> |
| <compatibility>Disponible depuis les versions 2.1 et supérieures |
| d'Apache</compatibility> |
| |
| <summary> |
| <p>Ce module permet aux frontaux d'authentification comme |
| <module>mod_auth_digest</module> et <module>mod_auth_basic</module> |
| d'authentifier les utilisateurs en les recherchant dans des fichiers |
| de mots de passe au format texte. <module>mod_authn_dbm</module> |
| fournit une fonctionnalité similaire.</p> |
| |
| <p>Lorsqu'on utilise <module>mod_auth_basic</module> ou |
| <module>mod_auth_digest</module>, ce module peut être invoqué en |
| affectant la valeur <code>file</code> à la directive <directive |
| module="mod_auth_basic">AuthBasicProvider</directive> ou <directive |
| module="mod_auth_digest">AuthDigestProvider</directive>.</p> |
| </summary> |
| <seealso> |
| <directive module="mod_auth_basic">AuthBasicProvider</directive> |
| </seealso> |
| <seealso> |
| <directive module="mod_auth_digest">AuthDigestProvider</directive> |
| </seealso> |
| <seealso><program>htpasswd</program></seealso> |
| <seealso><program>htdigest</program></seealso> |
| <seealso><a href="../misc/password_encryptions.html">Formats de mots de |
| passe</a></seealso> |
| |
| <directivesynopsis> |
| <name>AuthUserFile</name> |
| <description>Définit le nom d'un fichier texte pour l'authentification |
| contenant la liste des utilisateurs et de leurs mots de |
| passe</description> |
| <syntax>AuthUserFile <var>chemin-fichier</var></syntax> |
| <contextlist><context>directory</context><context>.htaccess</context> |
| </contextlist> |
| <override>AuthConfig</override> |
| |
| <usage> |
| <p>La directive <directive>AuthUserFile</directive> permet de |
| définir le nom d'un fichier texte pour l'authentification contenant |
| la liste des utilisateurs et de leurs mots de passe. |
| <var>chemin-fichier</var> est le chemin vers le fichier |
| des utilisateurs. S'il n'est pas absolu, il est considéré comme |
| relatif au répertoire défini par la directive <directive |
| module="core">ServerRoot</directive>.</p> |
| |
| <p>Chaque ligne du fichier des utilisateurs se compose du nom de |
| l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le |
| même identifiant utilisateur est référencé plusieurs fois, |
| <module>mod_authn_file</module> utilisera la première occurrence pour |
| vérifier le mot de passe.</p> |
| |
| <p>Le format du mot de passe chiffré dépend du frontal |
| d'authentification utilisé (par exemple |
| <module>mod_auth_basic</module> ou |
| <module>mod_auth_digest</module>). Voir la documentation sur les |
| <a href="../misc/password_encryptions.html">Formats de mots de |
| passe</a> pour plus de détails.</p> |
| |
| <p>Pour <module>mod_auth_basic</module>, utilisez le programme |
| <program>htpasswd</program> fourni avec la distribution binaire, |
| mais que vous trouverez aussi dans le répertoire |
| <code>src/support</code> de l'arborescence des sources. Voir sa <a |
| href="../programs/htpasswd.html">page de manuel</a> pour plus de |
| détails. En bref :</p> |
| |
| <p>On crée un fichier de mots de passe <code>nom-fichier</code> avec |
| <code>nom-utilisateur</code> comme identifiant initial. Le mot de |
| passe correspondant sera alors demandé :</p> |
| |
| <example> |
| htpasswd -c nom-fichier nom-utilisateur |
| </example> |
| |
| <p>Pour ajouter ou modifier <code>nom-utilisateur2</code> dans le |
| fichier de mots de passe <code>nom-fichier</code> :</p> |
| |
| <example> |
| htpasswd nom-fichier nom-utilisateur2 |
| </example> |
| |
| <p>Noter qu'une recherche dans de grands fichiers texte peut être |
| très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM |
| avec la directive <directive |
| module="mod_authn_dbm">AuthDBMUserFile</directive>.</p> |
| |
| <p>Pour <module>mod_auth_digest</module>, vous devez utiliser |
| le programme <program>htdigest</program>. |
| Notez que vous ne pouvez pas mélanger des données utilisateur pour |
| l'Authentification HTTP à base de condensé et des données pour |
| l'Authentification de Base dans le même fichier.</p> |
| |
| <note type="warning"><title>Sécurité</title> |
| <p>Assurez-vous que le fichier <directive>AuthUserFile</directive> |
| soit bien stocké en dehors de l'arborescence des documents du |
| serveur web. Ne placez <strong>pas</strong> ce fichier dans le |
| répertoire qu'il protège. Dans le cas contraire, les clients |
| seraient en mesure de télécharger le fichier des mots de passe.</p> |
| </note> |
| </usage> |
| </directivesynopsis> |
| |
| </modulesynopsis> |