granicus.if.org Git - apache/blob - docs/manual/mod/mod_authz_dbm.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: 1554170:1587032 (outdated) -->
   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_authz_dbm.xml.meta">
  26
  27 <name>mod_authz_dbm</name>
  28 <description>Autorisation par groupes sur base de fichiers DBM</description>
  29 <status>Extension</status>
  30 <sourcefile>mod_authz_dbm.c</sourcefile>
  31 <identifier>authz_dbm_module</identifier>
  32
  33 <summary>
  34     <p>Ce module propose d'autoriser ou d'interdire l'acc&egrave;s &agrave; certaines
  35     zones du site web aux utilisateurs authentifi&eacute;s en fonction de leur
  36     appartenance &agrave; un groupe sp&eacute;cifi&eacute;. Le module
  37     <module>mod_authz_groupfile</module> fournit une fonctionnalit&eacute;
  38     similaire.</p>
  39 </summary>
  40
  41 <seealso><directive module="mod_authz_core">Require</directive></seealso>
  42
  43 <section id="requiredirectives"><title>The Require Directives</title>
  44
  45     <p>Les directives <directive
  46     module="mod_authz_core">Require</directive> d'Apache permettent,
  47     au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
  48     est bien autoris&eacute; &agrave; acc&eacute;der &agrave; une ressource.  mod_authz_dbm ajoute
  49     les types d'autorisation <code>dbm-group</code> et <code>dbm-file-group</code>.</p>
  50
  51     <p>A partir de la version 2.5.0, les directives require DBM
  52     supportent les <a href="../expr.html">expressions</a>.</p>
  53
  54 <section id="reqgroup"><title>Require dbm-group</title>
  55
  56     <p>Cette directive permet de sp&eacute;cifier &agrave; quel groupe un utilisateur
  57     doit appartenir pour obtenir l'autorisation d'acc&egrave;s.</p>
  58
  59     <highlight language="config">
  60       Require dbm-group admin
  61     </highlight>
  62
  63 </section>
  64
  65 <section id="reqfilegroup"><title>Require dbm-file-group</title>
  66
  67     <p>Lorsque cette directive est d&eacute;finie, l'utilisateur doit
  68     appartenir au groupe du fichier pour pouvoir y acc&eacute;der.</p>
  69
  70     <highlight language="config">
  71       Require dbm-file-group
  72     </highlight>
  73
  74 </section>
  75
  76 </section>
  77
  78 <section id="examples">
  79 <title>Exemple d'utilisation</title>
  80 <p><em>Notez que si vous utilisez mod_authz_dbm, le mot-cl&eacute; pour les
  81 groupes d'authentification qui &eacute;tait auparavant <code>group</code> est
  82 maintenant <code>dbm-group</code> :</em>
  83 </p>
  84 <highlight language="config">
  85 &lt;Directory "/foo/bar"&gt;
  86   AuthType Basic
  87   AuthName "Secure Area"
  88   AuthBasicProvider dbm
  89   AuthDBMUserFile site/data/users
  90   AuthDBMGroupFile site/data/users
  91   Require dbm-group admin
  92 &lt;/Directory&gt;
  93 </highlight>
  94 </section>
  95
  96 <directivesynopsis>
  97 <name>AuthDBMGroupFile</name>
  98 <description>D&eacute;finit le nom du fichier de base de donn&eacute;es qui liste
  99 les groupes d'utilisateurs.</description>
 100 <syntax>AuthDBMGroupFile <var>chemin-fichier</var></syntax>
 101 <contextlist><context>directory</context><context>.htaccess</context>
 102 </contextlist>
 103 <override>AuthConfig</override>
 104
 105 <usage>
 106     <p>La directive <directive>AuthDBMGroupFile</directive> d&eacute;finit
 107     le nom d'un fichier DBM contenant la liste des groupes
 108     d'utilisateurs, destin&eacute;s &agrave; la gestion des autorisations.
 109     <var>chemin-fichier</var> est le chemin absolu du
 110     fichier de groupes.</p>
 111
 112     <p>La cl&eacute; du fichier de groupes est le nom d'utilisateur. La valeur
 113     de chaque cl&eacute; est la liste des groupes, s&eacute;par&eacute;s par des virgules,
 114     auxquels l'utilisateur appartient. Cette liste ne doit comporter
 115     ni espace, ni caract&egrave;re ':'.</p>
 116
 117     <note type="warning"><title>S&eacute;curit&eacute;</title>
 118       <p>Le fichier sp&eacute;cifi&eacute; par la directive
 119 <directive>AuthDBMGroupFile</directive> doit &ecirc;tre situ&eacute; en dehors de
 120 l'arborescence des documents du serveur web. Ne le placez
 121 <strong>surtout pas</strong> dans le r&eacute;pertoire qu'il prot&egrave;ge, faute
 122 de quoi, les clients pourraient le t&eacute;l&eacute;charger, en l'abscence de
 123 protection suppl&eacute;mentaire.</p>
 124     </note>
 125
 126     <p>Utilisation combin&eacute;e de fichiers DBM de groupes et de mots de
 127     passe : dans certains cas, il est plus simple de g&eacute;rer une seule
 128     base de donn&eacute;es contenant les groupes et mots de passe de chaque
 129     utilisateur. L'&eacute;criture de programmes de support en est ainsi
 130     simplifi&eacute;e car ils n'ont plus qu'un seul fichier DBM &agrave; g&eacute;rer et
 131     &agrave; verrouiller. Pour ce faire, on attribue le m&ecirc;me nom de fichier
 132     DBM aux fichiers de groupes et de mots de passe :</p>
 133
 134     <highlight language="config">
 135 AuthDBMGroupFile /www/userbase
 136 AuthDBMUserFile /www/userbase
 137     </highlight>
 138
 139     <p>La cl&eacute; du fichier DBM unique est le nom d'utilisateur. La
 140     valeur associ&eacute;e &agrave; la cl&eacute; contient :</p>
 141
 142     <example>
 143       Mot de passe chiffr&eacute; : Liste de groupes [ : (ignor&eacute;) ]
 144     </example>
 145
 146     <p>La partie mot de passe contient comme d'habitude le mot de
 147     passe chiffr&eacute;. Viennent ensuite le caract&egrave;re ':' et la liste des
 148     groupes s&eacute;par&eacute;s par des virgules. Il est possible d'ajouter
 149     d'autres donn&eacute;es en fin de ligne apr&egrave;s un autre caract&egrave;re ':',
 150     mais elles seront ignor&eacute;es par le module d'autorisation. C'est
 151     le format utilis&eacute; par www.telescope.org pour sa base de donn&eacute;es
 152     combin&eacute;e groupes et mots de passe.</p>
 153 </usage>
 154 </directivesynopsis>
 155
 156 <directivesynopsis>
 157 <name>AuthzDBMType</name>
 158 <description>D&eacute;finit le type de fichier de base de donn&eacute;es contenant
 159 la liste des groupes d'utilisateurs</description>
 160 <syntax>AuthzDBMType default|SDBM|GDBM|NDBM|DB</syntax>
 161 <default>AuthzDBMType default</default>
 162 <contextlist><context>directory</context><context>.htaccess</context>
 163 </contextlist>
 164 <override>AuthConfig</override>
 165
 166 <usage>
 167     <p>D&eacute;finit le type de fichier de base de donn&eacute;es contenant la
 168     liste des groupes d'utilisateurs. Le type de base de donn&eacute;es par
 169     d&eacute;faut est d&eacute;termin&eacute; &agrave; la compilation. Les autres types de bases
 170     de donn&eacute;es disponibles d&eacute;pendent aussi de la
 171     <a href="../install.html#dbm">configuration de la
 172     compilation</a>.</p>
 173
 174     <p>Quel que soit le programme que vous utilisez pour cr&eacute;er votre
 175     fichier de groupes, il est imp&eacute;ratif que celui-ci soit configur&eacute;
 176     pour utiliser le m&ecirc;me type de base de donn&eacute;es.</p>
 177 </usage>
 178 </directivesynopsis>
 179
 180 </modulesynopsis>