granicus.if.org Git - apache/blob - docs/manual/mod/mod_authn_file.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1421821 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   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
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  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.
  23 -->
  24
  25 <modulesynopsis metafile="mod_authn_file.xml.meta">
  26
  27 <name>mod_authn_file</name>
  28 <description>Authentification utilisateur &agrave; l'aide de fichiers
  29 texte</description>
  30 <status>Base</status>
  31 <sourcefile>mod_authn_file.c</sourcefile>
  32 <identifier>authn_file_module</identifier>
  33
  34 <summary>
  35     <p>Ce module permet aux frontaux d'authentification comme
  36     <module>mod_auth_digest</module> et <module>mod_auth_basic</module>
  37     d'authentifier les utilisateurs en les recherchant dans des fichiers
  38     de mots de passe au format texte. <module>mod_authn_dbm</module>
  39     fournit une fonctionnalit&eacute; similaire.</p>
  40
  41     <p>Lorsqu'on utilise <module>mod_auth_basic</module> ou
  42     <module>mod_auth_digest</module>, ce module peut &ecirc;tre invoqu&eacute; en
  43     affectant la valeur <code>file</code> &agrave; la directive <directive
  44     module="mod_auth_basic">AuthBasicProvider</directive> ou <directive
  45     module="mod_auth_digest">AuthDigestProvider</directive>.</p>
  46 </summary>
  47 <seealso>
  48   <directive module="mod_auth_basic">AuthBasicProvider</directive>
  49 </seealso>
  50 <seealso>
  51   <directive module="mod_auth_digest">AuthDigestProvider</directive>
  52 </seealso>
  53 <seealso><program>htpasswd</program></seealso>
  54 <seealso><program>htdigest</program></seealso>
  55 <seealso><a href="../misc/password_encryptions.html">Formats de mots de
  56 passe</a></seealso>
  57
  58 <directivesynopsis>
  59 <name>AuthUserFile</name>
  60 <description>D&eacute;finit le nom d'un fichier texte pour l'authentification
  61 contenant la liste des utilisateurs et de leurs mots de
  62 passe</description>
  63 <syntax>AuthUserFile <var>chemin-fichier</var></syntax>
  64 <contextlist><context>directory</context><context>.htaccess</context>
  65 </contextlist>
  66 <override>AuthConfig</override>
  67
  68 <usage>
  69     <p>La directive <directive>AuthUserFile</directive> permet de
  70     d&eacute;finir le nom d'un fichier texte pour l'authentification contenant
  71     la liste des utilisateurs et de leurs mots de passe.
  72     <var>chemin-fichier</var> est le chemin vers le fichier
  73     des utilisateurs. S'il n'est pas absolu, il est consid&eacute;r&eacute; comme
  74     relatif au r&eacute;pertoire d&eacute;fini par la directive <directive
  75     module="core">ServerRoot</directive>.</p>
  76
  77     <p>Chaque ligne du fichier des utilisateurs se compose du nom de
  78     l'utilisateur, du caract&egrave;re ':' et du mot de passe chiffr&eacute;. Si le
  79     m&ecirc;me identifiant utilisateur est r&eacute;f&eacute;renc&eacute; plusieurs fois,
  80     <module>mod_authn_file</module> utilisera la premi&egrave;re occurrence pour
  81     v&eacute;rifier le mot de passe.</p>
  82
  83      <p>Le format du mot de passe chiffr&eacute; d&eacute;pend du frontal
  84      d'authentification utilis&eacute; (par exemple
  85      <module>mod_auth_basic</module> ou
  86      <module>mod_auth_digest</module>). Voir la documentation sur les
  87      <a href="../misc/password_encryptions.html">Formats de mots de
  88      passe</a> pour plus de d&eacute;tails.</p>
  89
  90     <p>Pour <module>mod_auth_basic</module>, utilisez le programme
  91     <program>htpasswd</program> fourni avec la distribution binaire,
  92     mais que vous trouverez aussi dans le r&eacute;pertoire
  93     <code>src/support</code> de l'arborescence des sources. Voir sa <a
  94     href="../programs/htpasswd.html">page de manuel</a> pour plus de
  95     d&eacute;tails. En bref :</p>
  96
  97     <p>On cr&eacute;e un fichier de mots de passe <code>nom-fichier</code> avec
  98     <code>nom-utilisateur</code> comme identifiant initial. Le mot de
  99     passe correspondant sera alors demand&eacute; :</p>
 100
 101     <example>
 102       htpasswd -c nom-fichier nom-utilisateur
 103     </example>
 104
 105     <p>Pour ajouter ou modifier <code>nom-utilisateur2</code> dans le
 106     fichier de mots de passe <code>nom-fichier</code> :</p>
 107
 108     <example>
 109       htpasswd nom-fichier nom-utilisateur2
 110     </example>
 111
 112     <p>Noter qu'une recherche dans de grands fichiers texte peut &ecirc;tre
 113     tr&egrave;s longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM
 114     avec la directive <directive
 115     module="mod_authn_dbm">AuthDBMUserFile</directive>.</p>
 116
 117     <p>Pour <module>mod_auth_digest</module>, vous devez utiliser
 118     le programme <program>htdigest</program>.
 119     Notez que vous ne pouvez pas m&eacute;langer des donn&eacute;es utilisateur pour
 120     l'Authentification HTTP &agrave; base de condens&eacute; et des donn&eacute;es pour
 121     l'Authentification de Base dans le m&ecirc;me fichier.</p>
 122
 123     <note type="warning"><title>S&eacute;curit&eacute;</title>
 124       <p>Assurez-vous que le fichier <directive>AuthUserFile</directive>
 125       soit bien stock&eacute; en dehors de l'arborescence des documents du
 126       serveur web. Ne placez <strong>pas</strong> ce fichier dans le
 127       r&eacute;pertoire qu'il prot&egrave;ge. Dans le cas contraire, les clients
 128       seraient en mesure de t&eacute;l&eacute;charger le fichier des mots de passe.</p>
 129     </note>
 130 </usage>
 131 </directivesynopsis>
 132
 133 </modulesynopsis>