af4ffe1001adcc0a96897e426d26444f07af9aa1Benjamin Franzke<?xml version="1.0"?>

af4ffe1001adcc0a96897e426d26444f07af9aa1Benjamin Franzke<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

af4ffe1001adcc0a96897e426d26444f07af9aa1Benjamin Franzke<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>

af4ffe1001adcc0a96897e426d26444f07af9aa1Benjamin Franzke

af4ffe1001adcc0a96897e426d26444f07af9aa1Benjamin Franzke

<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>

<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>