blob: 7778b5419ad59794faaf7f26e502127046f402a3 [file] [log] [blame]
<?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_owner.xml.meta">
<name>mod_authz_owner</name>
<description>Autorisation bas&eacute;e sur l'appartenance des
fichiers</description>
<status>Extension</status>
<sourcefile>mod_authz_owner.c</sourcefile>
<identifier>authz_owner_module</identifier>
<compatibility>Disponible depuis les versions 2.1 et sup&eacute;rieures
d'Apache</compatibility>
<summary>
<p>Ce module permet de contr&ocirc;ler l'acc&egrave;s aux fichiers en comparant
l'identifiant utilisateur ayant servi &agrave; l'authentification HTTP
(l'identifiant utilisateur web) avec le propri&eacute;taire ou le groupe
du fichier demand&eacute; du point de vue du syst&egrave;me de fichiers. Le nom
d'utilisateur et le mot de passe doivent d&eacute;j&agrave; avoir &eacute;t&eacute; v&eacute;rifi&eacute;s par
un module d'authentification comme <module>mod_auth_basic</module>
ou <module>mod_auth_digest</module>.
<module>mod_authz_owner</module> reconna&icirc;t deux arguments pour la
directive <directive module="core">Require</directive> :
<code>file-owner</code> et <code>file-group</code> :</p>
<dl>
<dt><code>file-owner</code></dt>
<dd>Le nom d'utilisateur web utilis&eacute; pour l'authentification doit
correspondre au nom syst&egrave;me du propri&eacute;taire du fichier demand&eacute;. En
d'autres termes, si le syst&egrave;me indique <code>jones</code> comme
propri&eacute;taire du fichier demand&eacute;, le nom d'utilisateur fourni pour
l'authentification HTTP doit aussi &ecirc;tre <code>jones</code>.</dd>
<dt><code>file-group</code></dt>
<dd>Le nom du groupe syst&egrave;me du fichier demand&eacute; doit &ecirc;tre pr&eacute;sent
dans une base de donn&eacute;es de groupes fournie, par exemple, par
<module>mod_authz_groupfile</module> ou
<module>mod_authz_dbm</module>, et le nom d'utilisateur web fourni
pour l'authentification doit &ecirc;tre un membre de ce groupe. Par
exemple, si le syst&egrave;me indique que le groupe (syst&egrave;me) du fichier
demand&eacute; est <code>accounts</code>, le groupe <code>accounts</code>
doit appara&icirc;tre dans la base de donn&eacute;es des groupes, et le nom
d'utilisateur web utilis&eacute; pour l'authentification doit &ecirc;tre un
membre de ce groupe.</dd>
</dl>
<note><title>Note</title>
<p>Si le module <module>mod_authz_owner</module> est utilis&eacute; pour
v&eacute;rifier l'autorisation d'acc&egrave;s &agrave; une ressource qui n'est pas
vraiment pr&eacute;sente dans le syst&egrave;me de fichiers (en d'autres termes
une ressource virtuelle), il refusera l'acc&egrave;s.</p>
<p>En particulier, il n'accordera jamais l'acc&egrave;s &agrave; une ressource
du type <a href="../content-negotiation.html#multiviews">"Vues
multiples" (MultiViews) d'un contenu n&eacute;goci&eacute;</a>.</p>
</note>
</summary>
<seealso><directive module="mod_authz_core">Require</directive></seealso>
<section id="examples"><title>Exemples de configuration</title>
<section id="examples.file-owner"><title>Require file-owner</title>
<p>Consid&eacute;rons un serveur Web Apache fonctionnant sous un syst&egrave;me
multi-utilisateurs, o&ugrave; les fichiers de chaque utilisateur sont
stock&eacute;s dans <code>~/public_html/private</code>. En supposant
qu'il n'existe qu'une seule base de donn&eacute;es contenant les noms
d'utilisateurs web, et que ces noms d'utilisateurs correspondent
aux noms d'utilisateurs syst&egrave;me qui sont les propri&eacute;taires
effectifs des fichiers, la configuration de l'exemple suivant
n'accordera l'autorisation d'acc&egrave;s aux fichiers qu'&agrave; leur
propri&eacute;taire. L'utilisateur <code>jones</code> ne sera pas
autoris&eacute; &agrave; acc&eacute;der aux fichiers situ&eacute;s dans
<code>/home/smith/public_html/private</code>, &agrave; moins que leur
propri&eacute;taire ne soit <code>jones</code> au lieu de
<code>smith</code>.</p>
<highlight language="config">
&lt;Directory "/home/*/public_html/private"&gt;
AuthType Basic
AuthName MyPrivateFiles
AuthBasicProvider dbm
AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all"
Require file-owner
&lt;/Directory&gt;
</highlight>
</section>
<section id="examples.file-group"><title>Require file-group</title>
<p>Consid&eacute;rons un syst&egrave;me similaire &agrave; celui d&eacute;crit ci-dessus, mais
o&ugrave; certains utilisateurs partagent leurs fichiers de projets dans
<code>~/public_html/project-foo</code>. Le groupe syst&egrave;me des
fichiers est <code>foo</code>, et il n'existe qu'une seule base de
donn&eacute;es <directive
module="mod_authz_dbm">AuthDBMGroupFile</directive> qui contient
tous les noms d'utilisateurs web et leurs groupes d'appartenance.
Ces noms d'utilisateurs web doivent alors appartenir au moins au
groupe <code>foo</code>. En d'autres termes, si <code>jones</code>
et <code>smith</code> sont tous deux membres du groupe
<code>foo</code>, ils seront autoris&eacute;s &agrave; acc&eacute;der aux
r&eacute;pertoires <code>project-foo</code> de chacun d'entre eux.</p>
<highlight language="config">
&lt;Directory "/home/*/public_html/project-foo"&gt;
AuthType Basic
AuthName "Project Foo Files"
AuthBasicProvider dbm
# combined user/group database
AuthDBMUserFile "/usr/local/apache2/etc/.htdbm-all"
AuthDBMGroupFile "/usr/local/apache2/etc/.htdbm-all"
Satisfy All
Require file-group
&lt;/Directory&gt;
</highlight>
</section>
</section>
</modulesynopsis>