granicus.if.org Git - apache/blob - docs/manual/mod/mod_authz_host.html.fr

   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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_authz_host - Serveur Apache HTTP Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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>
  21 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Module Apache mod_authz_host</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_authz_host.html" title="Français">&nbsp;fr&nbsp;</a></p>
  31 </div>
  32 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe basées sur l'hôte (nom ou adresse
  33 IP)</td></tr>
  34 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
  35 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>authz_host_module</td></tr>
  36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_host.c</td></tr>
  37 <tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Le fournisseur <code>forward-dns</code> est disponible à partir
  38 de la version 2.4.19 du serveur HTTP Apache</td></tr></table>
  39 <h3>Sommaire</h3>
  40
  41     <p>Les fournisseurs d'autorisation implémentés par le module
  42     <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> sont enregistrés à l'aide de
  43     la directive <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code>. On peut
  44     utiliser cette directive à l'intérieur de sections <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>, ou <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> ou de fichiers
  45     <code><a href="core.html#accessfilename">.htaccess</a> </code> pour
  46     contrôler l'accès à certaines zones du serveur. Le contrôle d'accès
  47     peut être effectué en fonction du nom d'hôte ou de l'adresse IP.</p>
  48
  49     <p>En général, les directives de restriction d'accès s'appliquent à
  50     toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>,
  51     <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite
  52     dans la plupart des cas. Il est cependant possible de ne restreindre
  53     l'accès que pour certaines méthodes, tout en laissant les autres
  54     méthodes sans protection, en plaçant les directives dans une section
  55     <code class="directive"><a href="../mod/core.html#limit">&lt;Limit&gt;</a></code>.</p>
  56 </div>
  57 <div id="quickview"><h3>Sujets</h3>
  58 <ul id="topics">
  59 <li><img alt="" src="../images/down.gif" /> <a href="#requiredirectives">Les directives Require</a></li>
  60 </ul><h3 class="directives">Directives</h3>
  61 <p>Ce module ne fournit aucune directive.</p>
  62 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_authz_host">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_authz_host">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
  63 <ul class="seealso">
  64 <li><a href="../howto/auth.html">Authentification, autorisation et
  65 contrôle d'accès</a></li>
  66 <li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li>
  67 <li><a href="#comments_section">Commentaires</a></li></ul></div>
  68 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  69 <div class="section">
  70 <h2><a name="requiredirectives" id="requiredirectives">Les directives Require</a><a title="Lien permanent" href="#requiredirectives" class="permalink">&para;</a></h2>
  71
  72     <p>La directive Apache <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> est utilisée au cours de
  73     la phase d'autorisation pour vérifier si un utilisateur se voit
  74     accorder ou refuser l'accès à une ressource. mod_authz_host fournit
  75     les types d'autorisation <code>ip</code>, <code>host</code>,
  76     <code>forward-dns</code> et <code>local</code>. D'autres
  77     types d'autorisation sont aussi disponibles, mais nécessitent le chargement
  78     des modules d'autorisation appropriés.</p>
  79
  80     <p>Ces fournisseurs d'autorisation permettent de déterminer quels
  81     hôtes peuvent accéder à une zone du serveur. On peut contrôler
  82     l'accès en fonction du nom d'hôte, de l'adresse IP, ou d'un intervalle
  83     d'adresses IP.</p>
  84
  85     <p>A partir de la version 2.4.8, les directives require host
  86     supportent les <a href="../expr.html">expressions</a>.</p>
  87
  88 <h3><a name="reqip" id="reqip">Require ip</a></h3>
  89
  90     <p>Le fournisseur <code>ip</code> permet de contrôler l'accès au
  91     serveur en fonction de l'adresse IP du client distant. Lorsque
  92     <code>Require ip <var>adresse-ip</var></code> est spécifié, la
  93     requête est autorisée si l'adresse IP du client distant correspond
  94     à</p>
  95
  96     <p>Une adresse IP complète :</p>
  97
  98     <pre class="prettyprint lang-config">Require ip 10.1.2.3
  99 Require ip 192.168.1.104 192.168.1.205</pre>
 100
 101
 102     <p>L'adresse IP d'un hôte pour qui l'accès est accordé</p>
 103
 104     <p>Une adresse IP partielle :</p>
 105
 106     <pre class="prettyprint lang-config">Require ip 10.1
 107 Require ip 10 172.20 192.168.2</pre>
 108
 109     <p>Les 1 à 3 premiers octets d'une adresse IP, pour une restriction
 110     à un sous-réseau.</p>
 111
 112     <p>Une paire réseau/masque de sous-réseau :</p>
 113
 114     <pre class="prettyprint lang-config">Require ip 10.1.0.0/255.255.0.0</pre>
 115
 116     <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une
 117     restriction de sous-réseau plus fine.</p>
 118
 119     <p>Une spécification CIDR réseau/nnn :</p>
 120
 121     <pre class="prettyprint lang-config">Require ip 10.1.0.0/16</pre>
 122
 123     <p>Identique au cas précédent, excepté que le masque de sous-réseau
 124     représente les nnn premiers bits de poids fort.</p>
 125
 126     <p>Notez que les trois derniers exemples correspondent exectement au
 127     même ensemble d'hôtes.</p>
 128
 129     <p>On peut spécifier des adresses et des sous-réseaux IPv6 comme
 130     suit :</p>
 131
 132     <pre class="prettyprint lang-config">Require ip 2001:db8::a00:20ff:fea7:ccea
 133 Require ip 2001:db8:1:1::a
 134 Require ip 2001:db8:2:1::/64
 135 Require ip 2001:db8:3::/48</pre>
 136
 137
 138     <p>Note: comme les adresses IP sont lues au démarrage, les
 139     expressions ne sont pas évaluées au moment de la requête.</p>
 140
 141
 142
 143 <h3><a name="reqhost" id="reqhost">Require host</a></h3>
 144
 145     <p>Le fournisseur <code>host</code> permet de contrôler l'accès au
 146     serveur en fonction du nom d'hôte du client distant. Lorsque
 147     <code>Require host <var>nom-hôte</var></code> est spécifié, la
 148     requête est autorisée si le nom d'hôte correspond à</p>
 149
 150     <p>Un nom de domaine (éventuellement partiel)</p>
 151
 152     <pre class="prettyprint lang-config">Require host example.org
 153 Require host .net example.edu</pre>
 154
 155
 156     <p>Les hôtes dont les noms correspondent ou se terminent par la
 157     chaîne spécifiée se voient accorder l'accès. Seuls les élément de
 158     nom de domaine complets sont mis en correspondance ; ainsi,
 159     l'exemple ci-dessus correspondra à <code>foo.example.org</code>, mais
 160     ne correspondra pas à <code>fooexample.org</code>. Avec cette
 161     configuration, Apache va effectuer une double recherche DNS sur
 162     l'adresse IP du client, sans tenir compte de la définition de la
 163     directive  <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code>. Il
 164     va effectuer une recherche DNS inverse sur l'adresse IP pour trouver
 165     le nom d'hôte associé, puis une recherche DNS directe sur le nom
 166     d'hôte pour vérifier qu'il correspond bien à l'adresse IP originale.
 167     L'accès ne sera accordé que si le nom d'hôte correspond et si les
 168     recherches DNS inverse et directe sont cohérentes.</p>
 169
 170
 171 <h3><a name="reqfwddns" id="reqfwddns">Require forward-dns</a></h3>
 172
 173     <p>Le fournisseur <code>forward-dns</code> permet d'accéder au serveur
 174     sécurisé en fonction de simples noms d'hôte. Lorsque <code>Require
 175     forward-dns <var>host-name</var></code> est spécifié, toute adresse IP
 176     correspondant à <code><var>host-name</var></code> se voit autoriser l'accès.</p>
 177
 178     <p>A la différence du fournisseur <code>host</code>, ce fournisseur
 179     n'effectue pas de recherche DNS inverse : il effectue simplement une requête
 180     DNS directe pour le nom d'hôte spécifié et donne accès au client si son
 181     adresse IP correspond. Il ne fonctionnera donc qu'avec des noms d'hôte, et
 182     non avec des noms de domaine. Par contre, comme le DNS inverse n'est pas
 183     sollicité, il fonctionnera avec des clients qui utilisent un service de DNS
 184     dynamique.</p>
 185
 186     <pre class="prettyprint lang-config">Require forward-dns bla.example.org</pre>
 187
 188
 189     <p>Un client dont l'adresse IP correspond au nom d'hôte
 190     <code>bla.example.org</code> se verra autoriser l'accès.</p>
 191
 192     <p>Le fournisseur <code>forward-dns</code> est disponible à partir de la
 193     version 2.4.19 du serveur HTTP Apache.</p>
 194
 195
 196 <h3><a name="reqlocal" id="reqlocal">Require local</a></h3>
 197
 198     <p>Le fournisseur <code>local</code> autorise l'accès au serveur si
 199     l'une au moins de ces conditions est satisfaite :</p>
 200
 201     <ul>
 202         <li>l'adresse IP du client correspond à 127.0.0.0/8</li>
 203         <li>l'adresse IP du client est ::1</li>
 204         <li>les adresses IP du client et du serveur sont identiques</li>
 205     </ul>
 206
 207     <p>L'exemple suivant montre une méthode simple pour sélectionner les
 208     connexions en provenance de l'hôte local :</p>
 209
 210     <pre class="prettyprint lang-config">Require local</pre>
 211
 212
 213
 214
 215 <h3><a name="proxy" id="proxy">Note concernant la sécurité</a></h3>
 216
 217     <p>Si le contenu de votre serveur est mandaté, vous devez garder à
 218     l'esprit que l'adresse client correspondra à l'adresse de votre
 219     serveur mandataire et non à l'adresse du client, et l'utilisation de
 220     la directive <code>Require</code> dans ce contexte ne provoquera pas
 221     forcément l'effet désiré. Voir <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> pour
 222     une solution possible à ce problème.</p>
 223
 224
 225
 226 </div>
 227 </div>
 228 <div class="bottomlang">
 229 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 230 <a href="../fr/mod/mod_authz_host.html" title="Français">&nbsp;fr&nbsp;</a></p>
 231 </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&amp;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>
 232 <script type="text/javascript"><!--//--><![CDATA[//><!--
 233 var comments_shortname = 'httpd';
 234 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_authz_host.html';
 235 (function(w, d) {
 236     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 237         d.write('<div id="comments_thread"><\/div>');
 238         var s = d.createElement('script');
 239         s.type = 'text/javascript';
 240         s.async = true;
 241         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 242         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 243     }
 244     else {
 245         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 246     }
 247 })(window, document);
 248 //--><!]]></script></div><div id="footer">
 249 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 250 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
 251 if (typeof(prettyPrint) !== 'undefined') {
 252     prettyPrint();
 253 }
 254 //--><!]]></script>
 255 </body></html>