1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_authz_core - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p> 19<p class="apache">Serveur Apache HTTP Version 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<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.4</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_authz_core</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_authz_core.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_authz_core.html" title="Fran�ais"> fr </a></p> 29</div> 30<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation basique</td></tr> 31<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> 32<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>authz_core_module</td></tr> 33<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_authz_core.c</td></tr> 34<tr><th><a href="module-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3 35d'Apache HTTPD</td></tr></table> 36<h3>Sommaire</h3> 37 38 <p>Ce module fournit des fonctionnalit�s d'autorisation basiques 39 permettant d'accorder ou refuser l'acc�s � certaines zones du site 40 web aux utilisateurs authentifi�s. <code class="module"><a href="/mod/mod_authz_core.html">mod_authz_core</a></code> 41 donne la possibilit� d'enregistrer divers fournisseurs 42 d'autorisation. Il est en g�n�ral utilis� avec un module fournisseur 43 d'authentification comme <code class="module"><a href="/mod/mod_authn_file.html">mod_authn_file</a></code>, et un 44 module d'autorisation comme <code class="module"><a href="/mod/mod_authz_user.html">mod_authz_user</a></code>. Il 45 permet aussi l'application d'une logique �labor�e au d�roulement du 46 processus d'autorisation.</p> 47</div> 48<div id="quickview"><h3 class="directives">Directives</h3> 49<ul id="toc"> 50<li><img alt="" src="/images/down.gif" /> <a href="#authmerging">AuthMerging</a></li> 51<li><img alt="" src="/images/down.gif" /> <a href="#authzprovideralias"><AuthzProviderAlias></a></li> 52<li><img alt="" src="/images/down.gif" /> <a href="#authzsendforbiddenonfailure">AuthzSendForbiddenOnFailure</a></li> 53<li><img alt="" src="/images/down.gif" /> <a href="#require">Require</a></li> 54<li><img alt="" src="/images/down.gif" /> <a href="#requireall"><RequireAll></a></li> 55<li><img alt="" src="/images/down.gif" /> <a href="#requireany"><RequireAny></a></li> 56<li><img alt="" src="/images/down.gif" /> <a href="#requirenone"><RequireNone></a></li> 57</ul> 58<h3>Sujets</h3> 59<ul id="topics"> 60<li><img alt="" src="/images/down.gif" /> <a href="#authzalias">Cr�ation des alias du fournisseur 61d'autorisation</a></li> 62<li><img alt="" src="/images/down.gif" /> <a href="#logic">Conteneurs d'autorisation</a></li> 63<li><img alt="" src="/images/down.gif" /> <a href="#requiredirectives">Les directives Require</a></li> 64</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 65<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 66<div class="section"> 67<h2><a name="authzalias" id="authzalias">Cr�ation des alias du fournisseur 68d'autorisation</a></h2> 69 70 <p>Il est possible de cr�er des fournisseurs d'autorisation �tendus 71 dans le fichier de configuration et de leur assigner un nom d'alias. 72 On peut ensuite utiliser ces fournisseurs alias�s dans une 73 directive <code class="directive"><a href="#require">Require</a></code> de 74 la m�me mani�re qu'on le ferait pour des fournisseurs d'autorisation 75 de base. En plus de la possibilit� de cr�er et d'aliaser un 76 fournisseur �tendu, le m�me fournisseur d'autorisation �tendu peut 77 �tre r�f�renc� par plusieurs localisations. 78 </p> 79 80 <h3><a name="example" id="example">Exemple</a></h3> 81 <p>Dans l'exemple suivant, on cr�e deux alias de fournisseur 82 d'autorisation ldap diff�rents bas�s sur le fournisseur 83 d'autorisation ldap-group. Il est ainsi possible pour un seul 84 r�pertoire de v�rifier l'appartenance � un groupe dans plusieurs 85 serveurs ldap : 86 </p> 87 88 <pre class="prettyprint lang-config"><AuthzProviderAlias ldap-group ldap-group-alias1 cn=my-group,o=ctx> 89 AuthLDAPBindDN cn=youruser,o=ctx 90 AuthLDAPBindPassword yourpassword 91 AuthLDAPURL ldap://ldap.host/o=ctx 92</AuthzProviderAlias> 93 94<AuthzProviderAlias ldap-group ldap-group-alias2 cn=my-other-group,o=dev> 95 AuthLDAPBindDN cn=yourotheruser,o=dev 96 AuthLDAPBindPassword yourotherpassword 97 AuthLDAPURL ldap://other.ldap.host/o=dev?cn 98</AuthzProviderAlias> 99 100Alias /secure /webpages/secure 101<Directory /webpages/secure> 102 Require all granted 103 104 AuthBasicProvider file 105 106 AuthType Basic 107 AuthName LDAP_Protected_Place 108 109 #implied OR operation 110 Require ldap-group-alias1 111 Require ldap-group-alias2 112</Directory></pre> 113 114 115 116</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 117<div class="section"> 118<h2><a name="logic" id="logic">Conteneurs d'autorisation</a></h2> 119 120 <p>Les directives de conteneur d'autorisation <code class="directive"><a href="#requireall"><RequireAll></a></code>, 121 <code class="directive"><a href="#requireany"><RequireAny></a></code> et <code class="directive"><a href="#requirenone"><RequireNone></a></code> 122 peuvent �tre combin�es entre elles et avec la directive <code class="directive"><a href="#require">Require</a></code> pour confectionner une 123 logique d'autorisation complexe.</p> 124 125 <p>L'exemple ci-dessous illustre la logique d'autorisation suivante. 126 Pour pouvoir acc�der � la ressource, l'utilisateur doit �tre 127 l'utilisateur <code>superadmin</code>, ou appartenir aux deux 128 groupes LDAP <code>admins</code> et <code>Administrateurs</code> et 129 soit appartenir au groupe <code>ventes</code> ou avoir 130 <code>ventes</code> comme valeur de l'attribut LDAP 131 <code>dept</code>. De plus, pour pouvoir acc�der � la ressource, 132 l'utilisateur ne doit appartenir ni au groupe <code>temps</code>, ni 133 au groupe LDAP <code>Employ�s temporaires</code>.</p> 134 135 <pre class="prettyprint lang-config"><Directory /www/mydocs> 136 <RequireAll> 137 <RequireAny> 138 Require user superadmin 139 <RequireAll> 140 Require group admins 141 Require ldap-group cn=Administrators,o=Airius 142 <RequireAny> 143 Require group sales 144 Require ldap-attribute dept="sales" 145 </RequireAny> 146 </RequireAll> 147 </RequireAny> 148 <RequireNone> 149 Require group temps 150 Require ldap-group cn=Temporary Employees,o=Airius 151 </RequireNone> 152 </RequireAll> 153</Directory></pre> 154 155</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 156<div class="section"> 157<h2><a name="requiredirectives" id="requiredirectives">Les directives Require</a></h2> 158 159 <p>Le module <code class="module"><a href="/mod/mod_authz_core.html">mod_authz_core</a></code> met � disposition des 160 fournisseurs d'autorisation g�n�riques utilisables avec la directive 161 <code class="directive"><a href="#require">Require</a></code>.</p> 162 163 <h3><a name="reqenv" id="reqenv">Require env</a></h3> 164 165 <p>Le fournisseur <code>env</code> permet de contr�ler l'acc�s au 166 serveur en fonction de l'existence d'une <a href="/env.html">variable d'environnement</a>. Lorsque <code>Require 167 env <var>env-variable</var></code> est sp�cifi�, la requ�te se voit 168 autoriser l'acc�s si la variable d'environnement 169 <var>env-variable</var> existe. Le serveur permet de d�finir 170 facilement des variables d'environnement en fonction des 171 caract�ristiques de la requ�te du client via les directives fournies 172 par le module <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code>. Cette directive Require 173 env permet donc de contr�ler l'acc�s en fonction des 174 valeurs des en-t�tes de la requ�te HTTP tels que 175 <code>User-Agent</code> (type de navigateur), <code>Referer</code>, 176 entre autres.</p> 177 178 <pre class="prettyprint lang-config">SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in 179<Directory /docroot> 180 Require env let_me_in 181</Directory></pre> 182 183 184 <p>Avec cet exemple, les navigateurs dont la cha�ne user-agent 185 commence par <code>KnockKnock/2.0</code> se verront autoriser 186 l'acc�s, alors que tous les autres seront rejet�s.</p> 187 188 <p>Lorsque le serveur cherche un chemin via une <a class="glossarylink" href="/glossary.html#subrequest" title="voir glossaire">sous-requ�te</a> interne (par exemple la 189 recherche d'un <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>), ou lorsqu'il g�n�re un 190 listing du contenu d'un r�pertoire via le module 191 <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code>, la sous-requ�te n'h�rite pas des 192 variables d'environnement sp�cifiques � la requ�te. En outre, � cause 193 des phases de l'API auxquelles <code class="module"><a href="/mod/mod_setenvif.html">mod_setenvif</a></code> prend 194 part, les directives <code class="directive"><a href="/mod/mod_setenvif.html#setenvif">SetEnvIf</a></code> ne sont pas �valu�es 195 s�par�ment dans la sous-requ�te.</p> 196 197 198 199 <h3><a name="reqall" id="reqall">Require all</a></h3> 200 201 <p>Le fournisseur <code>all</code> reproduit la fonctionnalit� 202 pr�c�demment fournie par les directives 'Allow from all' et 'Deny 203 from all'. Il accepte un argument dont les deux valeurs possibles 204 sont : 'granted' ou 'denied'. Les exemples suivants autorisent ou 205 interdisent l'acc�s � toutes les requ�tes.</p> 206 207 <pre class="prettyprint lang-config">Require all granted</pre> 208 209 210 <pre class="prettyprint lang-config">Require all denied</pre> 211 212 213 214 215 <h3><a name="reqmethod" id="reqmethod">Require method</a></h3> 216 217 <p>Le fournisseur <code>method</code> permet d'utiliser la m�thode 218 HTTP dans le processus d'autorisation. Les m�thodes GET et HEAD sont 219 ici consid�r�es comme �quivalentes. La m�thode TRACE n'est pas 220 support�e par ce fournisseur ; utilisez � la place la directive 221 <code class="directive"><a href="/mod/core.html#traceenable">TraceEnable</a></code>.</p> 222 223 <p>Dans l'exemple suivant, seules les m�thodes GET, HEAD, POST, et 224 OPTIONS sont autoris�es :</p> 225 226 <pre class="prettyprint lang-config">Require method GET POST OPTIONS</pre> 227 228 229 <p>Dans l'exemple suivant, les m�thodes GET, HEAD, POST, et OPTIONS 230 sont autoris�es sans authentification, alors que toutes les autres 231 m�thodes n�cessitent un utilisateur valide :</p> 232 233 <pre class="prettyprint lang-config"><RequireAny> 234 �Require method GET POST OPTIONS 235 �Require valid-user 236</RequireAny></pre> 237 238 239 240 <h3><a name="reqexpr" id="reqexpr">Require expr</a></h3> 241 242 <p>Le fournisseur <code>expr</code> permet d'accorder l'autorisation 243 d'acc�s en fonction d'expressions arbitraires.</p> 244 245 <pre class="prettyprint lang-config">Require expr "%{TIME_HOUR} -ge 9 && %{TIME_HOUR} -le 17"</pre> 246 247 248 <p>La syntaxe de l'expression est d�crite dans la documentation de <a href="/expr.html">ap_expr</a>.</p> 249 250 <p>Normalement, l'expression est �valu�e avant l'authentification. 251 Cependant, si l'expression renvoie false et se r�f�re � la variable 252 <code>%{REMOTE_USER}</code>, le processus d'authentification sera 253 engag� et l'expression r��valu�e.</p> 254 255 256 257</div> 258<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 259<div class="directive-section"><h2><a name="AuthMerging" id="AuthMerging">AuthMerging</a> <a name="authmerging" id="authmerging">Directive</a></h2> 260<table class="directive"> 261<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit la mani�re dont chaque logique d'autorisation des 262sections de configuration se combine avec celles des sections de 263configuration pr�c�dentes.</td></tr> 264<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthMerging Off | And | Or</code></td></tr> 265<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AuthMerging Off</code></td></tr> 266<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 267<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 268<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 269<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 270</table> 271 <p>Lorsque l'autorisation est activ�e, elle est normalement h�rit�e 272 par chaque <a href="/sections.html#merging">section de 273 configuration</a> suivante, � moins qu'un jeu de directives 274 d'autorisations diff�rent ne soit sp�cifi�. Il s'agit du 275 comportement par d�faut, qui correspond � la d�finition explicite 276 <code>AuthMerging Off</code>.</p> 277 278 <p>Dans certaines situations cependant, il peut �tre souhaitable de 279 combiner la logique d'autorisation d'une section de configuration 280 avec celle de la section pr�c�dente lorsque les sections de 281 configuration se combinent entre elles. Dans ce cas, deux options 282 sont disponibles, <code>And</code> et <code>Or</code>.</p> 283 284 <p>Lorsqu'une section de configuration contient <code>AuthMerging 285 And</code> ou <code>AuthMerging Or</code>, sa logique d'autorisation 286 se combine avec celle de la section de configuration qui la pr�c�de 287 (selon l'ordre g�n�ral des sections de configuration), et qui 288 contient aussi une logique d'autorisation, comme si les deux 289 sections �taient concat�n�es respectivement dans une directive 290 <code class="directive"><a href="#requireall"><RequireAll></a></code> ou <code class="directive"><a href="#requireany"><RequireAny></a></code>.</p> 291 292 <div class="note">La d�finition de la directive 293 <code class="directive">AuthMerging</code> ne concerne que la section de 294 configuration dans laquelle elle appara�t. Dans l'exemple suivant, 295 seuls les utilisateurs appartenant au groupe <code>alpha</code> sont 296 autoris�s � acc�der � <code>/www/docs</code>. Les utilisateurs 297 appartenant au groupe <code>alpha</code> ou au groupe 298 <code>beta</code> sont autoris�s � acc�der � 299 <code>/www/docs/ab</code>. Cependant, la d�finition implicite � 300 <code>Off</code> de la directive <code class="directive">AuthMerging</code> 301 s'applique � la section de configuration <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> concernant le r�pertoire 302 <code>/www/docs/ab/gamma</code>, ce qui implique que les directives 303 d'autorisation de cette section l'emportent sur celles des sections 304 pr�c�dentes. Par voie de cons�quence, seuls les utilisateurs 305 appartenant au groupe <code>gamma</code> sont autoris�s � acc�der � 306 <code>/www/docs/ab/gamma</code>.</div> 307 308 <pre class="prettyprint lang-config"><Directory /www/docs> 309 AuthType Basic 310 AuthName Documents 311 AuthBasicProvider file 312 AuthUserFile /usr/local/apache/passwd/passwords 313 Require group alpha 314</Directory> 315 316<Directory /www/docs/ab> 317 AuthMerging Or 318 Require group beta 319</Directory> 320 321<Directory /www/docs/ab/gamma> 322 Require group gamma 323</Directory></pre> 324 325 326</div> 327<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 328<div class="directive-section"><h2><a name="AuthzProviderAlias" id="AuthzProviderAlias"><AuthzProviderAlias></a> <a name="authzprovideralias" id="authzprovideralias">Directive</a></h2> 329<table class="directive"> 330<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives repr�sentant une extension d'un 331fournisseur d'autorisation de base qui pourra �tre r�f�renc�e � l'aide 332de l'alias sp�cifi�</td></tr> 333<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthzProviderAlias <var>fournisseur-de-base Alias 334Param�tres-Require</var>> 335... </AuthzProviderAlias> 336</code></td></tr> 337<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr> 338<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 339<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 340</table> 341 <p>Les balises <code class="directive"><AuthzProviderAlias></code> et 342 <code></AuthzProviderAlias></code> permettent de regrouper des 343 directives d'autorisation auxquelles on pourra faire r�f�rence � 344 l'aide de l'alias sp�cifi� dans une directive <code class="directive"><a href="#require">Require</a></code>.</p> 345 346 347</div> 348<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 349<div class="directive-section"><h2><a name="AuthzSendForbiddenOnFailure" id="AuthzSendForbiddenOnFailure">AuthzSendForbiddenOnFailure</a> <a name="authzsendforbiddenonfailure" id="authzsendforbiddenonfailure">Directive</a></h2> 350<table class="directive"> 351<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si 352l'authentification r�ussit et si l'autorisation a �t� refus�e. 353</td></tr> 354<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzSendForbiddenOnFailure On|Off</code></td></tr> 355<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>AuthzSendForbiddenOnFailure Off</code></td></tr> 356<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 357<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 358<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 359<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.11 d'Apache HTTPD</td></tr> 360</table> 361 <p>Par d�faut, si l'authentification r�ussit, alors que 362 l'autorisation est refus�e, Apache HTTPD renvoie un code de r�ponse 363 HTTP '401 UNAUTHORIZED'. En g�n�ral, les navigateurs proposent alors 364 une nouvelle fois � l'utilisateur la bo�te de dialogue de saisie du 365 mot de passe, ce qui n'est pas toujours souhaitable. La directive 366 <code class="directive">AuthzSendForbiddenOnFailure</code> permet de changer 367 le code de r�ponse en '403 FORBIDDEN'.</p> 368 369 <div class="warning"><h3>Avertissement de s�curit�</h3> 370 <p>La modification de la r�ponse en cas de refus d'autorisation 371 diminue la s�curit� du mot de passe, car elle indique � un �ventuel 372 attaquant que le mot de passe qu'il a saisi �tait correct.</p> 373 </div> 374 375</div> 376<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 377<div class="directive-section"><h2><a name="Require" id="Require">Require</a> <a name="require" id="require">Directive</a></h2> 378<table class="directive"> 379<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>V�rifie si un utilisateur authentifi� a une 380autorisation d'acc�s accord�e par un fournisseur 381d'autorisation.</td></tr> 382<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Require [not] <var>nom-entit�</var> [<var>nom-entit�</var>] 383...</code></td></tr> 384<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 385<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 386<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 387<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 388</table> 389 <p>Cette directive permet de v�rifier si un utilisateur authentifi� 390 a l'autorisation d'acc�s accord�e pour un certain fournisseur 391 d'autorisation et en tenant compte de certaines restrictions. 392 <code class="module"><a href="/mod/mod_authz_core.html">mod_authz_core</a></code> met � disposition les fournisseurs 393 d'autorisation g�n�riques suivants :</p> 394 395 <dl> 396 <dt><code>Require all granted</code></dt> 397 <dd>L'acc�s est autoris� sans restriction.</dd> 398 399 <dt><code>Require all denied</code></dt> 400 <dd>L'acc�s est syst�matiquement refus�.</dd> 401 402 <dt><code>Require env <var>env-var</var> [<var>env-var</var>] 403 ...</code></dt> 404 <dd>L'acc�s n'est autoris� que si l'une au moins des variables 405 d'environnement sp�cifi�es est d�finie.</dd> 406 407 <dt><code>Require method <var>http-method</var> [<var>http-method</var>] 408 ...</code></dt> 409 <dd>L'acc�s n'est autoris� que pour les m�thodes HTTP sp�cifi�es.</dd> 410 411 <dt><code>Require expr <var>expression</var> </code></dt> 412 <dd>L'acc�s est autoris� si <var>expression</var> est �valu� � 413 vrai.</dd> 414 </dl> 415 416 <p>Voici quelques exemples de syntaxes autoris�es par 417 <code class="module"><a href="/mod/mod_authz_user.html">mod_authz_user</a></code>, <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> et 418 <code class="module"><a href="/mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> :</p> 419 420 <dl> 421 <dt><code>Require user <var>identifiant utilisateur</var> 422 [<var>identifiant utilisateur</var>] 423 ...</code></dt> 424 <dd>Seuls les utilisateurs sp�cifi�s auront acc�s � la 425 ressource.</dd> 426 427 <dt><code>Require group <var>nom groupe</var> [<var>nom 428 groupe</var>] 429 ...</code></dt> 430 <dd>Seuls les utilisateurs appartenant aux groupes sp�cifi�s 431 auront acc�s � la ressource.</dd> 432 433 <dt><code>Require valid-user</code></dt> 434 <dd>Tous les utilisateurs valides auront acc�s � la 435 ressource.</dd> 436 437 <dt><code>Require ip 10 172.20 192.168.2</code></dt> 438 <dd>Les clients dont les adresses IP font partie des tranches 439 sp�cifi�es auront acc�s � la ressource.</dd> 440 </dl> 441 442 <p>D'autres modules d'autorisation comme 443 <code class="module"><a href="/mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>, <code class="module"><a href="/mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, 444 <code class="module"><a href="/mod/mod_authz_dbd.html">mod_authz_dbd</a></code>, 445 <code class="module"><a href="/mod/mod_authz_owner.html">mod_authz_owner</a></code> et <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> 446 impl�mentent des options de la directive Require.</p> 447 448 <p>Pour qu'une configuration d'authentification et d'autorisation 449 fonctionne correctement, la directive <code class="directive">Require</code> 450 doit �tre accompagn�e dans la plupart des cas de directives <code class="directive"><a href="/mod/mod_authn_core.html#authname">AuthName</a></code>, <code class="directive"><a href="/mod/mod_authn_core.html#authtype">AuthType</a></code> et <code class="directive"><a href="/mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> ou <code class="directive"><a href="/mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>, ainsi que 451 de directives telles que <code class="directive"><a href="/mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> et <code class="directive"><a href="/mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> (pour la 452 d�finition des utilisateurs et des groupes). Exemple :</p> 453 454 <pre class="prettyprint lang-config">AuthType Basic 455AuthName "Restricted Resource" 456AuthBasicProvider file 457AuthUserFile /web/users 458AuthGroupFile /web/groups 459Require group admin</pre> 460 461 462 <p>Les contr�les d'acc�s appliqu�s de cette mani�re sont effectifs 463 pour <strong>toutes</strong> les m�thodes. <strong>C'est d'ailleurs 464 ce que l'on souhaite en g�n�ral.</strong> Si vous voulez n'appliquer 465 les contr�les d'acc�s qu'� certaines m�thodes, tout en laissant les 466 autres m�thodes sans protection, placez la directive 467 <code class="directive">Require</code> dans une section <code class="directive"><a href="/mod/core.html#limit"><Limit></a></code>.</p> 468 469 <p>Le r�sultat de la directive <code class="directive">Require</code> peut 470 �tre invers� en utilisant l'option <code>not</code>. Comme dans le 471 cas de l'autre directive d'autorisation invers�e <code class="directive"><RequireNone></code>, si la directive 472 <code class="directive">Require</code> est invers�e, elle ne peut qu'�chouer 473 ou produire un r�sultat neutre ; elle ne peut donc alors pas 474 autoriser une requ�te de mani�re ind�pendante.</p> 475 476 <p>Dans l'exemple suivant, tous les utilisateurs appartenant aux 477 groupes <code>alpha</code> et <code>beta</code> ont l'autorisation 478 d'acc�s, � l'exception de ceux appartenant au groupe 479 <code>reject</code>.</p> 480 481 <pre class="prettyprint lang-config"><Directory /www/docs> 482 <RequireAll> 483 Require group alpha beta 484 Require not group reject 485 </RequireAll> 486</Directory></pre> 487 488 489 <p>Lorsque plusieurs directives <code class="directive">Require</code> sont 490 plac�es dans une m�me <a href="/sections.html#merging">section de 491 configuration</a>, et ne se trouvent pas dans une autre directive 492 d'autorisation comme <code class="directive"><a href="#requireall"><RequireAll></a></code>, elles sont implicitement 493 contenues dans une directive <code class="directive"><a href="#requireany"><RequireAny></a></code>. Ainsi, la premi�re directive 494 <code class="directive">Require</code> qui autorise l'acc�s � un utilisateur 495 autorise l'acc�s pour l'ensemble de la requ�te, et les directives 496 <code class="directive">Require</code> suivantes sont ignor�es.</p> 497 498 <div class="warning"><h3>Avertissement � propos de la s�curit�</h3> 499 <p>Prettez une attention particuli�re aux directives d'autorisation 500 d�finies 501 au sein des sections <code class="directive"><a href="/mod/core.html#location">Location</a></code> 502 qui se chevauchent avec des contenus servis depuis le syst�me de 503 fichiers. Par d�faut, les configurations d�finies dans ces <a href="/sections.html#merging">sections</a> l'emportent sur les 504 configurations d'autorisations d�finies au sein des sections 505 <code class="directive"><a href="/mod/core.html#directory">Directory</a></code> et <code class="directive"><a href="/mod/core.html#files">Files</a></code> sections.</p> 506 <p>La directive <code class="directive"><a href="#authmerging">AuthMerging</a></code> permet de contr�ler 507 la mani�re selon laquelle les configurations d'autorisations sont 508 fusionn�es au sein des sections pr�cit�es.</p> 509 </div> 510 511<h3>Voir aussi</h3> 512<ul> 513<li><a href="/howto/access.html">Tutoriel du contr�le d'acc�s</a></li> 514<li><a href="#logic">Conteneurs d'autorisation</a></li> 515<li><code class="module"><a href="/mod/mod_authn_core.html">mod_authn_core</a></code></li> 516<li><code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code></li> 517</ul> 518</div> 519<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 520<div class="directive-section"><h2><a name="RequireAll" id="RequireAll"><RequireAll></a> <a name="requireall" id="requireall">Directive</a></h2> 521<table class="directive"> 522<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe plusieurs directives d'autorisation dont aucune ne 523doit �chouer et dont au moins une doit retourner un r�sultat positif 524pour que la directive globale retourne elle-m�me un r�sultat 525positif.</td></tr> 526<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireAll> ... </RequireAll></code></td></tr> 527<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 528<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 529<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 530<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 531</table> 532 <p>Les balises <code class="directive"><RequireAll></code> et 533 <code></RequireAll></code> permettent de regrouper des 534 directives d'autorisation dont aucune ne doit �chouer, et dont au 535 moins une doit retourner un r�sultat positif pour que la directive 536 <code class="directive"><RequireAll></code> retourne elle-m�me 537 un r�sultat positif.</p> 538 539 <p>Si aucune des directives contenues dans la directive <code class="directive"><RequireAll></code> n'�choue, et si au moins une 540 retourne un r�sultat positif, alors la directive <code class="directive"><RequireAll></code> retourne elle-m�me un r�sultat 541 positif. Si aucune ne retourne un r�sultat positif, et si aucune 542 n'�choue, la directive globale retourne un r�sultat neutre. Dans 543 tous les autres cas, elle �choue.</p> 544 545<h3>Voir aussi</h3> 546<ul> 547<li><a href="#logic">Conteneurs d'autorisation</a></li> 548<li><a href="/howto/auth.html">Authentification, autorisation et 549contr�le d'acc�s</a></li> 550</ul> 551</div> 552<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 553<div class="directive-section"><h2><a name="RequireAny" id="RequireAny"><RequireAny></a> <a name="requireany" id="requireany">Directive</a></h2> 554<table class="directive"> 555<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives d'autorisation dont au moins une 556doit retourner un r�sultat positif pour que la directive globale 557retourne elle-m�me un r�sultat positif.</td></tr> 558<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireAny> ... </RequireAny></code></td></tr> 559<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 560<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 561<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 562<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 563</table> 564 <p>Les balises <code class="directive"><RequireAny></code> et 565 <code></RequireAny></code> permettent de regrouper des 566 directives d'autorisation dont au moins une doit retourner un 567 r�sultat positif pour que la directive <code class="directive"><RequireAny></code> retourne elle-m�me un r�sultat 568 positif.</p> 569 570 <p>Si une ou plusieurs directives contenues dans la directive 571 <code class="directive"><RequireAny></code> retournent un 572 r�sultat positif, alors la directive <code class="directive"><RequireAny></code> retourne elle-m�me un r�sultat 573 positif. Si aucune ne retourne un r�sultat positif et aucune 574 n'�choue, la directive globale retourne un r�sultat neutre. Dans 575 tous les autres cas, elle �choue.</p> 576 577 <div class="note">Comme les directives d'autorisation invers�es sont incapables 578 de retourner un r�sultat positif, elles ne peuvent pas impacter de 579 mani�re significative le r�sultat d'une directive <code class="directive"><RequireAny></code> (elles pourraient tout au plus 580 faire �chouer la directive dans le cas o� elles �choueraient 581 elles-m�mes, et o� 582 toutes les autres directives retourneraient un r�sultat neutre). 583 C'est pourquoi il n'est pas permis d'utiliser les directives 584 d'autorisation invers�es dans une directive <code class="directive"><RequireAny></code>.</div> 585 586<h3>Voir aussi</h3> 587<ul> 588<li><a href="#logic">Conteneurs d'autorisation</a></li> 589<li><a href="/howto/auth.html">Authentification, autorisation et 590contr�le d'acc�s</a></li> 591</ul> 592</div> 593<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 594<div class="directive-section"><h2><a name="RequireNone" id="RequireNone"><RequireNone></a> <a name="requirenone" id="requirenone">Directive</a></h2> 595<table class="directive"> 596<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives d'autorisation dont aucune ne doit 597retourner un r�sultat positif pour que la directive globale n'�choue 598pas.</td></tr> 599<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireNone> ... </RequireNone></code></td></tr> 600<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr> 601<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr> 602<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 603<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_authz_core</td></tr> 604</table> 605 <p>Les balises <code class="directive"><RequireNone></code> et 606 <code></RequireNone></code> permettent de regrouper des 607 directives d'autorisation dont aucune ne doit retourner un r�sultat 608 positif pour que la directive <code class="directive"><RequireNone></code> n'�choue pas.</p> 609 610 <p>Si une ou plusieurs directives contenues dans la directive 611 <code class="directive"><RequireNone></code> retournent un 612 r�sultat positif, la directive <code class="directive"><RequireNone></code> �chouera. Dans tous les 613 autres cas, cette derni�re retournera un r�sultat neutre. Ainsi, 614 comme pour la directive d'autorisation invers�e <code>Require 615 not</code>, elle ne peut jamais autoriser une requ�te de mani�re 616 ind�pendante car elle ne pourra jamais retourner un r�sultat 617 positif. Par contre, on peut l'utiliser pour restreindre l'ensemble 618 des utilisateurs autoris�s � acc�der � une ressource.</p> 619 620 <div class="note">Comme les directives d'autorisation invers�es sont incapables 621 de retourner un r�sultat positif, elles ne peuvent pas impacter de 622 mani�re significative le r�sultat d'une directive <code class="directive"><RequireNone></code>. 623 C'est pourquoi il n'est pas permis d'utiliser les directives 624 d'autorisation invers�es dans une directive <code class="directive"><RequireNone></code>.</div> 625 626<h3>Voir aussi</h3> 627<ul> 628<li><a href="#logic">Conteneurs d'autorisation</a></li> 629<li><a href="/howto/auth.html">Authentification, autorisation et 630contr�le d'acc�s</a></li> 631</ul> 632</div> 633</div> 634<div class="bottomlang"> 635<p><span>Langues Disponibles: </span><a href="/en/mod/mod_authz_core.html" hreflang="en" rel="alternate" title="English"> en </a> | 636<a href="/fr/mod/mod_authz_core.html" title="Fran�ais"> fr </a></p> 637</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> 638<script type="text/javascript"><!--//--><![CDATA[//><!-- 639var comments_shortname = 'httpd'; 640var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_authz_core.html'; 641(function(w, d) { 642 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 643 d.write('<div id="comments_thread"><\/div>'); 644 var s = d.createElement('script'); 645 s.type = 'text/javascript'; 646 s.async = true; 647 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 648 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 649 } 650 else { 651 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 652 } 653})(window, document); 654//--><!]]></script></div><div id="footer"> 655<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 656<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 657if (typeof(prettyPrint) !== 'undefined') { 658 prettyPrint(); 659} 660//--><!]]></script> 661</body></html>