mod_access_compat.html.fr revision b43f840409794ed298e8634f6284741f193b6c4f
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_access_compat - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_access_compat</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_access_compat.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="/ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div>
<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
anglaise pour les changements r�cents.</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe � base de nom d'h�te (nom ou
adresse IP)</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>access_compat_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_access_compat.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible dans la version 2.3 du serveur HTTP Apache
� des fins de compatibilit�
avec les pr�c�dentes versions d'Apache httpd 2.x. Les directives fournies par
ce module sont devenues obsol�tes depuis la refonte d'authz. Voir
<h3>Sommaire</h3>
<p>Les directives fournies par le module
<code class="module"><a href="/mod/mod_access_compat.html">mod_access_compat</a></code> s'utilisent dans les sections
de contr�ler l'acc�s � certaines parties du serveur. On peut
contr�ler cet acc�s en fonction du nom d'h�te du client, de son
adresse IP ou d'autres caract�ristiques de la requ�te, telles
qu'elles sont enregistr�es dans les <a href="/env.html">variables
d'environnement</a>. Les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> permettent de sp�cifier
quels clients sont ou ne sont pas autoris�s � acc�der au serveur,
alors que la directive <code class="directive"><a href="#order">Order</a></code> d�finit le statut
d'acc�s par d�faut, et d�termine la mani�re dont les directives
<code class="directive"><a href="#allow">Allow</a></code> et
<code class="directive"><a href="#deny">Deny</a></code> interagissent
entre elles.</p>
<p>Les restrictions d'acc�s � base de nom d'h�te et
l'authentification � base de mot de passe peuvent �tre impl�ment�es
simultan�ment. Dans ce cas, on utilise la directive <code class="directive"><a href="#satisfy">Satisfy</a></code> pour d�terminer la
mani�re dont ces deux modes de restrictions interagissent.</p>
<div class="warning"><h3>Note</h3>
<p>Les directives fournies par le module
<code class="module"><a href="/mod/mod_access_compat.html">mod_access_compat</a></code> sont devenues obsol�tes depuis
la refonte d'authz. Voir <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code>.</p>
</div>
<p>En g�n�ral, les directives de restriction d'acc�s s'appliquent �
toutes les m�thodes d'acc�s (<code>GET</code>, <code>PUT</code>,
<code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite
dans la plupart des cas. Il est cependant possible de restreindre
certaines m�thodes, alors que les autres m�thodes ne se verront
impos�e aucune restriction, en regroupant les directives �
l'int�rieur d'une section <code class="directive"><a href="/mod/core.html#limit"><Limit></a></code>.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
</ul>
<h3>Voir aussi</h3>
<ul class="seealso">
</ul></div>
<div class="directive-section"><h2><a name="Allow" id="Allow">Allow</a> <a name="allow" id="allow">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sp�cifie quels h�tes peuvent acc�der � une certaine zone du
serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Allow from all|<var>h�te</var>|env=[!]<var>variable
d'environnement</var>
[<var>h�te</var>|env=[!]<var>variable d'environnement</var>] ...</code></td></tr>
</table>
<p>La directive <code class="directive">Allow</code> permet de d�finir quels
h�tes ont le droit d'acc�der � une certaine partie du serveur. On
peut contr�ler l'acc�s par nom d'h�te, adresse IP, intervalle
d'adresses IP, ou toute autre caract�ristique de la requ�te client
enregistr�e dans les variables d'environnement.</p>
<p>Le premier argument de cette directive est toujours
<code>from</code>. Les arguments suivants peuvent prendre trois
formes diff�rentes. Si <code>Allow from all</code> est sp�cifi�,
tout h�te se voit accord� l'acc�s, en tenant compte des directives
<code class="directive"><a href="#deny">Deny</a></code> et <code class="directive"><a href="#order">Order</a></code> comme d�crit plus loin.
Pour ne permettre l'acc�s au serveur qu'� un h�te ou un groupe
d'h�tes particuliers, on peut sp�cifier un <em>nom d'h�te</em> sous
une des formes suivantes :</p>
<dl>
<dt>Un nom de domaine (partiel)</dt>
<dd>
<div class="example"><h3>Exemple :</h3><p><code>
Allow from example.org<br />
Allow from .net example.edu
</code></p></div>
<p>Les h�tes dont les noms correspondent ou se terminent par la
cha�ne sp�cifi�e ont l'autorisation d'acc�s. Seules les
composantes enti�res du nom d'h�te doivent correspondre ; ainsi,
Avec cette configuration, Apache httpd va effectuer une double recherche
DNS sur l'adresse IP du client, sans tenir compte de la
d�finition de la directive <code class="directive"><a href="/mod/core.html#hostnamelookups">HostnameLookups</a></code>. Tout d'abord, une
recherche DNS inverse sur l'adresse IP est effectu�e pour
d�terminer le nom d'h�te associ�, puis une recherche directe sur
le nom d'h�te est effectu�e afin de s'assurer qu'il correspond
bien � l'adresse IP originale. L'acc�s ne sera accord� que si le
nom d'h�te correspond et si les recherches DNS inverse et directe
concordent.</p></dd>
<dt>Une adresse IP compl�te</dt>
<dd>
<div class="example"><h3>Exemple :</h3><p><code>
Allow from 10.1.2.3<br />
Allow from 192.168.1.104 192.168.1.205
</code></p></div>
<p>L'adresse IP d'un h�te auquel on a accord� l'acc�s</p></dd>
<dt>Une adresse IP partielle</dt>
<dd>
<div class="example"><h3>Exemple :</h3><p><code>
Allow from 10.1<br />
Allow from 10 172.20 192.168.2
</code></p></div>
<p>De un � trois des premiers octets d'une adresse IP, afin de
restreindre l'acc�s � un sous-r�seau.</p></dd>
<dd>
<div class="example"><h3>Exemple :</h3><p><code>
Allow from 10.1.0.0/255.255.0.0
</code></p></div>
une d�finition plus pr�cise de la restriction d'acc�s impos�e � un
sous-r�seau.</p></dd>
<dd>
<div class="example"><h3>Exemple :</h3><p><code>
</code></p></div>
<p>Identique au cas pr�c�dent, mis � part que le masque est
constitu� des nnn bits de poids fort.</p></dd>
</dl>
<p>Notez que les trois derniers exemples d�signent le m�me ensemble
d'h�tes.</p>
<p>On peut sp�cifier des adresses et sous-r�seaux IPv6 de la mani�re
suivante :</p>
<div class="example"><p><code>
Allow from 2001:db8::a00:20ff:fea7:ccea<br />
</code></p></div>
<p>Le troisi�me format d'argument de la directive
<code class="directive">Allow</code> permet de contr�ler l'acc�s au serveur
en fonction de l'existence d'une <a href="/env.html">variable d'environnement</a>. Lorsque <code>Allow
from env=<var>variable d'environnement</var></code> est sp�cifi�, la
requ�te est autoris�e si la variable d'environnement <var>variable
d'environnement</var> existe. En revanche, lorsque <code>Allow from
env=!<var>env-variable</var></code> est sp�cifi�, la
requ�te est autoris�e si la variable d'environnement <var>variable
d'environnement</var> n'existe pas. Le serveur permet de d�finir
avec souplesse des variables d'environnement en se basant sur les
caract�ristiques de la requ�te client et en utilisant les directives
fournies par le module <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code>. Ainsi, on peut
utiliser la directive <code class="directive">Allow</code> pour permettre
l'acc�s en fonction de param�tres comme le <code>User-Agent</code>
(type de navigateur) des clients, le <code>Referer</code>, ou
d'autres champs d'en-t�te de la requ�te HTTP.</p>
<div class="example"><h3>Exemple :</h3><p><code>
SetEnvIf User-Agent ^KnockKnock/2\.0 laissez_moi_entrer<br />
<Directory /docroot><br />
<span class="indent">
Order Deny,Allow<br />
Deny from all<br />
Allow from env=laissez_moi_entrer<br />
</span>
</Directory>
</code></p></div>
<p>Dans cet exemple, les navigateurs dont la cha�ne user-agent
l'acc�s, alors que tous les autres seront rejet�s.</p>
</div>
<div class="directive-section"><h2><a name="Deny" id="Deny">Deny</a> <a name="deny" id="deny">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit quels h�tes ne sont pas autoris�s � acc�der au
serveur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Deny from all|<var>h�te</var>|env=[!]<var>variable
d'environnement</var>
[<var>h�te</var>|env=[!]<var>variable d'environnement</var>] ...</code></td></tr>
</table>
<p>Cette directive permet de restreindre l'acc�s au serveur en
fonction du nom d'h�te, de l'adresse IP ou de variables
d'environnement. Les arguments de la directive
<code class="directive">Deny</code> sont identiques aux arguments de la
directive <code class="directive"><a href="#allow">Allow</a></code>.</p>
</div>
<div class="directive-section"><h2><a name="Order" id="Order">Order</a> <a name="order" id="order">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le statut d'acc�s par d�faut et l'ordre dans lequel
les directives <code class="directive">Allow</code> et
<code class="directive">Deny</code> sont �valu�es.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> Order <var>ordre</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Order Deny,Allow</code></td></tr>
</table>
<p>La directive <code class="directive">Order</code>, associ�e aux
directives <code class="directive"><a href="#allow">Allow</a></code>
et <code class="directive"><a href="#deny">Deny</a></code>,
impl�mente un syst�me de contr�le d'acc�s en trois passes. Au cours
de la premi�re passe, ce sont soit toutes les directives <code class="directive"><a href="#allow">Allow</a></code>, soit toutes les
directives <code class="directive"><a href="#deny">Deny</a></code> qui sont trait�es, selon
la d�finition de la directive <code class="directive"><a href="#order">Order</a></code>. Le reste des
directives (<code class="directive"><a href="#deny">Deny</a></code>
ou <code class="directive"><a href="#allow">Allow</a></code>) est
trait� au cours de la seconde passe. La troisi�me passe s'applique �
toutes les requ�tes qui ne sont concern�es par aucune des deux
premi�res passes.</p>
<p>Notez que toutes les directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> sont trait�es, � la
diff�rence d'un pare-feu classique o� seule la premi�re r�gle qui
correspond est utilis�e. La derni�re directive qui correspond
s'applique ( � la diff�rence l� encore d'un pare-feu classique). De
plus, l'ordre dans lequel les lignes apparaissent dans le fichier de
configuration n'a pas d'incidence -- toutes les lignes <code class="directive"><a href="#allow">Allow</a></code> sont consid�r�es comme
un groupe, toutes les lignes <code class="directive"><a href="#deny">Deny</a></code> comme un autre, et le
statut par d�faut a son existence propre.</p>
<p><em>Ordre</em> peut �tre :</p>
<dl>
<dt><code>Allow,Deny</code></dt>
<dd>Dans un premier temps, toutes les directives <code class="directive"><a href="#allow">Allow</a></code> sont �valu�es ; au
moins une d'entre elles doit correspondre, sinon la requ�te est
rejet�e. Ensuite, toutes les directives <code class="directive"><a href="#deny">Deny</a></code> sont �valu�es. Si au
moins l'une d'entre elles correspond, la requ�te est rejet�e.
Enfin, toute requ�te qui ne correspond � aucune directive
<code class="directive"><a href="#allow">Allow</a></code> ou
<code class="directive"><a href="#deny">Deny</a></code> est rejet�e
par d�faut.</dd>
<dt><code>Deny,Allow</code></dt>
<dd>Dans un premier temps, toutes les directives <code class="directive"><a href="#deny">Deny</a></code> sont �valu�es ; Si au
moins une d'entre elles correspond, la requ�te est rejet�e,
<strong>� moins</strong> qu'elle corresponde aussi � une directive
<code class="directive"><a href="#allow">Allow</a></code>. Toute
requ�te qui ne correspond � aucune directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> est autoris�e.</dd>
<dt><code>Mutual-failure</code></dt>
<dd>Cet argument a le m�me effet que <code>Allow,Deny</code> et
est devenu de ce fait obsol�te.</dd>
</dl>
<p>Les mots-cl�s ne peuvent �tre s�par�s que par des virgules ;
<em>aucun espace</em> ne doit s'intercaler entre eux.</p>
<table class="bordered">
<tr>
<th>Match</th>
<th>R�sultat Allow,Deny</th>
<th>R�sultat Deny,Allow</th>
</tr><tr>
<th>Correspond � Allow seulement</th>
<td>Requ�te autoris�e</td>
<td>Requ�te autoris�e</td>
</tr><tr>
<th>Correspond � Deny seulement</th>
<td>Requ�te rejet�e</td>
<td>Requ�te rejet�e</td>
</tr><tr>
<th>Aucune correspondance</th>
<td>Par d�faut la seconde directive : rejet</td>
<td>Par d�faut la seconde directive : autorisation</td>
</tr><tr>
<th>Correspond � Allow & Deny</th>
<td>La derni�re correspondance l'emporte : rejet</td>
<td>La derni�re correspondance l'emporte : autorisation</td>
</tr>
</table>
<p>Dans cet exemple, tous les h�tes du domaine example.org ont
l'autorisation d'acc�s ; tous les autres voient leur acc�s
refus�.</p>
<div class="example"><p><code>
Order Deny,Allow<br />
Deny from all<br />
Allow from example.org
</code></p></div>
<p>Dans l'exemple suivant, tous les h�tes du domaine example.org ont
l'autorisation d'acc�s, sauf ceux du sous-domaine foo.example.org qui
voient leur acc�s refus�. Tous les h�tes qui ne sont pas dans le
domaine example.org sont rejet�s car le statut par d�faut est positionn�
sur <code class="directive"><a href="#deny">Deny</a></code>, et consiste donc en un
refus d'acc�s.</p>
<div class="example"><p><code>
Order Allow,Deny<br />
Allow from example.org<br />
Deny from foo.example.org
</code></p></div>
<p>Par contre, si la valeur de la directive
<code class="directive">Order</code>, dans l'exemple pr�c�dent, est
<code>Deny,Allow</code>, tout le monde a l'autorisation d'acc�s.
�valu� en dernier, sans tenir compte de l'ordre r�el dans lequel les
directives apparaissent dans le fichier de configuration, et va
l'autorisation d'acc�s car le statut par d�faut est positionn� sur
<code class="directive"><a href="#allow">Allow</a></code> et constitue donc une
autorisation d'acc�s.</p>
<p>La pr�sence d'une directive <code class="directive">Order</code> peut
affecter le contr�le d'acc�s � une partie du serveur m�me en
l'abscence de directives <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="#deny">Deny</a></code> associ�es, � cause de
son influence sur le statut par d�faut. Par exemple,</p>
<div class="example"><p><code>
<Directory /www><br />
<span class="indent">
Order Allow,Deny<br />
</span>
</Directory>
</code></p></div>
<p>va interdire tout acc�s au r�pertoire <code>/www</code> � cause
du statut d'acc�s par d�faut qui est d�fini � <code class="directive"><a href="#deny">Deny</a></code>.</p>
<p>La directive <code class="directive">Order</code> ne contr�le l'ordre
dans lequel sont trait�es les directives d'acc�s qu'au cours de
chaque phase du traitement de la configuration du serveur. Ceci
implique, par exemple, qu'une directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> situ�e dans une section
toujours �valu�e apr�s une directive <code class="directive"><a href="#allow">Allow</a></code> ou <code class="directive"><a href="#deny">Deny</a></code> situ�e dans une section
fichier <code>.htaccess</code>, sans tenir compte de la
d�finition de la directive <code class="directive">Order</code>. Pour plus
de d�tails � propos de la fusion des sections de configuration, voir
le document <a href="/sections.html">Comment fonctionnent les sections Directory,
Location et Files</a>.</p>
</div>
<div class="directive-section"><h2><a name="Satisfy" id="Satisfy">Satisfy</a> <a name="satisfy" id="satisfy">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interaction entre le contr�le d'acc�s en fonction de l'h�te
et l'authentification utilisateur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Satisfy Any|All</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Satisfy All</code></td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Affect� par <code class="directive"><a href="/mod/core.html#limit"><Limit></a></code> et <code class="directive"><a href="/mod/core.html#limitexcept"><LimitExcept></a></code> � partir de la version
2.0.51</td></tr>
</table>
<p>Politique d'acc�s dans le cas o� on utilise � la fois <code class="directive"><a href="#allow">Allow</a></code> et <code class="directive"><a href="/mod/mod_authz_core.html#require">Require</a></code>. L'argument est soit
<code>All</code>, soit <code>Any</code>. L'utilisation de cette
directive n'a de sens que si l'acc�s � une zone particuli�re du
serveur est restreinte par utilisateur/mot de passe et en fonction
de l'adresse IP de l'h�te client. Dans ce cas, par
d�faut (<code>All</code>), le client doit satisfaire � la
restriction d'adresse, <em>et</em> fournir un couple
le client se verra accorder l'acc�s s'il satisfait � la restriction
d'adresse ou fournit un couple utilisateur/mot de passe valide. On
peut utiliser cette derni�re d�finition pour restreindre l'acc�s �
une zone par mot de passe, mais accorder l'acc�s aux clients
poss�dant certaines adresses IP sans qu'ils aient � fournir de mot
de passe.</p>
<p>Par exemple, si vous souhaitez que les utilisateurs de votre
r�seau acc�dent � une zone de votre site web sans restriction, mais
que l'acc�s � cette zone n�cessite un mot de passe pour les autres
utilisateurs, vous pouvez utiliser une configuration du style :</p>
<div class="example"><p><code>
Require valid-user<br />
Allow from 192.168.1<br />
Satisfy Any
</code></p></div>
<p>
Une autre utilisation fr�quente de la directive
<code class="directive">Satisfy</code> est l'all�gement des restrictions
d'acc�s � un sous-r�pertoire par rapport aux restrictions d'acc�s au
r�pertoire parent :
</p>
<div class="example"><p><code>
Require valid-user<br />
</Directory><br />
<br />
Allow from all<br />
Satisfy Any<br />
</Directory>
</code></p></div>
<p>Dans l'exemple ci-dessus, l'acc�s au r�pertoire
sera accord� sans restriction.</p>
<p>Depuis la version 2.0.51, les directives
<code class="directive">Satisfy</code> peuvent �tre restreintes � certaines
m�thodes particuli�res � l'aide des sections <code class="directive"><a href="/mod/core.html#limit"><Limit></a></code> et <code class="directive"><a href="/mod/core.html#limitexcept"><LimitExcept></a></code>.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#allow">Allow</a></code></li>
</ul>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_access_compat.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="/ja/mod/mod_access_compat.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
</div><div id="footer">
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>