2.4.x/docs/manual/mod/mod_authz_dbm.xml.fr - httpd - Git at Google

 <?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_authz_dbm.xml.meta">

 <name>mod_authz_dbm</name>
 <description>Autorisation bas&eacute;e sur les groupes &agrave; l'aide de fichiers
 DBM</description>
 <status>Extension</status>
 <sourcefile>mod_authz_dbm.c</sourcefile>
 <identifier>authz_dbm_module</identifier>
 <compatibility>Disponible depuis les versions 2.1 et sup&eacute;rieures
 d'Apache</compatibility>

 <summary>
     <p>Ce module permet d'autoriser ou d'interdire l'acc&egrave;s &agrave; certaines
     zones du site web aux utilisateurs authentifi&eacute;s en fonction de leur
     appartenance &agrave; un groupe sp&eacute;cifi&eacute;. Le module
     <module>mod_authz_groupfile</module> fournit une fonctionnalit&eacute;
     similaire.</p>
 </summary>

 <seealso><directive module="mod_authz_core">Require</directive></seealso>

 <section id="requiredirectives"><title>The Require Directives</title>

     <p>Les directives <directive
     module="mod_authz_core">Require</directive> d'Apache permettent,
     au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
     est bien autoris&eacute; &agrave; acc&eacute;der &agrave; une ressource.  mod_authz_dbm ajoute
     les types d'autorisation <code>dbm-group</code> et <code>dbm-file-group</code>.</p>

     <p>A partir de la version 2.4.8, les directives require DBM
     supportent les <a href="../expr.html">expressions</a>.</p>

 <section id="reqgroup"><title>Require dbm-group</title>

     <p>Cette directive permet de sp&eacute;cifier &agrave; quel groupe un utilisateur
     doit appartenir pour obtenir l'autorisation d'acc&egrave;s.</p>

     <highlight language="config">
       Require dbm-group admin
     </highlight>

 </section>

 <section id="reqfilegroup"><title>Require dbm-file-group</title>

     <p>Lorsque cette directive est d&eacute;finie, l'utilisateur doit
     appartenir au groupe du fichier pour pouvoir y acc&eacute;der.</p>

     <highlight language="config">
       Require dbm-file-group
     </highlight>

 </section>

 </section>

 <section id="examples">
 <title>Exemple d'utilisation</title>
 <p><em>Notez que si vous utilisez mod_authz_dbm, le mot-cl&eacute; pour les
 groupes d'authentification qui &eacute;tait auparavant <code>group</code> est
 maintenant <code>dbm-group</code> :</em>
 </p>
 <highlight language="config">
 &lt;Directory "/foo/bar"&gt;
   AuthType Basic
   AuthName "Secure Area"
   AuthBasicProvider dbm
   AuthDBMUserFile "site/data/users"
   AuthDBMGroupFile "site/data/users"
   Require dbm-group admin
 &lt;/Directory&gt;
 </highlight>
 </section>

 <directivesynopsis>
 <name>AuthDBMGroupFile</name>
 <description>D&eacute;finit le nom du fichier de base de donn&eacute;es contenant la
 liste des groupes d'utilisateurs permettant de d&eacute;finir les
 autorisations des utilisateurs</description>
 <syntax>AuthDBMGroupFile <var>chemin-fichier</var></syntax>
 <contextlist><context>directory</context><context>.htaccess</context>
 </contextlist>
 <override>AuthConfig</override>

 <usage>
     <p>La directive <directive>AuthDBMGroupFile</directive> sert &agrave;
     d&eacute;finir le nom d'un fichier DBM contenant la liste des groupes
     d'utilisateurs. Les utilisateurs peuvent d&egrave;s lors se voir autoriser ou
     refuser leurs acc&egrave;s selon l'appartenance &agrave; tel ou tel groupe.
     <var>chemin-fichier</var> est le chemin absolu du
     fichier de groupes.</p>

     <p>La cl&eacute; du fichier de groupes est le nom d'utilisateur. La valeur
     de chaque cl&eacute; est la liste des groupes, s&eacute;par&eacute;s par des virgules,
     auxquels l'utilisateur appartient. Cette liste ne doit comporter
     ni espace, ni caract&egrave;re ':'.</p>

     <note type="warning"><title>S&eacute;curit&eacute;</title>
       <p>Le fichier sp&eacute;cifi&eacute; par la directive
 <directive>AuthDBMGroupFile</directive> doit &ecirc;tre situ&eacute; en dehors de
 l'arborescence des documents du serveur web. Ne le placez
 <strong>surtout pas</strong> dans le r&eacute;pertoire qu'il prot&egrave;ge, faute
 de quoi, les clients pourraient le t&eacute;l&eacute;charger, en l'abscence de
 protection suppl&eacute;mentaire.</p>
     </note>

     <p>Utilisation combin&eacute;e de fichiers DBM de groupes et de mots de
     passe : dans certains cas, il est plus simple de g&eacute;rer une seule
     base de donn&eacute;es contenant les groupes et mots de passe de chaque
     utilisateur. L'&eacute;criture de programmes de support en est ainsi
     simplifi&eacute;e car ils n'ont plus qu'un seul fichier DBM &agrave; g&eacute;rer et
     &agrave; verrouiller. Pour ce faire, on attribue le m&ecirc;me nom de fichier
     DBM aux fichiers de groupes et de mots de passe :</p>

     <highlight language="config">
 AuthDBMGroupFile "/www/userbase"
 AuthDBMUserFile "/www/userbase"
     </highlight>

     <p>La cl&eacute; du fichier DBM unique est le nom d'utilisateur. La
     valeur associ&eacute;e &agrave; la cl&eacute; contient :</p>

     <example>
       Mot de passe chiffr&eacute; : Liste de groupes [ : (ignor&eacute;) ]
     </example>

     <p>La partie mot de passe contient comme d'habitude le mot de
     passe chiffr&eacute;. Viennent ensuite le caract&egrave;re ':' et la liste des
     groupes s&eacute;par&eacute;s par des virgules. Il est possible d'ajouter
     d'autres donn&eacute;es en fin de ligne apr&egrave;s un autre caract&egrave;re ':',
     mais elles seront ignor&eacute;es par le module d'autorisation. Il s'agit
     du format utilis&eacute; par www.telescope.org pour sa base de donn&eacute;es
     combin&eacute;e groupes et mots de passe.</p>
 </usage>
 </directivesynopsis>

 <directivesynopsis>
 <name>AuthzDBMType</name>
 <description>D&eacute;finit le type de fichier de base de donn&eacute;es contenant
 la liste des groupes d'utilisateurs</description>
 <syntax>AuthzDBMType default|SDBM|GDBM|NDBM|DB</syntax>
 <default>AuthzDBMType default</default>
 <contextlist><context>directory</context><context>.htaccess</context>
 </contextlist>
 <override>AuthConfig</override>

 <usage>
     <p>D&eacute;finit le type de fichier de base de donn&eacute;es contenant la
     liste des groupes d'utilisateurs. Le type de base de donn&eacute;es par
     d&eacute;faut est d&eacute;termin&eacute; &agrave; la compilation. Les autres types de bases
     de donn&eacute;es disponibles d&eacute;pendent aussi de la
     <a href="../install.html#dbm">configuration de la
     compilation</a>.</p>

     <p>Quel que soit le programme que vous utilisez pour cr&eacute;er votre
     fichier de groupes, il est imp&eacute;ratif que celui-ci soit configur&eacute;
     pour utiliser le m&ecirc;me type de base de donn&eacute;es.</p>
 </usage>
 </directivesynopsis>

 </modulesynopsis>
	<?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_authz_dbm.xml.meta">

	<name>mod_authz_dbm</name>
	<description>Autorisation basée sur les groupes à l'aide de fichiers
	DBM</description>
	<status>Extension</status>
	<sourcefile>mod_authz_dbm.c</sourcefile>
	<identifier>authz_dbm_module</identifier>
	<compatibility>Disponible depuis les versions 2.1 et supérieures
	d'Apache</compatibility>

	<summary>
	<p>Ce module permet d'autoriser ou d'interdire l'accès à certaines
	zones du site web aux utilisateurs authentifiés en fonction de leur
	appartenance à un groupe spécifié. Le module
	<module>mod_authz_groupfile</module> fournit une fonctionnalité
	similaire.</p>
	</summary>

	<seealso><directive module="mod_authz_core">Require</directive></seealso>

	<section id="requiredirectives"><title>The Require Directives</title>

	<p>Les directives <directive
	module="mod_authz_core">Require</directive> d'Apache permettent,
	au cours de la phase d'autorisation, de s'assurer qu'un utilisateur
	est bien autorisé à accéder à une ressource. mod_authz_dbm ajoute
	les types d'autorisation <code>dbm-group</code> et <code>dbm-file-group</code>.</p>

	<p>A partir de la version 2.4.8, les directives require DBM
	supportent les <a href="../expr.html">expressions</a>.</p>

	<section id="reqgroup"><title>Require dbm-group</title>

	<p>Cette directive permet de spécifier à quel groupe un utilisateur
	doit appartenir pour obtenir l'autorisation d'accès.</p>

	<highlight language="config">
	Require dbm-group admin
	</highlight>

	</section>

	<section id="reqfilegroup"><title>Require dbm-file-group</title>

	<p>Lorsque cette directive est définie, l'utilisateur doit
	appartenir au groupe du fichier pour pouvoir y accéder.</p>

	<highlight language="config">
	Require dbm-file-group
	</highlight>

	</section>

	</section>

	<section id="examples">
	<title>Exemple d'utilisation</title>
	<p><em>Notez que si vous utilisez mod_authz_dbm, le mot-clé pour les
	groupes d'authentification qui était auparavant <code>group</code> est
	maintenant <code>dbm-group</code> :</em>
	</p>
	<highlight language="config">
	<Directory "/foo/bar">
	AuthType Basic
	AuthName "Secure Area"
	AuthBasicProvider dbm
	AuthDBMUserFile "site/data/users"
	AuthDBMGroupFile "site/data/users"
	Require dbm-group admin
	</Directory>
	</highlight>
	</section>

	<directivesynopsis>
	<name>AuthDBMGroupFile</name>
	<description>Définit le nom du fichier de base de données contenant la
	liste des groupes d'utilisateurs permettant de définir les
	autorisations des utilisateurs</description>
	<syntax>AuthDBMGroupFile <var>chemin-fichier</var></syntax>
	<contextlist><context>directory</context><context>.htaccess</context>
	</contextlist>
	<override>AuthConfig</override>

	<usage>
	<p>La directive <directive>AuthDBMGroupFile</directive> sert à
	définir le nom d'un fichier DBM contenant la liste des groupes
	d'utilisateurs. Les utilisateurs peuvent dès lors se voir autoriser ou
	refuser leurs accès selon l'appartenance à tel ou tel groupe.
	<var>chemin-fichier</var> est le chemin absolu du
	fichier de groupes.</p>

	<p>La clé du fichier de groupes est le nom d'utilisateur. La valeur
	de chaque clé est la liste des groupes, séparés par des virgules,
	auxquels l'utilisateur appartient. Cette liste ne doit comporter
	ni espace, ni caractère ':'.</p>

	<note type="warning"><title>Sécurité</title>
	<p>Le fichier spécifié par la directive
	<directive>AuthDBMGroupFile</directive> doit être situé en dehors de
	l'arborescence des documents du serveur web. Ne le placez
	<strong>surtout pas</strong> dans le répertoire qu'il protège, faute
	de quoi, les clients pourraient le télécharger, en l'abscence de
	protection supplémentaire.</p>
	</note>

	<p>Utilisation combinée de fichiers DBM de groupes et de mots de
	passe : dans certains cas, il est plus simple de gérer une seule
	base de données contenant les groupes et mots de passe de chaque
	utilisateur. L'écriture de programmes de support en est ainsi
	simplifiée car ils n'ont plus qu'un seul fichier DBM à gérer et
	à verrouiller. Pour ce faire, on attribue le même nom de fichier
	DBM aux fichiers de groupes et de mots de passe :</p>

	<highlight language="config">
	AuthDBMGroupFile "/www/userbase"
	AuthDBMUserFile "/www/userbase"
	</highlight>

	<p>La clé du fichier DBM unique est le nom d'utilisateur. La
	valeur associée à la clé contient :</p>

	<example>
	Mot de passe chiffré : Liste de groupes [ : (ignoré) ]
	</example>

	<p>La partie mot de passe contient comme d'habitude le mot de
	passe chiffré. Viennent ensuite le caractère ':' et la liste des
	groupes séparés par des virgules. Il est possible d'ajouter
	d'autres données en fin de ligne après un autre caractère ':',
	mais elles seront ignorées par le module d'autorisation. Il s'agit
	du format utilisé par www.telescope.org pour sa base de données
	combinée groupes et mots de passe.</p>
	</usage>
	</directivesynopsis>

	<directivesynopsis>
	<name>AuthzDBMType</name>
	<description>Définit le type de fichier de base de données contenant
	la liste des groupes d'utilisateurs</description>
	<syntax>AuthzDBMType default\|SDBM\|GDBM\|NDBM\|DB</syntax>
	<default>AuthzDBMType default</default>
	<contextlist><context>directory</context><context>.htaccess</context>
	</contextlist>
	<override>AuthConfig</override>

	<usage>
	<p>Définit le type de fichier de base de données contenant la
	liste des groupes d'utilisateurs. Le type de base de données par
	défaut est déterminé à la compilation. Les autres types de bases
	de données disponibles dépendent aussi de la
	<a href="../install.html#dbm">configuration de la
	compilation</a>.</p>

	<p>Quel que soit le programme que vous utilisez pour créer votre
	fichier de groupes, il est impératif que celui-ci soit configuré
	pour utiliser le même type de base de données.</p>
	</usage>
	</directivesynopsis>

	</modulesynopsis>