granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy.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         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_proxy - 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" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <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>
  16 <p class="apache">Serveur Apache HTTP Version 2.4</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <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.4</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Module Apache mod_proxy</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../fr/mod/mod_proxy.html" title="Français">&nbsp;fr&nbsp;</a> |
  26 <a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
  27 </div>
  28 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
  29             anglaise pour les changements récents.</div>
  30 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Serveur mandataire/passerelle multi-protocole</td></tr>
  31 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  32 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_module</td></tr>
  33 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy.c</td></tr></table>
  34 <h3>Sommaire</h3>
  35
  36     <div class="warning"><h3>Avertissement</h3>
  37       <p>N'activez pas la fonctionnalité de mandataire avec la directive
  38       <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
  39       d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
  40       mandataires ouverts sont dangereux pour votre réseau,
  41       mais aussi pour l'Internet au sens large.</p>
  42     </div>
  43
  44     <p><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et ses modules associés implémentent
  45     un mandataire/passerelle pour le serveur HTTP Apache, et supportent
  46     de nombreux protocoles courants, ainsi que plusieurs algorithmes de
  47     répartition de charge. Le support de protocoles et d'algorithmes de
  48     répartition de charge supplémentaires peut être assuré par des
  49     modules tiers.</p>
  50
  51     <p>Un jeu de modules chargés dans le serveur permet de fournir les
  52     fonctionnalités souhaitées. Ces modules peuvent être inclus
  53     statiquement à la compilation, ou dynamiquement via la directive
  54     <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Ce jeu de module
  55     doit comporter :</p>
  56
  57     <ul>
  58       <li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, qui fournit les fonctionnalités de
  59       base d'un mandataire</li>
  60
  61       <li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> et un ou plusieurs modules
  62       de répartition, si la répartition de charge doit être mise en
  63       oeuvre (Voir la documentation de
  64       <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus de détails).</li>
  65
  66       <li>un ou plusieurs modules de types de mandataire, ou protocoles
  67       :
  68
  69         <table class="bordered">
  70         <tr><th>Protocole</th><th>Module</th></tr>
  71         <tr><td>AJP13 (Protocole Apache JServe version
  72           1.3)</td><td><code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code></td></tr>
  73         <tr><td>CONNECT (pour
  74           SSL)</td><td><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code></td></tr>
  75         <tr><td>FastCGI</td><td><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></td></tr>
  76         <tr><td>ftp</td><td><code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></td></tr>
  77         <tr><td>HTTP/0.9, HTTP/1.0, et
  78           HTTP/1.1</td><td><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code></td></tr>
  79         <tr><td>SCGI</td><td><code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></td></tr>
  80         </table>
  81       </li>
  82     </ul>
  83
  84     <p>En outre, d'autres modules fournissent des fonctionnalités
  85     étendues. <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> et ses modules associés
  86     fournissent la mise en cache. Les directives <code>SSLProxy*</code>
  87     du module <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> permettent de contacter des
  88     serveurs distants en utilisant le protocole SSL/TLS. Ces modules
  89     additionnels devront être chargés et configurés pour pouvoir
  90     disposer de ces fonctionnalités.</p>
  91 </div>
  92 <div id="quickview"><h3 class="directives">Directives</h3>
  93 <ul id="toc">
  94 <li><img alt="" src="../images/down.gif" /> <a href="#balancergrowth">BalancerGrowth</a></li>
  95 <li><img alt="" src="../images/down.gif" /> <a href="#balancermember">BalancerMember</a></li>
  96 <li><img alt="" src="../images/down.gif" /> <a href="#noproxy">NoProxy</a></li>
  97 <li><img alt="" src="../images/down.gif" /> <a href="#proxy">&lt;Proxy&gt;</a></li>
  98 <li><img alt="" src="../images/down.gif" /> <a href="#proxyaddheaders">ProxyAddHeaders</a></li>
  99 <li><img alt="" src="../images/down.gif" /> <a href="#proxybadheader">ProxyBadHeader</a></li>
 100 <li><img alt="" src="../images/down.gif" /> <a href="#proxyblock">ProxyBlock</a></li>
 101 <li><img alt="" src="../images/down.gif" /> <a href="#proxydomain">ProxyDomain</a></li>
 102 <li><img alt="" src="../images/down.gif" /> <a href="#proxyerroroverride">ProxyErrorOverride</a></li>
 103 <li><img alt="" src="../images/down.gif" /> <a href="#proxyiobuffersize">ProxyIOBufferSize</a></li>
 104 <li><img alt="" src="../images/down.gif" /> <a href="#proxymatch">&lt;ProxyMatch&gt;</a></li>
 105 <li><img alt="" src="../images/down.gif" /> <a href="#proxymaxforwards">ProxyMaxForwards</a></li>
 106 <li><img alt="" src="../images/down.gif" /> <a href="#proxypass">ProxyPass</a></li>
 107 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li>
 108 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassmatch">ProxyPassMatch</a></li>
 109 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassreverse">ProxyPassReverse</a></li>
 110 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li>
 111 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li>
 112 <li><img alt="" src="../images/down.gif" /> <a href="#proxypreservehost">ProxyPreserveHost</a></li>
 113 <li><img alt="" src="../images/down.gif" /> <a href="#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li>
 114 <li><img alt="" src="../images/down.gif" /> <a href="#proxyremote">ProxyRemote</a></li>
 115 <li><img alt="" src="../images/down.gif" /> <a href="#proxyremotematch">ProxyRemoteMatch</a></li>
 116 <li><img alt="" src="../images/down.gif" /> <a href="#proxyrequests">ProxyRequests</a></li>
 117 <li><img alt="" src="../images/down.gif" /> <a href="#proxyset">ProxySet</a></li>
 118 <li><img alt="" src="../images/down.gif" /> <a href="#proxysourceaddress">ProxySourceAddress</a></li>
 119 <li><img alt="" src="../images/down.gif" /> <a href="#proxystatus">ProxyStatus</a></li>
 120 <li><img alt="" src="../images/down.gif" /> <a href="#proxytimeout">ProxyTimeout</a></li>
 121 <li><img alt="" src="../images/down.gif" /> <a href="#proxyvia">ProxyVia</a></li>
 122 </ul>
 123 <h3>Sujets</h3>
 124 <ul id="topics">
 125 <li><img alt="" src="../images/down.gif" /> <a href="#forwardreverse">Mandataires directs et
 126     mandataires/passerelles inverses</a></li>
 127 <li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples simples</a></li>
 128 <li><img alt="" src="../images/down.gif" /> <a href="#workers">Workers</a></li>
 129 <li><img alt="" src="../images/down.gif" /> <a href="#access">Contrôler l'accès à votre
 130     mandataire</a></li>
 131 <li><img alt="" src="../images/down.gif" /> <a href="#startup">Ralentissement au démarrage</a></li>
 132 <li><img alt="" src="../images/down.gif" /> <a href="#intranet">Mandataire en Intranet</a></li>
 133 <li><img alt="" src="../images/down.gif" /> <a href="#envsettings">Ajustements relatifs au
 134     protocole</a></li>
 135 <li><img alt="" src="../images/down.gif" /> <a href="#request-bodies">Corps de requêtes</a></li>
 136 <li><img alt="" src="../images/down.gif" /> <a href="#x-headers">En-têtes de requête du mandataire
 137     inverse</a></li>
 138 </ul><h3>Voir aussi</h3>
 139 <ul class="seealso">
 140 <li><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code></li>
 141 <li><code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code></li>
 142 <li><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li>
 143 <li><code class="module"><a href="../mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></li>
 144 <li><code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li>
 145 <li><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code></li>
 146 <li><code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></li>
 147 <li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li>
 148 <li><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></li>
 149 </ul></div>
 150 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 151 <div class="section">
 152 <h2><a name="forwardreverse" id="forwardreverse">Mandataires directs et
 153     mandataires/passerelles inverses</a></h2>
 154       <p>Le serveur HTTP Apache peut être configuré dans les deux modes mandataire
 155       <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nommé
 156       mode <dfn>passerelle</dfn>).</p>
 157
 158       <p>Un <dfn>mandataire direct</dfn> standard est un serveur
 159       intermédiaire qui s'intercale entre le client et le <em>serveur
 160       demandé</em>. Pour obtenir un contenu hébergé par
 161       le serveur demandé, le client envoie une requête au
 162       mandataire en nommant le serveur demandé comme
 163       cible, puis le mandataire extrait le contenu depuis le
 164       serveur demandé et le renvoie enfin au client. Le client doit être
 165       configuré de manière appropriée pour pouvoir utiliser le mandataire
 166       direct afin d'accéder à d'autres sites.</p>
 167
 168       <p>L'accès à Internet depuis des clients situés derrière un
 169       pare-feu est une utilisation typique du mandataire direct. Le
 170       mandataire direct peut aussi utiliser la mise en cache (fournie
 171       par <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>) pour réduire la charge du
 172       réseau.</p>
 173
 174       <p>La fonctionnalité de mandataire direct est activée via la
 175       directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code>.
 176       Comme les mandataires directs permettent aux clients d'accéder à
 177       des sites quelconques via votre serveur et de dissimuler leur
 178       véritable origine, il est indispensable de <a href="#access">sécuriser votre serveur</a> de façon à ce que seuls
 179       les clients autorisés puissent accéder à votre serveur avant
 180       d'activer la fonctionnalité de mandataire direct.</p>
 181
 182       <p>Un <dfn>mandataire inverse</dfn> (ou <dfn>passerelle</dfn>),
 183       quant à lui, apparaît au client comme un serveur web standard.
 184       Aucune configuration particulière du client n'est nécessaire. Le
 185       client adresse ses demandes de contenus ordinaires dans l'espace
 186       de nommage du mandataire inverse. Ce dernier décide alors où
 187       envoyer ces requêtes, et renvoie le contenu au client comme s'il
 188       l'hébergeait lui-même.</p>
 189
 190       <p>L'accès d'utilisateurs depuis Internet vers un serveur situé
 191       derrière un pare-feu est une utilisation typique du mandataire
 192       inverse. On peut aussi utiliser les mandataires inverses pour
 193       mettre en oeuvre une répartition de charge entre plusieurs
 194       serveurs en arrière-plan, ou fournir un cache pour un serveur
 195       d'arrière-plan plus lent. Les mandataires inverses peuvent aussi
 196       tout simplement servir à rassembler plusieurs serveurs dans le
 197       même espace de nommage d'URLs.</p>
 198
 199       <p>La fonctionnalité de mandataire inverse est activée via la
 200       directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou
 201       le drapeau <code>[P]</code> de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Il n'est
 202       <strong>pas</strong> nécessaire de définir <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> pour configurer
 203       un mandataire inverse.</p>
 204     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 205 <div class="section">
 206 <h2><a name="examples" id="examples">Exemples simples</a></h2>
 207
 208     <p>Les exemples ci-dessous illustrent de manière très basique la
 209     mise en oeuvre de la fonctionnalité de mandataire et ne sont là que
 210     pour vous aider à démarrer. Reportez-vous à la documentation de
 211     chaque directive.</p>
 212
 213     <p>Si en outre, vous désirez activer la mise en cache, consultez la
 214     documentation de <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p>
 215
 216     <div class="example"><h3>Mandataire inverse</h3><p><code>
 217     ProxyPass /foo http://foo.example.com/bar<br />
 218     ProxyPassReverse /foo http://foo.example.com/bar
 219     </code></p></div>
 220
 221     <div class="example"><h3>Mandataire direct</h3><p><code>
 222     ProxyRequests On<br />
 223     ProxyVia On<br />
 224     <br />
 225     &lt;Proxy *&gt;<br />
 226     <span class="indent">
 227       Require host internal.example.com<br />
 228     </span>
 229     &lt;/Proxy&gt;
 230     </code></p></div>
 231     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 232 <div class="section">
 233 <h2><a name="workers" id="workers">Workers</a></h2>
 234       <p>Le mandataire gère la configuration et les paramètres de
 235       communication des serveurs originaux au sein d'objets nommés
 236       <dfn>workers</dfn>. Deux types de worker sont fournis : le worker
 237       par défaut du mandataire direct et le worker par défaut du
 238       mandataire inverse. Il est aussi possible de définir explicitement
 239       des workers supplémentaires.</p>
 240
 241       <p>Les deux workers par défaut possèdent une configuration figée
 242       et seront utilisés si aucun autre worker ne correspond à la
 243       requête. Ils n'utilisent ni les jeux de connexions (connection
 244       pooling), ni les
 245       connexions HTTP persistantes (Keep-Alive). En effet, les
 246       connexions TCP vers le serveur original sont fermées et ouvertes
 247       pour chaque requête.</p>
 248
 249       <p>Les workers définis explicitement sont identifiés par leur URL.
 250       Ils sont en général définis via les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> lorsqu'on les
 251       utilise dans le cadre d'un mandataire inverse :</p>
 252
 253       <div class="example"><p><code>
 254           ProxyPass /example http://backend.example.com connectiontimeout=5 timeout=30
 255       </code></p></div>
 256
 257       <p>Cette directive va créer un worker associé à l'URL du serveur
 258       original <code>http://backend.example.com</code>, et utilisant les
 259       valeurs de timeout données. Lorsqu'ils sont utilisés dans le cadre
 260       d'un mandataire direct, les workers sont en général définis via la
 261       directive <code class="directive"><a href="#proxyset">ProxySet</a></code>,</p>
 262
 263       <div class="example"><p><code>
 264           ProxySet http://backend.example.com connectiontimeout=5 timeout=30
 265       </code></p></div>
 266
 267       <p>ou encore via les directives <code class="directive"><a href="#proxy">Proxy</a></code> et <code class="directive"><a href="#proxyset">ProxySet</a></code> :</p>
 268
 269       <div class="example"><p><code>
 270         &lt;Proxy http://backend.example.com&gt;<br />
 271         <span class="indent">
 272           ProxySet connectiontimeout=5 timeout=30
 273         </span>
 274         &lt;/Proxy&gt;
 275       </code></p></div>
 276
 277       <p>L'utilisation de workers définis explicitement dans le mode
 278       mandataire direct n'est pas très courante, car les mandataires
 279       directs communiquent en général avec de nombreux serveurs
 280       originaux. La création explicite de workers pour certains serveurs
 281       originaux peut cependant s'avérer utile si ces serveurs sont
 282       très souvent sollicités. A leur niveau, les workers explicitement
 283       définis ne possèdent aucune notion de mandataire direct ou
 284       inverse. Ils encapsulent un concept de communication commun avec
 285       les serveurs originaux. Un worker créé via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> pour être utilisé dans le
 286       cadre d'un mandataire inverse sera aussi utilisé dans le cadre
 287       d'un mandataire directe chaque fois que l'URL vers le serveur
 288       original correspondra à l'URL du worker, et vice versa.</p>
 289
 290       <p>L'URL qui identifie un worker correspond à l'URL de son serveur
 291       original, y compris un éventuel chemin donné :</p>
 292
 293       <div class="example"><p><code>
 294           ProxyPass /exemples http://backend.example.com/exemples<br />
 295           ProxyPass /docs http://backend.example.com/docs
 296       </code></p></div>
 297
 298       <p>Dans cet exemple, deux workers différents sont définis, chacun
 299       d'eux utilisant des configurations et jeux de connexions
 300       séparés.</p>
 301
 302       <div class="warning"><h3>Partage de workers</h3>
 303         <p>Le partage de workers intervient lorsque les URLs des workers
 304         s'entrecoupent, ce qui arrive lorsque l'URL d'un worker
 305         correspond au début de l'URL d'un autre worker défini plus loin
 306         dans le fichier de configuration. Dans l'exemple suivant,</p>
 307
 308         <div class="example"><p><code>
 309             ProxyPass /apps http://backend.example.com/ timeout=60<br />
 310             ProxyPass /examples http://backend.example.com/exemples timeout=10
 311         </code></p></div>
 312
 313         <p>le second worker n'est pas vraiment créé. C'est le premier
 314         worker qui est en fait utilisé. L'avantage de ceci réside dans
 315         le fait qu'il n'existe qu'un seul jeu de connexions, ces
 316         dernières étant donc réutilisées plus souvent. Notez que tous
 317         les attributs de configuration définis explicitement pour le
 318         deuxième worker seront ignorés, ce qui sera journalisé en tant
 319         qu'avertissement. Ainsi, dans l'exemple ci-dessus, la valeur de
 320         timeout retenue pour l'URL <code>/exemples</code> sera
 321         <code>60</code>, et non <code>10</code> !</p>
 322
 323         <p>Si vous voulez empêcher le partage de workers, classez vos
 324         définitions de workers selon la longueur des URLs, de la plus
 325         longue à la plus courte. Si au contraire vous voulez favoriser
 326         ce partage, utilisez l'ordre de classement inverse. Voir aussi
 327         l'avertissement à propos de l'ordre de classement des directives
 328         <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
 329
 330       </div>
 331
 332       <p>Les workers définis explicitement sont de deux sortes :
 333       <dfn>workers directs</dfn> et <dfn>workers de répartition (de
 334       charge)</dfn>. Ils supportent de nombreux attributs de
 335       configuration importants décrits dans la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Ces mêmes attributs
 336       peuvent aussi être définis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code>.</p>
 337
 338       <p>Le jeu d'options disponibles pour un worker direct dépend du
 339       protocole spécifié dans l'URL du serveur original. Les protocoles
 340       disponibles comprennent <code>ajp</code>, <code>fcgi</code>,
 341       <code>ftp</code>, <code>http</code> et <code>scgi</code>.</p>
 342
 343       <p>Les workers de répartition sont des workers virtuels qui
 344       utilisent les workers directs, connus comme faisant partie de leurs
 345       membres, pour le traitement effectif des requêtes. Chaque
 346       répartiteur peut comporter plusieurs membres. Lorsqu'il traite une
 347       requête, il choisit un de ses membres en fonction de l'algorithme
 348       de répartition de charge défini.</p>
 349
 350       <p>Un worker de répartition est créé si son URL de worker comporte
 351       <code>balancer</code> comme indicateur de protocole. L'URL du
 352       répartiteur permet d'identifier de manière unique le worker de
 353       répartition. La directive <code class="directive"><a href="#balancermember">BalancerMember</a></code> permet d'ajouter des
 354       membres au répartiteur.</p>
 355
 356     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 357 <div class="section">
 358 <h2><a name="access" id="access">Contrôler l'accès à votre
 359     mandataire</a></h2>
 360       <p>Vous pouvez restreindre l'accès à votre mandataire via le bloc
 361       de contrôle <code class="directive"><a href="#proxy">&lt;Proxy&gt;</a></code> comme dans
 362       l'exemple suivant :</p>
 363
 364       <div class="example"><p><code>
 365         &lt;Proxy *&gt;<br />
 366         <span class="indent">
 367           Require ip 192.168.0<br />
 368         </span>
 369         &lt;/Proxy&gt;
 370       </code></p></div>
 371
 372       <p>Pour plus de détails sur les directives de contrôle d'accès,
 373       voir la documentation du module
 374       <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.</p>
 375
 376       <p>Restreindre l'accès de manière stricte est essentiel si vous
 377       mettez en oeuvre un mandataire direct (en définissant la directive
 378       <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> à "on").
 379       Dans le cas contraire, votre serveur pourrait être utilisé par
 380       n'importe quel client pour accéder à des serveurs quelconques,
 381       tout en masquant sa véritable identité. Ceci représente un danger
 382       non seulement pour votre réseau, mais aussi pour l'Internet au
 383       sens large. Dans le cas de la mise en oeuvre d'un mandataire
 384       inverse (en définissant la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> à "off"), le contrôle
 385       d'accès est moins critique car les clients ne peuvent contacter
 386       que les serveurs que vous avez spécifiés.</p>
 387
 388       <p><strong>Voir aussi</strong> la variable d'environnement <a href="mod_proxy_http.html#env">Proxy-Chain-Auth</a>.</p>
 389
 390     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 391 <div class="section">
 392 <h2><a name="startup" id="startup">Ralentissement au démarrage</a></h2>
 393       <p>Si vous utilisez la directive <code class="directive"><a href="#proxyblock">ProxyBlock</a></code>, les noms d'hôtes sont résolus en adresses
 394       IP puis ces dernières mises en cache au cours du démarrage
 395       à des fins de tests de comparaisons ultérieurs. Ce processus peut
 396       durer plusieurs secondes (ou d'avantage) en fonction de la vitesse
 397       à laquelle s'effectue la résolution des noms d'hôtes.</p>
 398     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 399 <div class="section">
 400 <h2><a name="intranet" id="intranet">Mandataire en Intranet</a></h2>
 401       <p>Un serveur mandataire Apache httpd situé à l'intérieur d'un Intranet
 402       doit faire suivre les requêtes destinées à un serveur externe à
 403       travers le pare-feu de l'entreprise (pour ce faire, définissez la
 404       directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> de
 405       façon à ce qu'elle fasse suivre le <var>protocole</var> concerné
 406       vers le mandataire du pare-feu). Cependant, lorsqu'il doit accéder
 407       à des ressources situées dans l'Intranet, il peut se passer du
 408       pare-feu pour accéder aux serveurs. A cet effet, la directive
 409       <code class="directive"><a href="#noproxy">NoProxy</a></code> permet de
 410       spécifier quels hôtes appartiennent à l'Intranet et peuvent donc
 411       être accédés directement.</p>
 412
 413       <p>Les utilisateurs d'un Intranet ont tendance à oublier le nom du
 414       domaine local dans leurs requêtes WWW, et demandent par exemple
 415       "http://un-serveur/" au lieu de
 416       <code>http://un-serveur.example.com/</code>. Certains serveurs
 417       mandataires commerciaux acceptent ce genre de requête et les
 418       traitent simplement en utilisant un nom de domaine local
 419       implicite. Lorsque la directive <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> est utilisée et si le
 420       serveur est <a href="#proxyrequests">configuré comme
 421       mandataire</a>, Apache httpd peut renvoyer une réponse de redirection et
 422       ainsi fournir au client l'adresse de serveur correcte,
 423       entièrement qualifiée. C'est la méthode à privilégier car le
 424       fichier des marque-pages de l'utilisateur contiendra alors des
 425       noms de serveurs entièrement qualifiés.</p>
 426     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 427 <div class="section">
 428 <h2><a name="envsettings" id="envsettings">Ajustements relatifs au
 429     protocole</a></h2>
 430       <p>Pour les cas où <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> envoie des requêtes
 431       vers un serveur qui n'implémente pas correctement les connexions
 432       persistantes ou le protocole HTTP/1.1, il existe deux variables
 433       d'environnement qui permettent de forcer les requêtes à utiliser
 434       le protocole HTTP/1.0 avec connexions non persistantes. Elles
 435       peuvent être définies via la directive <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code>.</p>
 436
 437       <p>Il s'agit des variables <code>force-proxy-request-1.0</code> et
 438       <code>proxy-nokeepalive</code>.</p>
 439
 440       <div class="example"><p><code>
 441         &lt;Location /serveur-non-conforme/&gt;<br />
 442         <span class="indent">
 443           ProxyPass http://serveur-non-conforme:7001/foo/<br />
 444           SetEnv force-proxy-request-1.0 1<br />
 445           SetEnv proxy-nokeepalive 1<br />
 446         </span>
 447         &lt;/Location&gt;
 448       </code></p></div>
 449
 450     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 451 <div class="section">
 452 <h2><a name="request-bodies" id="request-bodies">Corps de requêtes</a></h2>
 453
 454     <p>Certaines méthodes de requêtes comme POST comportent un corps de
 455     requête. Le protocole HTTP stipule que les requêtes qui comportent
 456     un corps doivent soit utiliser un codage de transmission
 457     fractionnée (chunked transfer encoding), soit envoyer un en-tête de requête
 458     <code>Content-Length</code>. Lorsqu'il fait suivre ce genre de
 459     requête vers le serveur demandé, <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>
 460     s'efforce toujours d'envoyer l'en-tête <code>Content-Length</code>.
 461     Par contre, si la taille du corps est importante, et si la requête
 462     originale utilise un codage à fractionnement, ce dernier peut aussi
 463     être utilisé dans la requête montante. Ce comportement peut être
 464     contrôlé à l'aide de <a href="../env.html">variables
 465     d'environnement</a>. Ainsi, si elle est définie, la variable
 466     <code>proxy-sendcl</code> assure une compatibilité maximale avec les
 467     serveurs demandés en imposant l'envoi de l'en-tête
 468     <code>Content-Length</code>, alors que
 469     <code>proxy-sendchunked</code> diminue la consommation de ressources
 470     en imposant l'utilisation d'un codage à fractionnement.</p>
 471
 472     <p>Dans certaines circonstances, le serveur doit mettre en file
 473     d'attente sur disque les corps de requêtes afin de satisfaire le
 474     traitement demandé des corps de requêtes. Par exemple, cette mise en
 475     file d'attente se produira si le corps original a été envoyé selon un
 476     codage morcelé (et possède une taille importante), alors que
 477     l'administrateur a demandé que les requêtes du serveur
 478     d'arrière-plan soient envoyées avec l'en-tête Content-Length ou en
 479     HTTP/1.0. Cette mise en file d'attente se produira aussi si le corps
 480     de la requête contient déjà un en-tête Content-Length, alors que le
 481     serveur est configuré pour filtrer les corps des requêtes entrantes.</p>
 482
 483     <p>La directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> ne s'applique qu'aux
 484     corps de requêtes que le serveur met en file d'attente sur disque.</p>
 485
 486     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 487 <div class="section">
 488 <h2><a name="x-headers" id="x-headers">En-têtes de requête du mandataire
 489     inverse</a></h2>
 490
 491     <p>Lorsqu'il est configuré en mode mandataire inverse (en utilisant
 492     par exemple la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>),
 493     <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> ajoute plusieurs en-têtes de requête
 494     afin de transmettre des informations au serveur demandé. Ces
 495     en-têtes sont les suivants :</p>
 496
 497     <dl>
 498       <dt><code>X-Forwarded-For</code></dt>
 499       <dd>L'adresse IP du client.</dd>
 500       <dt><code>X-Forwarded-Host</code></dt>
 501       <dd>L'hôte d'origine demandé par le client dans l'en-tête de
 502       requête HTTP <code>Host</code>.</dd>
 503       <dt><code>X-Forwarded-Server</code></dt>
 504       <dd>Le nom d'hôte du serveur mandataire.</dd>
 505     </dl>
 506
 507     <p>Ces en-têtes doivent être utilisés avec précautions sur le
 508     serveur demandé, car ils contiendront plus d'une valeur (séparées
 509     par des virgules) si la requête originale contenait déjà un de ces
 510     en-têtes. Par exemple, vous pouvez utiliser
 511     <code>%{X-Forwarded-For}i</code> dans la chaîne de format du journal
 512     du serveur demandé pour enregistrer les adresses IP des clients
 513     originaux, mais il est possible que vous obteniez plusieurs adresses
 514     si la requête passe à travers plusieurs mandataires.</p>
 515
 516     <p>Voir aussi les directives <code class="directive"><a href="#proxypreservehost">ProxyPreserveHost</a></code> et <code class="directive"><a href="#proxyvia">ProxyVia</a></code> directives, qui permettent
 517     de contrôler d'autres en-têtes de requête.</p>
 518
 519    </div>
 520 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 521 <div class="directive-section"><h2><a name="BalancerGrowth" id="BalancerGrowth">BalancerGrowth</a> <a name="balancergrowth" id="balancergrowth">Directive</a></h2>
 522 <table class="directive">
 523 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de membres supplémentaires pouvant être ajoutés
 524 après la configuration initiale</td></tr>
 525 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerGrowth <var>#</var></code></td></tr>
 526 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BalancerGrowth 5</code></td></tr>
 527 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 528 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 529 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 530 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>BalancerGrowth est disponible depuis la version 2.3.13 du
 531 serveur HTTP Apache</td></tr>
 532 </table>
 533     <p>Cette directive permet de définir le nombre de membres pouvant
 534     être ajoutés au groupe de répartition de charge préconfiguré d'un
 535     serveur virtuel. Elle n'est active que si le groupe a été
 536     préconfiguré avec un membre au minimum.</p>
 537
 538 </div>
 539 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 540 <div class="directive-section"><h2><a name="BalancerMember" id="BalancerMember">BalancerMember</a> <a name="balancermember" id="balancermember">Directive</a></h2>
 541 <table class="directive">
 542 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un membre à un groupe de répartition de
 543 charge</td></tr>
 544 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerMember [<var>balancerurl</var>] <var>url</var> [<var>clé=valeur [clé=valeur ...]]</var></code></td></tr>
 545 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 546 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 547 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 548 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2 du serveur HTTP Apache.</td></tr>
 549 </table>
 550     <p>Cette directive parmet d'ajouter un membre à un groupe de
 551     répartition de charge. Elle peut se trouver dans un conteneur
 552     <code>&lt;Proxy <var>balancer://</var>...&gt;</code>, et accepte
 553     tous les paramètres de paires clé/valeur que supporte la directive
 554     <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
 555     <p>La directive <code class="directive"><a href="#balancermember">BalancerMember</a></code> accepte un paramètre
 556     supplémentaire : <var>loadfactor</var>. Il s'agit du facteur de
 557     charge du membre - un nombre entre 1 (valeur par défaut) et 100, qui
 558     définit la charge à appliquer au membre en question.</p>
 559     <p>L'argument balancerurl n'est requis que s'il ne se trouve pas
 560     dèjà dans la directive de conteneur <code>&lt;Proxy
 561     <var>balancer://</var>...&gt;</code>. Il correspond à l'URL d'un
 562     répartiteur de charge défini par une directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
 563
 564 </div>
 565 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 566 <div class="directive-section"><h2><a name="NoProxy" id="NoProxy">NoProxy</a> <a name="noproxy" id="noproxy">Directive</a></h2>
 567 <table class="directive">
 568 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serveurs, domaines ou réseaux auquels on se connectera
 569 directement</td></tr>
 570 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NoProxy <var>domaine</var> [<var>domaine</var>] ...</code></td></tr>
 571 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 572 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 573 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 574 </table>
 575     <p>Cette directive n'a d'utilité que pour les serveurs mandataires
 576     Apache httpd au sein d'Intranets. La directive
 577     <code class="directive">NoProxy</code> permet de spécifier une liste de
 578     sous-réseaux, d'adresses IP, de serveurs et/ou de domaines séparés
 579     par des espaces. Une requête pour un serveur qui correspond à un ou
 580     plusieurs critères sera toujours servie par ce serveur directement,
 581     sans être redirigée vers le(s) serveur(s) mandataire(s) défini(s) par
 582     la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>.</p>
 583
 584     <div class="example"><h3>Exemple</h3><p><code>
 585       ProxyRemote  *  http://pare-feu.example.com:81<br />
 586       NoProxy         .example.com 192.168.112.0/21
 587     </code></p></div>
 588
 589     <p>Le type des arguments <var>serveur</var> de la directive
 590     <code class="directive">NoProxy</code> appartiennent à la liste suivante
 591     :</p>
 592
 593     <dl>
 594
 595     <dt><var><a name="domain" id="domain">Domaine</a></var></dt>
 596     <dd>
 597     <p>Un <dfn>domaine</dfn> est ici un nom de domaine DNS partiellement
 598     qualifié précédé d'un point. Il représente une liste de serveurs qui
 599     appartiennent logiquement au même domaine ou à la même zonz DNS
 600     (en d'autres termes, les nom des serveurs se terminent tous par
 601     <var>domaine</var>).</p>
 602
 603     <div class="example"><h3>Exemple</h3><p><code>
 604       .com .example.org.
 605     </code></p></div>
 606
 607     <p>Pour faire la distinction entre <var>domaine</var>s et <var><a href="#hostname">nom d'hôte</a></var>s (des points de vue à la fois
 608     syntaxique et
 609     sémantique, un domaine DNS pouvant aussi avoir un enregistrement DNS
 610     de type A !), les <var>domaine</var>s sont toujours spécifiés en les
 611     préfixant par un point.</p>
 612
 613     <div class="note"><h3>Note</h3>
 614       <p>Les comparaisons de noms de domaines s'effectuent sans tenir
 615       compte de la casse, et les parties droites des <var>Domaine</var>s
 616       sont toujours censées correspondre à la racine de l'arborescence
 617       DNS, si bien que les domaines <code>.ExEmple.com</code> et
 618       <code>.example.com.</code> (notez le point à la fin du nom) sont
 619       considérés comme identiques. Comme une comparaison de domaines ne
 620       nécessite pas de recherche DNS, elle est beaucoup plus efficace
 621       qu'une comparaison de sous-réseaux.</p>
 622     </div></dd>
 623
 624
 625     <dt><var><a name="subnet" id="subnet">Sous-réseau</a></var></dt>
 626     <dd>
 627     <p>Un <dfn>Sous-réseau</dfn> est une adresse internet partiellement
 628     qualifiée sous forme numérique (quatre nombres séparés par des
 629     points), optionnellement suivie d'un slash et du masque de
 630     sous-réseau spécifiant le nombre de bits significatifs dans le
 631     <var>Sous-réseau</var>. Il représente un sous-réseau de serveurs qui
 632     peuvent être atteints depuis la même interface réseau. En l'absence
 633     de masque de sous-réseau explicite, il est sous-entendu que les
 634     digits manquants (ou caractères 0) de fin spécifient le masque de
 635     sous-réseau (Dans ce cas, le masque de sous-réseau ne peut être
 636     qu'un multiple de 8). Voici quelques exemples :</p>
 637
 638     <dl>
 639     <dt><code>192.168</code> ou <code>192.168.0.0</code></dt>
 640     <dd>le sous-réseau 192.168.0.0 avec un masque de sous-réseau
 641     implicite de 16 bits significatifs (parfois exprimé sous la forme
 642     <code>255.255.0.0</code>)</dd>
 643     <dt><code>192.168.112.0/21</code></dt>
 644     <dd>le sous-réseau <code>192.168.112.0/21</code> avec un masque de
 645     sous-réseau implicite de 21 bits significatifs (parfois exprimé
 646     sous la forme<code>255.255.248.0</code>)</dd>
 647     </dl>
 648
 649     <p>Comme cas extrêmes, un <em>Sous-réseau</em> avec un masque de
 650     sous-réseau de 32 bits significatifs est équivalent à une <var><a href="#ipaddr">adresse IP</a></var>, alors qu'un <em>Sous-réseau</em> avec un masque de
 651     sous-réseau de 0 bit significatif (c'est à dire 0.0.0.0/0) est
 652     identique à la constante <var>_Default_</var>, et peut correspondre
 653     à toute adresse IP.</p></dd>
 654
 655
 656     <dt><var><a name="ipaddr" id="ipaddr">Adresse IP</a></var></dt>
 657     <dd>
 658     <p>Une <dfn>Adresse IP</dfn> est une adresse internet pleinement
 659     qualifiée sous forme numérique (quatre nombres séparés par des
 660     points). En général, cette adresse représente un serveur, mais elle
 661     ne doit pas nécessairement correspondre à un nom de domaine DNS.</p>
 662     <div class="example"><h3>Exemple</h3><p><code>
 663       192.168.123.7
 664     </code></p></div>
 665
 666     <div class="note"><h3>Note</h3>
 667       <p>Une <dfn>Adresse IP</dfn> ne nécessite pas de résolution DNS,
 668       et peut ainsi s'avérer plus efficace quant aux performances
 669       d'Apache.</p>
 670     </div></dd>
 671
 672
 673     <dt><var><a name="hostname" id="hostname">Nom de serveur</a></var></dt>
 674     <dd>
 675     <p>Un <dfn>Nom de serveur</dfn> est un nom de domaine DNS pleinement
 676     qualifié qui peut être résolu en une ou plusieurs adresses IP par le
 677     service de noms de domaines DNS. Il représente un hôte logique (par
 678     opposition aux <var><a href="#domain">Domaine</a></var>s, voir
 679     ci-dessus), et doit pouvoir être résolu en une ou plusieurs <var><a href="#ipaddr">adresses IP</a></var> (ou souvent en une liste
 680     d'hôtes avec différentes <var><a href="#ipaddr">adresses
 681     IP</a></var>).</p>
 682
 683     <div class="example"><h3>Exemples</h3><p><code>
 684       prep.ai.example.edu<br />
 685       www.example.org
 686     </code></p></div>
 687
 688     <div class="note"><h3>Note</h3>
 689       <p>Dans de nombreuses situations, il est plus efficace de
 690       spécifier une <var><a href="#ipaddr">adresse IP</a></var> qu'un
 691       <var>Nom de serveur</var> car cela évite d'avoir à effectuer une
 692       recherche DNS. La résolution de nom dans Apache httpd peut prendre un
 693       temps très long lorsque la connexion avec le serveur de noms
 694       utilise une liaison PPP lente.</p>
 695       <p>Les comparaisons de <var>Nom de serveur</var> s'effectuent sans tenir
 696       compte de la casse, et les parties droites des <var>Noms de serveur</var>
 697       sont toujours censées correspondre à la racine de l'arborescence
 698       DNS, si bien que les domaines <code>WWW.ExEmple.com</code> et
 699       <code>www.example.com.</code> (notez le point à la fin du nom) sont
 700       considérés comme identiques.</p>
 701      </div></dd>
 702     </dl>
 703
 704 <h3>Voir aussi</h3>
 705 <ul>
 706 <li><a href="../dns-caveats.html">Problèmes liés au DNS</a></li>
 707 </ul>
 708 </div>
 709 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 710 <div class="directive-section"><h2><a name="Proxy" id="Proxy">&lt;Proxy&gt;</a> <a name="proxy" id="proxy">Directive</a></h2>
 711 <table class="directive">
 712 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant à des ressources
 713 mandatées</td></tr>
 714 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Proxy <var>url-avec-jokers</var>&gt; ...&lt;/Proxy&gt;</code></td></tr>
 715 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 716 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 717 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 718 </table>
 719     <p>Les directives situées dans une section <code class="directive">&lt;Proxy&gt;</code> ne s'appliquent qu'au contenu
 720     mandaté concerné. Les jokers de style shell sont autorisés.</p>
 721
 722     <p>Par exemple, les lignes suivantes n'autoriseront à accéder à un
 723     contenu via votre serveur mandataire que les hôtes appartenant à
 724     <code>votre-reseau.example.com</code> :</p>
 725
 726     <div class="example"><p><code>
 727       &lt;Proxy *&gt;<br />
 728       <span class="indent">
 729         Require host votre-reseau.example.com<br />
 730       </span>
 731       &lt;/Proxy&gt;
 732     </code></p></div>
 733
 734     <p>Dans l'exemple suivant, tous les fichiers du répertoire
 735     <code>foo</code> de <code>example.com</code> seront traités par le
 736     filtre <code>INCLUDES</code> lorsqu'ils seront envoyés par
 737     l'intermédiaire du serveur mandataire :</p>
 738
 739     <div class="example"><p><code>
 740       &lt;Proxy http://example.com/foo/*&gt;<br />
 741       <span class="indent">
 742         SetOutputFilter INCLUDES<br />
 743       </span>
 744       &lt;/Proxy&gt;
 745     </code></p></div>
 746
 747
 748 <h3>Voir aussi</h3>
 749 <ul>
 750 <li><code class="directive"><a href="#proxymatch">&lt;ProxyMatch&gt;</a></code></li>
 751 </ul>
 752 </div>
 753 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 754 <div class="directive-section"><h2><a name="ProxyAddHeaders" id="ProxyAddHeaders">ProxyAddHeaders</a> <a name="proxyaddheaders" id="proxyaddheaders">Directive</a></h2>
 755 <table class="directive">
 756 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des informations à propos du mandataire aux
 757 en-têtes X-Forwarded-*</td></tr>
 758 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyAddHeaders Off|On</code></td></tr>
 759 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyAddHeaders On</code></td></tr>
 760 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
 761 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 762 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 763 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.10</td></tr>
 764 </table>
 765     <p>Cette directive permet de passer au serveur d'arrière-plan des
 766     informations à propos du mandataire via les en-têtes HTTP
 767     X-Forwarded-For, X-Forwarded-Host et X-Forwarded-Server.</p>
 768     <div class="note"><h3>Utilité</h3>
 769      <p>Cette option n'est utile que dans le cas du mandat HTTP traité
 770      par <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.</p>
 771     </div>
 772
 773 </div>
 774 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 775 <div class="directive-section"><h2><a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a> <a name="proxybadheader" id="proxybadheader">Directive</a></h2>
 776 <table class="directive">
 777 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine la manière de traiter les lignes d'en-tête
 778 incorrectes d'une réponse</td></tr>
 779 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBadHeader IsError|Ignore|StartBody</code></td></tr>
 780 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyBadHeader IsError</code></td></tr>
 781 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 782 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 783 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 784 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0.44 du serveur HTTP Apache</td></tr>
 785 </table>
 786     <p>La directive <code class="directive">ProxyBadHeader</code> permet de
 787     déterminer le comportement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> lorsqu'il
 788     reçoit des lignes d'en-tête de réponse dont la syntaxe n'est pas valide (c'est
 789     à dire ne contenant pas de caractère ':') en provenance du serveur
 790     original. Les arguments disponibles sont :</p>
 791
 792     <dl>
 793     <dt><code>IsError</code></dt>
 794     <dd>Annule la requête et renvoie une réponse de code 502 (mauvaise
 795     passerelle). C'est le comportement par défaut.</dd>
 796
 797     <dt><code>Ignore</code></dt>
 798     <dd>Traite les lignes d'en-tête incorrectes comme si elles n'avaient
 799     pas été envoyées.</dd>
 800
 801     <dt><code>StartBody</code></dt>
 802     <dd>A la réception de la première ligne d'en-tête incorrecte, les
 803     autres en-têtes sont lus et ce qui reste est traité en tant que
 804     corps. Ceci facilite la prise en compte des serveurs d'arrière-plan
 805     bogués qui oublient d'insérer une ligne vide entre les
 806     en-têtes et le corps.</dd>
 807     </dl>
 808
 809 </div>
 810 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 811 <div class="directive-section"><h2><a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a> <a name="proxyblock" id="proxyblock">Directive</a></h2>
 812 <table class="directive">
 813 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Termes, serveurs ou domaines bloqués par le
 814 mandataire</td></tr>
 815 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBlock *|<var>terme</var>|<var>serveur</var>|<var>domaine</var>
 816 [<var>terme</var>|<var>serveur</var>|<var>domaine</var>] ...</code></td></tr>
 817 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 818 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 819 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 820 </table>
 821     <p>La directive <code class="directive">ProxyBlock</code> permet de
 822     spécifier une liste de termes, serveurs et/ou domaines, séparés par
 823     des espaces. Les requêtes de documents HTTP, HTTPS, FTP vers des
 824     sites dont les noms contiennent des termes, noms de serveur ou
 825     domaine correspondants seront <em>bloqués</em> par le serveur
 826     mandataire. La module proxy va aussi tenter de déterminer les
 827     adresses IP des éléments de la liste qui peuvent correspondre à des
 828     noms d'hôtes au cours du démarrage, et les mettra en cache à des
 829     fins de comparaisons ultérieures. Ceci peut ralentir le démarrage du
 830     serveur.</p>
 831
 832     <div class="example"><h3>Exemple</h3><p><code>
 833       ProxyBlock news.example.com auctions.example.com friends.example.com
 834     </code></p></div>
 835
 836     <p>Notez qu'<code>example</code> suffirait aussi pour atteindre
 837     ces sites.</p>
 838
 839     <p>Hosts conviendrait aussi s'il était référencé par adresse IP.</p>
 840
 841     <p>Notez aussi que</p>
 842
 843     <div class="example"><p><code>
 844       ProxyBlock *
 845     </code></p></div>
 846
 847     <p>bloque les connexions vers tous les sites.</p>
 848
 849 </div>
 850 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 851 <div class="directive-section"><h2><a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a> <a name="proxydomain" id="proxydomain">Directive</a></h2>
 852 <table class="directive">
 853 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de domaine par défaut pour les requêtes
 854 mandatées</td></tr>
 855 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyDomain <var>Domaine</var></code></td></tr>
 856 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 857 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 858 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 859 </table>
 860     <p>Cette directive n'a d'utilité que pour les serveurs mandataires
 861     Apache httpd au sein d'un Intranet. La directive
 862     <code class="directive">ProxyDomain</code> permet de spécifier le domaine
 863     par défaut auquel le serveur mandataire apache appartient. Si le
 864     serveur reçoit une requête pour un hôte sans nom de domaine, il va
 865     générer une réponse de redirection vers le même hôte suffixé par le
 866     <var>Domaine</var> spécifié.</p>
 867
 868     <div class="example"><h3>Exemple</h3><p><code>
 869       ProxyRemote  *  http://firewall.example.com:81<br />
 870       NoProxy         .example.com 192.168.112.0/21<br />
 871       ProxyDomain     .example.com
 872     </code></p></div>
 873
 874 </div>
 875 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 876 <div class="directive-section"><h2><a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a> <a name="proxyerroroverride" id="proxyerroroverride">Directive</a></h2>
 877 <table class="directive">
 878 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Outrepasser les pages d'erreur pour les contenus
 879 mandatés</td></tr>
 880 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyErrorOverride On|Off</code></td></tr>
 881 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyErrorOverride Off</code></td></tr>
 882 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
 883 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 884 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 885 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0 d'Apache</td></tr>
 886 </table>
 887     <p>Cette directive est utile pour les configurations de mandataires
 888     inverses, lorsque vous souhaitez que les pages d'erreur envoyées
 889     aux utilisateurs finaux présentent un aspect homogène. Elle permet
 890     aussi l'inclusion de fichiers (via les SSI de
 891     <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>) pour obtenir le code d'erreur et agir
 892     en conséquence (le comportement par défaut afficherait la page
 893     d'erreur du serveur mandaté, alors que c'est le message d'erreur SSI
 894     qui sera affiché si cette directive est à "on").</p>
 895
 896     <p>Cette directive n'affecte pas le traitement des réponses
 897     informatives (1xx), de type succès normal (2xx), ou de redirection
 898     (3xx).</p>
 899
 900 </div>
 901 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 902 <div class="directive-section"><h2><a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a> <a name="proxyiobuffersize" id="proxyiobuffersize">Directive</a></h2>
 903 <table class="directive">
 904 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine la taille du tampon interne de transfert de
 905 données</td></tr>
 906 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyIOBufferSize <var>octets</var></code></td></tr>
 907 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyIOBufferSize 8192</code></td></tr>
 908 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 909 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 910 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 911 </table>
 912     <p>La directive <code class="directive">ProxyIOBufferSize</code> permet
 913     d'ajuster la taille du tampon interne utilisé comme bloc-note pour
 914     les transferts de données entre entrée et sortie. La taille minimale
 915     est de <code>512</code> octets.</p>
 916
 917     <p>Dans la plupart des cas, il n'y a aucune raison de modifier cette
 918     valeur.</p>
 919     <p>Si elle est utilisée avec AJP, cette directive permet de définir
 920     la taille maximale du paquet AJP en octets. Si vous ne conservez pas
 921     la valeur par défaut, vous devez aussi modifier l'attribut
 922     <code>packetSize</code> de votre connecteur AJP du côté de Tomcat !
 923     L'attribut <code>packetSize</code> n'est disponible que dans Tomcat
 924     <code>5.5.20+</code> et <code>6.0.2+</code>.</p>
 925     <p>Il n'est normalement pas nécessaire de modifier la taille
 926     maximale du paquet. Des problèmes ont cependant été rapportés avec
 927     la valeur par défaut lors de l'envoi de certificats ou de chaînes de
 928     certificats.</p>
 929
 930
 931 </div>
 932 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 933 <div class="directive-section"><h2><a name="ProxyMatch" id="ProxyMatch">&lt;ProxyMatch&gt;</a> <a name="proxymatch" id="proxymatch">Directive</a></h2>
 934 <table class="directive">
 935 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant à des ressources
 936 mandatées correspondant à une expression rationnelle</td></tr>
 937 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;ProxyMatch <var>regex</var>&gt; ...&lt;/ProxyMatch&gt;</code></td></tr>
 938 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 939 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 940 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 941 </table>
 942     <p>La directive <code class="directive">&lt;ProxyMatch&gt;</code> est
 943     identique à la directive <code class="directive"><a href="#proxy">&lt;Proxy&gt;</a></code>, à l'exception qu'elle définit
 944     les URLs auxquelles elle s'applique en utilisant une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p>
 945
 946 <h3>Voir aussi</h3>
 947 <ul>
 948 <li><code class="directive"><a href="#proxy">&lt;Proxy&gt;</a></code></li>
 949 </ul>
 950 </div>
 951 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 952 <div class="directive-section"><h2><a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a> <a name="proxymaxforwards" id="proxymaxforwards">Directive</a></h2>
 953 <table class="directive">
 954 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de mandataires à travers lesquelles une
 955 requête peut être redirigée</td></tr>
 956 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyMaxForwards <var>nombre</var></code></td></tr>
 957 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyMaxForwards -1</code></td></tr>
 958 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 959 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 960 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 961 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0 du serveur HTTP Apache ; comportement par défaut
 962 modifié dans 2.2.7/2.3</td></tr>
 963 </table>
 964     <p>La directive <code class="directive">ProxyMaxForwards</code> permet de
 965     spécifier le nombre maximum de mandataires à travers lesquels une
 966     requête peut passer dans le cas où la la requête ne contient pas
 967     d'en-tête <code>Max-Forwards</code>. Ceci permet de se prémunir
 968     contre les boucles infinies de mandataires ou contre les attaques de
 969     type déni de service.</p>
 970
 971     <div class="example"><h3>Exemple</h3><p><code>
 972       ProxyMaxForwards 15
 973     </code></p></div>
 974
 975     <p>Notez que la définition de la directive
 976     <code class="directive">ProxyMaxForwards</code> constitue une violation du
 977     protocole HTTP/1.1 (RFC2616), qui interdit à un mandataire de
 978     définir <code>Max-Forwards</code> si le client ne l'a pas fait
 979     lui-même. Les versions précédentes d'Apache httpd la définissaient
 980     systématiquement. Une valeur négative de
 981     <code class="directive">ProxyMaxForwards</code>, y compris la valeur par
 982     défaut -1, implique un comportement compatible avec le protocole,
 983     mais vous expose aux bouclages infinis.</p>
 984
 985 </div>
 986 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 987 <div class="directive-section"><h2><a name="ProxyPass" id="ProxyPass">ProxyPass</a> <a name="proxypass" id="proxypass">Directive</a></h2>
 988 <table class="directive">
 989 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Référencer des serveurs distants depuis
 990 l'espace d'URLs du serveur local</td></tr>
 991 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>clé=valeur</var>
 992   <var>[clé=valeur</var> ...]] [nocanon] [interpolate] [noquery]</code></td></tr>
 993 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
 994 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 995 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
 996 </table>
 997     <p>Cette directive permet de référencer des serveurs distants depuis
 998     l'espace d'URLs du serveur local ; le serveur
 999     local n'agit pas en tant que mandataire au sens conventionnel, mais
1000     plutôt comme miroir du serveur distant. Le serveur local est
1001     souvent nommé <dfn>mandataire inverse</dfn> ou
1002     <dfn>passerelle</dfn>. L'argument <var>chemin</var> est le nom d'un
1003     chemin virtuel local ; <var>url</var> est une URL partielle pour le
1004     serveur distant et ne doit pas contenir de chaîne d'arguments.</p>
1005
1006     <div class="warning">En général, la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> doit être définie à
1007     <strong>off</strong> lorsqu'on utilise la directive
1008     <code class="directive">ProxyPass</code>.</div>
1009
1010     <p>Supposons que le serveur local a pour adresse
1011     <code>http://example.com/</code> ; alors la ligne</p>
1012
1013     <div class="example"><p><code>
1014       &lt;Location /miroir/foo/&gt;<br />
1015         <span class="indent">
1016           ProxyPass http://backend.example.com/<br />
1017         </span>
1018         &lt;/Location&gt;<br />
1019     </code></p></div>
1020
1021     <p>va convertir en interne toute requête pour
1022     <code>http://example.com/miroir/foo/bar</code> en une requête
1023     mandatée pour <code>http://backend.example.com/bar</code>.</p>
1024
1025     <p>La syntaxe alternative suivante est valide, bien qu'elle puisse
1026     induire une dégradation des performances lorsqu'elle est
1027     présente en très grand nombre. Elle possède l'avantage de
1028     permettre un contrôle dynamique via l'interface <a href="mod_proxy_balancer.html#balancer_manager">Balancer Manager</a> :</p>
1029
1030     <div class="example"><p><code>
1031         ProxyPass /miroir/foo/ http://backend.example.com/
1032     </code></p></div>
1033
1034     <div class="warning">
1035     <p>Si le premier argument se termine par un slash
1036     <strong>/</strong>, il doit en être de même pour le second argument
1037     et vice versa. Dans le cas contraire, il risque de manquer des
1038     slashes nécessaires dans la requête résultante vers le serveur
1039     d'arrière-plan et les résulats ne seront pas ceux attendus.
1040     </p>
1041     </div>
1042
1043     <p>Le drapeau <code>!</code> permet de soustraire un sous-répertoire
1044     du mandat inverse, comme dans l'exemple suivant :</p>
1045
1046     <div class="example"><p><code>
1047       &lt;Location /miroir/foo/&gt;<br />
1048         <span class="indent">
1049           ProxyPass http://backend.example.com/<br />
1050         </span>
1051         &lt;/Location&gt;<br />
1052         &lt;Location /miroir/foo/i&gt;<br />
1053         <span class="indent">
1054             ProxyPass !<br />
1055         </span>
1056         &lt;/Location&gt;<br />
1057     </code></p></div>
1058
1059     <div class="example"><p><code>
1060       ProxyPass /miroir/foo/i !<br />
1061       ProxyPass /miroir/foo http://backend.example.com
1062     </code></p></div>
1063
1064     <p>va mandater toutes les requêtes pour <code>/miroir/foo</code>
1065     vers <code>backend.example.com</code>, <em>sauf</em> les requêtes
1066     pour <code>/miroir/foo/i</code>.</p>
1067
1068     <div class="warning"><h3>Ordre de classement des directives ProxyPass</h3>
1069       <p>Les directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> et <code class="directive"><a href="#proxypassmatch">ProxyPassMatch</a></code> sont évaluées dans
1070       l'ordre de leur apparition dans le fichier de configuration. La
1071       première règle qui correspond s'applique. Vous devez donc en
1072       général classer les règles <code class="directive"><a href="#proxypass">ProxyPass</a></code> qui entrent en conflit de
1073       l'URL la plus longue à la plus courte. Dans le cas contraire, les
1074       règles situées après une règle dont l'URL correspond au début de
1075       leur propre URL seront ignorées. Notez que tout ceci est en
1076       relation avec le partage de workers. Par contre, on ne peut placer
1077       qu'une seule directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> dans une section
1078       <code class="directive"><a href="../mod/core.html#location">Location</a></code>, et c'est la section
1079       la plus spécifique qui l'emportera.</p>
1080
1081       <p>Pour les mêmes raisons, les exclusions doivent se situer
1082       <em>avant</em> les directives <code class="directive">ProxyPass</code>
1083       générales.</p>
1084
1085     </div>
1086
1087     <p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
1088     les groupements de connexions vers un serveur d'arrière-plan. Les
1089     connexions créées à la demande peuvent être enregistrées dans un
1090     groupement pour une utilisation ultérieure. La taille du groupe
1091     ainsi que d'autres caractéristiques peuvent être définies via la
1092     directive <code class="directive">ProxyPass</code> au moyen de paramètres
1093     <code>clé=valeur</code> dont la description fait l'objet du tableau
1094     ci-dessous.</p>
1095
1096     <p>Par défaut, mod_proxy permet et met en réserve le nombre maximum
1097     de connexions pouvant être utilisées simultanément par le processus
1098     enfant concerné du serveur web. Le paramètre <code>max</code> permet
1099     de réduire cette valeur par défaut. Le paramètre <code>ttl</code>,
1100     quant à lui, permet de définir une durée de vie optionnelle ; les
1101     connexions qui n'ont pas été utilisées pendant au moins
1102     <code>ttl</code> secondes seront fermées. <code>ttl</code> permet
1103     aussi d'empêcher l'utilisation d'une connexion susceptible d'être
1104     fermée suite à une fin de vie de connexion persistante sur le
1105     serveur d'arrière-plan.</p>
1106
1107     <p>Le groupement de connexions est maintenu au niveau de chaque
1108     processus enfant du serveur web, et <code>max</code>, ainsi que les
1109     autres paramètres, ne font
1110     l'objet d'aucune coordination entre les différents processus
1111     enfants, sauf si un seul processus enfant est autorisé par la
1112     configuration ou la conception du module multi-processus (MPM).</p>
1113
1114     <div class="example"><h3>Exemple</h3><p><code>
1115         ProxyPass /example http://backend.example.com max=20 ttl=120 retry=300
1116     </code></p></div>
1117
1118     <table class="bordered"><tr><th>Paramètres de BalancerMember</th></tr></table>
1119     <table>
1120     <tr><th>Paramètre</th>
1121         <th>Défaut</th>
1122         <th>Description</th></tr>
1123     <tr><td>min</td>
1124         <td>0</td>
1125         <td>Nombre minimum d'entrées dans le pool de connexions,
1126         distinct du nombre de connexions effectif. La valeur par défaut
1127         ne doit être modifiée que dans des circonstances particulières
1128         où la mémoire associée aux connexions avec le serveur
1129         d'arrière-plan doit être préallouée ou réservée dans le tas.</td></tr>
1130     <tr><td>max</td>
1131         <td>1...n</td>
1132         <td>Nombre maximum de connexions autorisées vers le serveur
1133         d'arrière-plan. La valeur par défaut correspond au nombre de
1134         threads par processus pour le MPM (Module Multi Processus)
1135         actif. La valeur sera toujours 1 pour le MPM Prefork, alors
1136         qu'elle dépendra de la définition de la directive
1137         <code class="directive">ThreadsPerChild</code> pour les autres MPMs.</td></tr>
1138     <tr><td>smax</td>
1139         <td>max</td>
1140         <td>Les entrées du pool de connexions conservées au delà de
1141         cette limite sont libérées au cours de certaines opérations si
1142         elles n'ont pas été utilisées au cours de leur durée de vie,
1143         définie par le paramètre <code>ttl</code>. Si l'entrée du pool
1144         de connexions est associée à une connexion, cette dernière sera
1145         fermée. La valeur par défaut ne doit être modifiée que dans des
1146         circonstances particulières où les entrées du pool de connexions
1147         et toutes connexions associées qui ont dépassé leur durée de vie
1148         doivent être libérées ou fermées de manière plus autoritaire.</td></tr>
1149     <tr><td>acquire</td>
1150         <td>-</td>
1151         <td>Cette clé permet de définir le délai maximum d'attente pour
1152         une connexion libre dans le jeu de connexions, en millisecondes.
1153         S'il n'y a pas de connexion libre dans le jeu, Apache httpd renverra
1154         l'état <code>SERVER_BUSY</code> au client.
1155     </td></tr>
1156     <tr><td>connectiontimeout</td>
1157         <td>timeout</td>
1158         <td>Délai d'attente d'une connexion en secondes.
1159         La durée en secondes pendant laquelle Apache httpd va attendre pour
1160         l'établissement d'une connexion vers le serveur d'arrière-plan.
1161         Le délai peut être spécifié en millisecondes en ajoutant le
1162         suffixe ms.
1163     </td></tr>
1164     <tr><td>disablereuse</td>
1165         <td>Off</td>
1166         <td>Vous pouvez utiliser cette clé pour forcer mod_proxy à
1167         fermer immédiatement une connexion vers le serveur
1168         d'arrière-plan après utilisation, et ainsi désactiver le jeu de
1169         connexions permanentes vers ce serveur. Ceci peut s'avérer utile
1170         dans des situations où un pare-feu situé entre Apache httpd et le
1171         serveur d'arrière-plan (quelque soit le protocole) interrompt
1172         des connexions de manière silencieuse, ou lorsque le serveur
1173         d'arrière-plan lui-même est accessible par rotation de DNS
1174         (round-robin DNS). Pour désactiver la réutilisation du jeu de
1175         connexions, définissez cette clé à <code>On</code>.
1176     </td></tr>
1177     <tr><td>flushpackets</td>
1178         <td>off</td>
1179         <td>Permet de définir si le module mandataire doit vider
1180         automatiquement le tampon de sortie après chaque tronçon de
1181         données. 'off' signifie que le tampon sera vidé si nécessaire,
1182         'on' que le tampon sera vidé après chaque envoi d'un
1183         tronçon de données, et 'auto' que le tampon sera vidé après un
1184         délai de 'flushwait' millisecondes si aucune entrée n'est reçue.
1185         Actuellement, cette clé n'est supportée que par AJP.
1186     </td></tr>
1187     <tr><td>flushwait</td>
1188         <td>10</td>
1189         <td>Le délai d'attente pour une entrée additionnelle, en
1190         millisecondes, avant le vidage du tampon en sortie dans le cas
1191         où 'flushpackets' est à 'auto'.
1192     </td></tr>
1193     <tr><td>iobuffersize</td>
1194         <td>8192</td>
1195         <td>Permet de définir la taille du tampon d'entrées/sorties du
1196         bloc-notes interne. Cette clé vous permet d'outrepasser la
1197         directive <code class="directive">ProxyIOBufferSize</code> pour un
1198         serveur cible spécifique. La valeur doit être au minimum 512 ou définie
1199         à 0 pour la valeur par défaut du système de 8192.
1200     </td></tr>
1201     <tr><td>keepalive</td>
1202         <td>Off</td>
1203         <td><p>Cette clé doit être utilisée lorsque vous avez un pare-feu
1204         entre Apache httpd et le serveur d'arrière-plan, et si ce dernier tend
1205         à interrompre les connexions inactives. Cette clé va faire en
1206         sorte que le système d'exploitation envoie des messages
1207         <code>KEEP_ALIVE</code> sur chacune des connexions inactives et
1208         ainsi éviter la fermeture de la connexion par le pare-feu.
1209         Pour conserver les connexions persistantes, definissez cette
1210         propriété à <code>On</code>.</p>
1211     <p>La fréquence de vérification des connexions TCP persistantes
1212     initiale et subséquentes dépend de la configuration globale de l'OS,
1213     et peut atteindre 2 heures. Pour être utile, la fréquence configurée
1214     dans l'OS doit être inférieure au seuil utilisé par le pare-feu.</p>
1215
1216     </td></tr>
1217     <tr><td>lbset</td>
1218         <td>0</td>
1219         <td>Définit le groupe de répartition de charge dont le serveur cible
1220         est membre. Le répartiteur de charge va essayer tous les membres
1221         d'un groupe de répartition de charge de numéro inférieur avant
1222         d'essayer ceux dont le groupe possède un numéro supérieur.
1223     </td></tr>
1224     <tr><td>ping</td>
1225         <td>0</td>
1226         <td>Avec la clé Ping, le serveur web va "tester" la connexion
1227         vers le serveur d'arrière-plan avant de transmettre la requête.
1228         Avec AJP, <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> envoie une requête
1229         <code>CPING</code> sur la connexion ajp13 (implémenté sur Tomcat
1230         3.3.2+, 4.1.28+ et 5.0.13+). Avec HTTP,
1231         <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> envoie <code>100-Continue</code>
1232         au serveur d'arrière-plan (seulement avecHTTP/1.1 - pour les
1233         serveurs d'arrière-plan non HTTP/1.1, cette clé ne produit
1234         aucun effet). Dans les deux cas, ce paramètre correspond au
1235         délai en secondes pour l'attente de la réponse. Cette
1236         fonctionnalité a été ajoutée pour éviter les problèmes avec les
1237         serveurs d'arrière-plan bloqués ou surchargés.
1238
1239         Le trafic
1240         réseau peut s'en trouver augmenté en fonctionnement normal, ce
1241         qui peut poser problème, mais peut s'en trouver diminué dans les
1242         cas où les noeuds de cluster sont arrêtés ou
1243         surchargés. Le délai peut
1244         aussi être défini en millisecondes en ajoutant le suffixe
1245         ms.
1246     </td></tr>
1247     <tr><td>receivebuffersize</td>
1248         <td>0</td>
1249         <td>Définit la taille du tampon réseau explicite (TCP/IP) pour
1250         les connexions mandatées. Cette clé vous permet d'outrepasser la
1251         directive <code class="directive">ProxyReceiveBufferSize</code> pour un
1252         serveur cible spécifique. Sa valeur doit être au minimum 512 ou définie
1253         à 0 pour la valeur par défaut du système.
1254     </td></tr>
1255     <tr><td>redirect</td>
1256         <td>-</td>
1257         <td>Route pour la redirection du serveur cible. Cette valeur est en
1258         général définie dynamiquement pour permettre une suppression
1259         sécurisée du noeud du cluster. Si cette clé est définie, toutes
1260         les requêtes sans identifiant de session seront redirigées vers
1261         le membre de groupe de répartition de charge dont la route
1262         correspond à la valeur de la clé.
1263     </td></tr>
1264     <tr><td>retry</td>
1265         <td>60</td>
1266         <td>Délai entre deux essais du serveur cible du jeu de connexions en
1267         secondes. Si le serveur cible du jeu de connexions vers le serveur
1268         d'arrière-plan est dans un état d'erreur, Apache httpd ne redirigera
1269         pas de requête vers ce serveur avant l'expiration du délai
1270         spécifié. Ceci permet d'arrêter le serveur d'arrière-plan pour
1271         maintenance, et de le remettre en ligne plus tard. Une valeur de
1272         0 implique de toujours essayer les serveurs cibles dans un état d'erreur
1273         sans délai.
1274     </td></tr>
1275     <tr><td>route</td>
1276         <td>-</td>
1277         <td>La route du serveur cible lorsqu'il est utilisé au sein d'un
1278         répartiteur de charge. La route est une valeur ajoutée à
1279         l'identifiant de session.
1280     </td></tr>
1281     <tr><td>status</td>
1282         <td>-</td>
1283         <td>Valeur constituée d'une simple lettre et définissant l'état
1284         initial de ce serveur cible.
1285          <table>
1286          <tr><td>D: le serveur cible est désactivé et n'accepte aucune requête.</td></tr>
1287          <tr><td>S: le serveur cible est arrêté.</td></tr>
1288          <tr><td>I: le serveur cible est en mode "erreurs ignorées",
1289          et sera toujours considéré comme disponible.</td></tr>
1290          <tr><td>H: le serveur cible est en mode d'attente et ne sera
1291          utilisé que si aucun autre serveur n'est disponible.</td></tr>
1292          <tr><td>E: le serveur cible est en erreur.</td></tr>
1293          <tr><td>N: le serveur cible est en mode vidage, n'acceptera que
1294          les sessions persistantes qui lui appartiennent, et refusera
1295          toutes les autres requêtes.</td></tr>
1296         </table>
1297         Une valeur d'état peut être définie (ce qui
1298         correspond au comportement par défaut) en préfixant la valeur
1299         par '+', ou annulée en préfixant la valeur par '-'. Ainsi, la
1300         valeur 'S-E' définit l'état de ce serveur cible à "arrêté" et supprime
1301         le drapeau "en-erreur".
1302     </td></tr>
1303     <tr><td>timeout</td>
1304         <td><code class="directive"><a href="#proxytimeout">ProxyTimeout</a></code></td>
1305         <td>Délai d'attente de la connexion en secondes. Le nombre de
1306         secondes pendant lesquelles Apache httpd attend l'envoi de
1307         données vers le serveur d'arrière-plan.
1308     </td></tr>
1309     <tr><td>ttl</td>
1310         <td>-</td>
1311         <td>Durée de vie des connexions inactives et des entrées du pool
1312         de connexions associées en secondes. Une fois cette
1313         limite atteinte, une connexion ne sera pas réutilisée ; elle
1314         sera fermée après un délai variable.
1315     </td></tr>
1316
1317     </table>
1318
1319     <p>Si l'URL de la directive Proxy débute par
1320     <code>balancer://</code> (par exemple:
1321     <code>balancer://cluster/</code>, toute information relative au
1322     chemin est ignorée), alors un serveur cible virtuel ne communiquant pas
1323     réellement avec le serveur d'arrière-plan sera créé. Celui-ci sera
1324     en fait responsable de la gestion de plusieurs serveurs cibles "réels". Dans
1325     ce cas, un jeu de paramètres particuliers s'applique à ce serveur cible
1326     virtuel. Voir <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus
1327     d'informations à propos du fonctionnement du répartiteur de
1328     charge.
1329     </p>
1330     <table class="bordered"><tr><th>Paramètres du répartiteur</th></tr></table>
1331     <table>
1332     <tr><th>Paramètre</th>
1333         <th>Défaut</th>
1334         <th>Description</th></tr>
1335     <tr><td>lbmethod</td>
1336         <td>byrequests</td>
1337         <td>Méthode de répartition de charge utilisée. Permet de
1338         sélectionner la méthode de planification de la répartition de
1339         charge à utiliser. La valeur est soit <code>byrequests</code>,
1340         pour effectuer un décompte de requêtes pondérées, soit
1341         <code>bytraffic</code>, pour effectuer une répartition en
1342         fonction du décompte des octets transmis, soit
1343         <code>bybusyness</code>, pour effectuer une répartition en
1344         fonction des requêtes en attente. La valeur par défaut est
1345         <code>byrequests</code>.
1346     </td></tr>
1347     <tr><td>maxattempts</td>
1348         <td>1 de moins que le nombre de workers, ou 1 avec un seul
1349         worker</td>
1350         <td>Nombre maximum d'échecs avant abandon.
1351     </td></tr>
1352     <tr><td>nofailover</td>
1353         <td>Off</td>
1354         <td>Si ce paramètre est défini à <code>On</code>, la session va
1355         s'interrompre si le serveur cible est dans un état d'erreur ou
1356         désactivé. Définissez ce paramètre à On si le serveur
1357         d'arrière-plan ne supporte pas la réplication de session.
1358     </td></tr>
1359     <tr><td>stickysession</td>
1360         <td>-</td>
1361         <td>Nom de session persistant du répartiteur. La valeur est
1362         généralement du style <code>JSESSIONID</code> ou
1363         <code>PHPSESSIONID</code>, et dépend du serveur d'application
1364         d'arrière-plan qui supporte les sessions. Si le serveur
1365         d'application d'arrière-plan utilise des noms différents pour
1366         les cookies et les identifiants codés d'URL (comme les
1367         conteneurs de servlet), séparez-les par le caractère '|'. La
1368         première partie contient le cookie et la seconde le chemin.
1369     </td></tr>
1370     <tr><td>scolonpathdelim</td>
1371         <td>Off</td>
1372         <td>Si ce paramètre est défini à <code>On</code>, le caractère
1373         ';' sera utilisé comme séparateur de chemin de session
1374         persistante additionnel. Ceci permet principalement de simuler
1375         le comportement de mod_jk lorsqu'on utilise des chemins du style
1376         <code>JSESSIONID=6736bcf34;foo=aabfa</code>.
1377     </td></tr>
1378     <tr><td>timeout</td>
1379         <td>0</td>
1380         <td>Délai du répartiteur en secondes. Si ce paramètre est
1381         défini, sa valeur correspond à la durée maximale d'attente pour
1382         un serveur cible libre. Le comportement par défaut est de ne pas
1383         attendre.
1384     </td></tr>
1385     <tr><td>failonstatus</td>
1386         <td>-</td>
1387         <td>Une liste de codes d'état HTTP séparés par des virgules. Si
1388         ce paramètre est présent, le worker se mettra en erreur si le
1389         serveur d'arrière-plan renvoie un des codes d'état spécifiés
1390         dans la liste. La récupération du worker s'effectue comme dans
1391         le cas des autres erreurs de worker.
1392     </td></tr>
1393
1394     <tr><td>nonce</td>
1395         <td>&lt;auto&gt;</td>
1396         <td>Le nombre à usage unique de protection utilisé dans la page
1397         de l'application <code>balancer-manager</code>. Par défaut, la
1398         protection de la page est assurée par un nombre à usage unique
1399         automatique à base d'UUID. Si une valeur est précisée, elle sera
1400         utilisée comme nombre à usage unique. La valeur
1401         <code>None</code> désactive la vérification du nombre à usage
1402         unique.
1403     <div class="note"><h3>Note</h3>
1404       <p>En plus du nombre à usage unique, la page de l'application
1405       <code>balancer-manager</code> peut être protégée par une ACL.</p>
1406     </div>
1407      </td></tr>
1408     <tr><td>growth</td>
1409         <td>0</td>
1410         <td>Nombre de membres supplémentaires que l'on peut ajouter à ce
1411         répartiteur en plus de ceux définis au niveau de la
1412         configuration.
1413     </td></tr>
1414
1415     </table>
1416     <p>Exemple de configuration d'un répartiteur de charge</p>
1417     <div class="example"><p><code>
1418       ProxyPass /zone-speciale http://special.example.com smax=5 max=10<br />
1419       ProxyPass / balancer://mon-cluster/ stickysession=JSESSIONID|jsessionid nofailover=On<br />
1420       &lt;Proxy balancer://mon-cluster&gt;<br />
1421       <span class="indent">
1422         BalancerMember ajp://1.2.3.4:8009<br />
1423         BalancerMember ajp://1.2.3.5:8009 loadfactor=20<br />
1424         # Serveur moins puissant ; faites-lui traiter moins de requêtes,<br />
1425         BalancerMember ajp://1.2.3.6:8009 loadfactor=5<br />
1426       </span>
1427       &lt;/Proxy&gt;
1428     </code></p></div>
1429
1430     <p>Configuration d'un serveur cible de réserve qui ne sera utilisé que si
1431     aucun autre serveur cible n'est disponible</p>
1432     <div class="example"><p><code>
1433       ProxyPass / balancer://hotcluster/ <br />
1434       &lt;Proxy balancer://hotcluster&gt;<br />
1435       <span class="indent">
1436         BalancerMember ajp://1.2.3.4:8009 loadfactor=1<br />
1437         BalancerMember ajp://1.2.3.5:8009 loadfactor=2<br />
1438         # La ligne suivante configure le serveur cible de réserve<br />
1439         BalancerMember ajp://1.2.3.6:8009 status=+H<br />
1440         ProxySet lbmethod=bytraffic
1441       </span>
1442       &lt;/Proxy&gt;
1443     </code></p></div>
1444
1445     <p>Normalement, mod_proxy va mettre sous leur forme canonique les
1446     URLs traitées par ProxyPass. Mais ceci peut être incompatible avec
1447     certains serveurs d'arrière-plan, et en particulier avec ceux qui
1448     utilisent <var>PATH_INFO</var>. Le mot-clé optionnel
1449     <var>nocanon</var> modifie ce comportement et permet de transmettre
1450     le chemin d'URL sous sa forme brute au serveur d'arrière-plan. Notez
1451     que ceci peut affecter la sécurité de votre serveur d'arrière-plan,
1452     car la protection limitée contre les attaques à base d'URL que
1453     fournit le mandataire est alors supprimée.</p>
1454
1455     <p>Le mot-clé optionnel <var>interpolate</var> (disponible depuis
1456     httpd 2.2.9), en combinaison avec la directive
1457     <code class="directive">ProxyPassInterpolateEnv</code>, permet à ProxyPass
1458     d'interpoler les variables d'environnement à l'aide de la syntaxe
1459     <var>${VARNAME}</var>. Notez que de nombreuses variables
1460     d'environnement standard dérivées de CGI n'existeront pas lorsque
1461     l'interpolation se produit ; vous devrez alors encore avoir avoir
1462     recours à <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour des règles
1463     complexes.</p>
1464
1465     <p>Par défaut, mod_proxy inclut la chaîne de paramètres lors de la
1466     génération de la variable d'environnement
1467     <var>SCRIPT_FILENAME</var>. Le mot-clé optionnel <var>noquery</var>
1468     (disponible à partir de la version 2.4.1) permet d'exclure cette
1469     chaîne.</p>
1470
1471     <p>Lorsque la directive ProxyPass est utilisée à l'intérieur d'une
1472     section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>, le premier argument est omis et le répertoire
1473     local est obtenu à partir de la section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>. Il en sera de même dans une
1474     section <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> ; cependant, ProxyPass
1475     n'interprète pas les expressions rationnelles, et il sera ici
1476     nécessaire d'utiliser la directive
1477     <code class="directive">ProxyPassMatch</code> à la place.</p>
1478
1479     <p>Cette directive ne peut pas être placée dans une section
1480     <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> ou
1481     <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>.</p>
1482
1483     <p>Si vous avez besoin d'un configuration de mandataire inverse plus
1484     souple, reportez-vous à la documentaion de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau
1485     <code>[P]</code>.</p>
1486
1487
1488 </div>
1489 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1490 <div class="directive-section"><h2><a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a> <a name="proxypassinterpolateenv" id="proxypassinterpolateenv">Directive</a></h2>
1491 <table class="directive">
1492 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'interpolation des variables d'environnement dans
1493 les configurations de mandataires inverses</td></tr>
1494 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInterpolateEnv On|Off</code></td></tr>
1495 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyPassInterpolateEnv Off</code></td></tr>
1496 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1497 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1498 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1499 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.9 d'Apache</td></tr>
1500 </table>
1501     <p>Cette directive, ainsi que l'argument <var>interpolate</var> des
1502     directives <code class="directive">ProxyPass</code>,
1503     <code class="directive">ProxyPassReverse</code>,
1504     <code class="directive">ProxyPassReverseCookieDomain</code> et
1505     <code class="directive">ProxyPassReverseCookiePath</code>, permet de
1506     configurer dynamiquement un mandataire inverse à l'aide de
1507     variables d'environnement, ces dernières pouvant être définies par un
1508     autre module comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Elle affecte les
1509     directives <code class="directive">ProxyPass</code>,
1510     <code class="directive">ProxyPassReverse</code>,
1511     <code class="directive">ProxyPassReverseCookieDomain</code>, et
1512     <code class="directive">ProxyPassReverseCookiePath</code>, en leur indiquant
1513     de remplacer la chaîne <code>${nom_var}</code> dans les directives
1514     de configuration par la valeur de la variable d'environnement
1515     <code>nom_var</code> (si l'option <var>interpolate</var> est
1516     spécifiée).</p>
1517     <p>Conservez cette directive à off (pour les performances du
1518     serveur), sauf si vous en avez réellement besoin.</p>
1519
1520 </div>
1521 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1522 <div class="directive-section"><h2><a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a> <a name="proxypassmatch" id="proxypassmatch">Directive</a></h2>
1523 <table class="directive">
1524 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre des serveurs distants dans l'espace d'URL
1525 du serveur local en utilisant des expressions rationnelles</td></tr>
1526 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var>
1527 [<var>clé=valeur</var>
1528         <var>[clé=valeur</var> ...]]</code></td></tr>
1529 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1530 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1531 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1532 </table>
1533     <p>Cette directive est identique à la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>, mais fait usage des
1534     expressions rationnelles, au lieu d'une simple comparaison de
1535     préfixes. L'expression rationnelle spécifiée est comparée à
1536     l'<var>url</var>, et si elle correspond, le serveur va substituer
1537     toute correspondance entre parenthèses dans la chaîne donnée et
1538     l'utiliser comme nouvelle <var>url</var>.</p>
1539
1540     <p>Supposons que le serveur local a pour adresse
1541     <code>http://example.com/</code> ; alors</p>
1542
1543     <div class="example"><p><code>
1544       ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com$1
1545     </code></p></div>
1546
1547     <p>va provoquer la conversion interne de la requête locale
1548     <code>http://example.com/foo/bar.gif</code> en une requête mandatée
1549     pour <code>http://backend.example.com/foo/bar.gif</code>.</p>
1550
1551     <div class="note"><h3>Note</h3>
1552       <p>L'argument URL doit pouvoir être interprété en tant qu'URL
1553       <em>avant</em> les substitutions d'expressions rationnelles (et
1554       doit aussi l'être après). Ceci limite les correspondances que vous
1555       pouvez utiliser. Par exemple, si l'on avait utilisé</p>
1556       <div class="example"><p><code>
1557         ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com:8000$1
1558       </code></p></div>
1559       <p>dans l'exemple précédent, nous aurions provoqué une erreur de
1560       syntaxe au démarrage du serveur. C'est une bogue (PR 46665 dans
1561       ASF bugzilla), et il est possible de la contourner en reformulant
1562       la correspondance :</p>
1563       <div class="example"><p><code>
1564         ProxyPassMatch ^/(.*\.gif)$ http://backend.example.com:8000/$1
1565       </code></p></div>
1566     </div>
1567
1568     <p>Le drapeau <code>!</code> vous permet de ne pas mandater un
1569     sous-répertoire donné.</p>
1570
1571     <p>Dans une section <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>, le premier argument est
1572     omis et l'expression rationnelle est obtenue à partir de la directive
1573     <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>.</p>
1574
1575     <p>Si vous avez besoin d'une configuration du mandataire inverse
1576     plus flexible, voyez la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> avec le drapeau
1577     <code>[P]</code>.</p>
1578
1579     <div class="warning">
1580       <h3>Avertissement à propos de la sécurité</h3>
1581       <p>Lors de la construction de l'URL cible de la règle, il convient
1582       de prendre en compte l'impact en matière de sécurité qu'aura le
1583       fait de permettre au client d'influencer le jeu d'URLs pour
1584       lesquelles votre serveur agira en tant que mandataire.
1585       Assurez-vous que la partie protocole://nom-serveur de l'URL soit
1586       fixe, ou ne permette pas au client de l'influencer induement.</p>
1587     </div>
1588
1589 </div>
1590 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1591 <div class="directive-section"><h2><a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a> <a name="proxypassreverse" id="proxypassreverse">Directive</a></h2>
1592 <table class="directive">
1593 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste l'URL dans les en-têtes de la réponse HTTP envoyée
1594 par un serveur mandaté en inverse</td></tr>
1595 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverse [<var>chemin</var>] <var>url</var>
1596 [<var>interpolate</var>]</code></td></tr>
1597 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1598 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1599 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1600 </table>
1601     <p>Cette directive permet de faire en sorte qu'Apache httpd ajuste l'URL
1602     dans les en-têtes <code>Location</code>,
1603     <code>Content-Location</code> et <code>URI</code> des réponses de
1604     redirection HTTP. Ceci est essentiel lorsqu'Apache httpd est utilisé en
1605     tant que mandataire inverse (ou passerelle), afin d'éviter de
1606     court-circuiter le mandataire inverse suite aux redirections HTTP
1607     sur le serveur d'arrière-plan qui restent derrière le mandataire
1608     inverse.</p>
1609
1610     <p>Seuls les en-têtes de réponse HTTP spécialement mentionnés
1611     ci-dessus seront réécrits. Apache httpd ne réécrira ni les autres en-têtes
1612     de réponse, ni les références d'URLs dans les pages HTML. Cela
1613     signifie que dans le cas où un contenu mandaté contient des
1614     références à des URLs absolues, elles court-circuiteront le
1615     mandataire. Le module <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
1616     de Nick Kew est un module tiers qui parcourt le code HTML et réécrit
1617     les références d'URL.</p>
1618
1619     <p><var>chemin</var> est le nom d'un chemin virtuel local.
1620     <var>url</var> est une URL partielle pour le serveur distant - ils
1621     sont utilisés de la même façon qu'avec la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1622
1623     <p>Supposons par exemple que le serveur local a pour adresse
1624     <code>http://example.com/</code> ; alors</p>
1625
1626     <div class="example"><p><code>
1627       ProxyPass         /miroir/foo/ http://backend.example.com/<br />
1628       ProxyPassReverse  /miroir/foo/ http://backend.example.com/<br />
1629       ProxyPassReverseCookieDomain  backend.example.com  public.example.com<br />
1630       ProxyPassReverseCookiePath  /  /miroir/foo/
1631     </code></p></div>
1632
1633     <p>ne va pas seulement provoquer la conversion interne d'une requête
1634     locale pour <code>http://example.com/miroir/foo/bar</code> en une
1635     requête mandatée pour <code>http://backend.example.com/bar</code>
1636     (la fonctionnalité fournie par <code>ProxyPass</code>). Il va
1637     aussi s'occuper des redirections que le serveur
1638     <code>backend.example.com</code> envoie : lorsque
1639     <code>http://backend.example.com/bar</code> est redirigé par
1640     celui-ci vers <code>http://backend.example.com/quux</code>, Apache
1641     httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>
1642     avant de faire suivre la redirection HTTP au client. Notez que le
1643     nom d'hôte utilisé pour construire l'URL est choisi en respectant la
1644     définition de la directive <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</p>
1645
1646     <p>Notez que la directive <code class="directive">ProxyPassReverse</code>
1647     peut aussi être utilisée en conjonction avec la fonctionnalité
1648     pass-through (<code>RewriteRule ...  [P]</code>) du module
1649     <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, car elle ne dépend pas d'une directive
1650     <code class="directive"><a href="#proxypass">ProxyPass</a></code>
1651     correspondante.</p>
1652
1653     <p>Le mot-clé optionnel <var>interpolate</var> (disponible depuis
1654     httpd 2.2.9), utilisé en combinaison avec la directive
1655     <code class="directive">ProxyPassInterpolateEnv</code>, permet
1656     l'interpolation des variables d'environnement spécifiées en
1657     utilisant le format <var>${VARNAME}</var>.
1658     </p>
1659
1660     <p>Lorsque cette directive est utilisée dans une section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>, le premier
1661     argument est omis et le répertoire local est obtenu à partir de
1662     l'argument de la directive <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code>. Il en est de même à l'intérieur
1663     d'une section <code class="directive"><a href="../mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>, mais le résultat ne sera
1664     probablement pas celui attendu car ProxyPassReverse va interpréter
1665     l'expression rationnelle littéralement comme un chemin ; si besoin
1666     est dans ce cas, définissez la directive ProxyPassReverse en dehors
1667     de la section, ou dans une section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> séparée.</p>
1668
1669     <p>Cette directive ne peut pas être placée dans une section
1670     <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> ou
1671     <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>.</p>
1672
1673 </div>
1674 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1675 <div class="directive-section"><h2><a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a> <a name="proxypassreversecookiedomain" id="proxypassreversecookiedomain">Directive</a></h2>
1676 <table class="directive">
1677 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la chaîne correspondant au domaine dans les en-têtes
1678 Set-Cookie en provenance d'un serveur mandaté</td></tr>
1679 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookieDomain <var>domaine-interne</var>
1680 <var>domaine-public</var> [<var>interpolate</var>]</code></td></tr>
1681 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1682 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1683 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1684 </table>
1685 <p>L'utilisation de cette directive est similaire à celle de la
1686 directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>,
1687 mais au lieu de réécrire des en-têtes qui contiennent des URLs, elle
1688 réécrit la chaîne correspondant au domaine dans les en-têtes
1689 <code>Set-Cookie</code>.</p>
1690
1691 </div>
1692 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1693 <div class="directive-section"><h2><a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a> <a name="proxypassreversecookiepath" id="proxypassreversecookiepath">Directive</a></h2>
1694 <table class="directive">
1695 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la chaîne correspondant au chemin dans les en-têtes
1696 Set-Cookie en provenance d'un serveur mandaté</td></tr>
1697 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookiePath <var>chemin-interne</var>
1698 <var>chemin-public</var> [<var>interpolate</var>]</code></td></tr>
1699 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1700 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1701 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1702 </table>
1703 <p>
1704 Cette directive s'avère utile en conjonction avec la directive
1705 <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code> dans les
1706 situations où les chemins d'URL d'arrière-plan correspondent à des
1707 chemins publics sur le mandataire inverse. Cette directive permet de
1708 réécrire la chaîne <code>path</code> dans les en-têtes
1709 <code>Set-Cookie</code>. Si le début du chemin du cookie correspond à
1710 <var>chemin-interne</var>, le chemin du cookie sera remplacé par
1711 <var>chemin-public</var>.
1712 </p><p>
1713 Dans l'exemple fourni avec la directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, la directive :
1714 </p>
1715     <div class="example"><p><code>
1716       ProxyPassReverseCookiePath  /  /mirror/foo/
1717     </code></p></div>
1718 <p>
1719 va réécrire un cookie possédant un chemin d'arrière-plan <code>/</code>
1720 (ou <code>/example</code> ou en fait tout chemin)
1721 en <code>/mirror/foo/</code>..
1722 </p>
1723
1724 </div>
1725 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1726 <div class="directive-section"><h2><a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a> <a name="proxypreservehost" id="proxypreservehost">Directive</a></h2>
1727 <table class="directive">
1728 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise l'en-tête de requête entrante Host pour la requête
1729 du mandataire</td></tr>
1730 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPreserveHost On|Off</code></td></tr>
1731 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyPreserveHost Off</code></td></tr>
1732 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
1733 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1734 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1735 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0.31 du serveur HTTP Apache. Utilisable
1736 dans un contexte de répertoire depuis la version 2.3.3.</td></tr>
1737 </table>
1738     <p>Lorsqu'elle est activée, cette directive va transmettre l'en-tête
1739     Host: de la requête entrante vers le serveur mandaté, au lieu du nom
1740     d'hôte spécifié par la directive <code class="directive">ProxyPass</code>.</p>
1741
1742     <p>Cette directive est habituellement définie à <code>Off</code>.
1743     Elle est principalement utile dans les configurations particulières
1744     comme l'hébergement virtuel mandaté en masse à base de nom, où
1745     l'en-tête Host d'origine doit être évalué par le serveur
1746     d'arrière-plan.</p>
1747
1748 </div>
1749 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1750 <div class="directive-section"><h2><a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a> <a name="proxyreceivebuffersize" id="proxyreceivebuffersize">Directive</a></h2>
1751 <table class="directive">
1752 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon réseau pour les connexions mandatées HTTP
1753 et FTP</td></tr>
1754 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyReceiveBufferSize <var>octets</var></code></td></tr>
1755 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyReceiveBufferSize 0</code></td></tr>
1756 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1757 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1758 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1759 </table>
1760     <p>La directive <code class="directive">ProxyReceiveBufferSize</code> permet
1761     de spécifier une taille de tampon réseau explicite (TCP/IP) pour les
1762     connexions mandatées HTTP et FTP, afin d'améliorer le débit de
1763     données. Elle doit être supérieure à <code>512</code> ou définie à
1764     <code>0</code> pour indiquer que la taille de tampon par défaut du
1765     système doit être utilisée.</p>
1766
1767     <div class="example"><h3>Exemple</h3><p><code>
1768       ProxyReceiveBufferSize 2048
1769     </code></p></div>
1770
1771 </div>
1772 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1773 <div class="directive-section"><h2><a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a> <a name="proxyremote" id="proxyremote">Directive</a></h2>
1774 <table class="directive">
1775 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mandataire distant à utiliser pour traiter certaines
1776 requêtes</td></tr>
1777 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemote <var>comparaison</var> <var>serveur-distant</var></code></td></tr>
1778 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1779 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1780 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1781 </table>
1782     <p>Cette directive permet de définir des mandataires distants pour
1783     ce mandataire. <var>comparaison</var> est soit le nom d'un protocole
1784     que supporte le serveur distant, soit une URL partielle pour
1785     laquelle le serveur distant devra être utilisé, soit <code>*</code>
1786     pour indiquer que le serveur distant doit être utilisé pour toutes
1787     les requêtes. <var>serveur-distant</var> est une URL partielle
1788     correspondant au serveur distant. Syntaxe : </p>
1789
1790     <div class="example"><p><code>
1791       <dfn>serveur-distant</dfn> =
1792           <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>]
1793     </code></p></div>
1794
1795     <p><var>protocole</var> est effectivement le protocole à utiliser
1796     pour communiquer avec le serveur distant ; ce module ne supporte que
1797     <code>http</code> et <code>https</code>. Lorsqu'on utilise
1798     <code>https</code>, les requêtes sont redirigées par le mandataire
1799     distant en utilisant la méthode HTTP CONNECT.</p>
1800
1801     <div class="example"><h3>Exemple</h3><p><code>
1802       ProxyRemote http://bons-gars.example.com/ http://gars-mirroirs.example.com:8000<br />
1803       ProxyRemote * http://mandataire-intelligent.localdomain<br />
1804       ProxyRemote ftp http://mandataire-ftp.mon-domaine:8080
1805     </code></p></div>
1806
1807     <p>Dans la dernière ligne de l'exemple, le mandataire va faire
1808     suivre les requêtes FTP, encapsulées dans une autre requête mandatée
1809     HTTP, vers un autre mandataire capable de les traiter.</p>
1810
1811     <p>Cette directive supporte aussi les configurations de mandataire
1812     inverse - un serveur web d'arrière-plan peut être intégré dans
1813     l'espace d'URL d'un serveur virtuel, même si ce serveur est caché
1814     par un autre mandataire direct.</p>
1815
1816 </div>
1817 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1818 <div class="directive-section"><h2><a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a> <a name="proxyremotematch" id="proxyremotematch">Directive</a></h2>
1819 <table class="directive">
1820 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le mandataire distant à utiliser pour traiter les requêtes
1821 correspondant à une expression rationnelle</td></tr>
1822 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>serveur-distant</var></code></td></tr>
1823 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1824 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1825 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1826 </table>
1827     <p>La directive <code class="directive">ProxyRemoteMatch</code> est
1828     identique à la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>, à l'exception du
1829     premier argument qui est une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression
1830     rationnelle</a> à mettre en correspondance avec l'URL de la
1831     requête.</p>
1832
1833 </div>
1834 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1835 <div class="directive-section"><h2><a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a> <a name="proxyrequests" id="proxyrequests">Directive</a></h2>
1836 <table class="directive">
1837 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalité (standard) de mandataire
1838 direct</td></tr>
1839 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRequests On|Off</code></td></tr>
1840 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyRequests Off</code></td></tr>
1841 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1842 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1843 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1844 </table>
1845     <p>Cette directive permet d'activer/désactiver la fonctionnalité de
1846     serveur mandataire direct d'Apache httpd. Définir ProxyRequests à
1847     <code>Off</code> n'interdit pas l'utilisation de la directive
1848     <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1849
1850     <p>Pour une configuration typique de mandataire inverse ou
1851     passerelle, cette directive doit être définie à
1852     <code>Off</code>.</p>
1853
1854     <p>Afin d'activer la fonctionnalité de mandataire pour des sites
1855     HTTP et/ou FTP, les modules <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> et/ou
1856     <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> doivent également être chargés dans le
1857     serveur.</p>
1858
1859     <div class="warning"><h3>Avertissement</h3>
1860       <p>N'activez pas la fonctionnalité de mandataire avec la directive
1861       <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
1862       d'avoir <a href="#access">sécurisé votre serveur</a>. Les serveurs
1863       mandataires ouverts sont dangereux non seulement pour votre
1864       réseau, mais aussi pour l'Internet au sens large.</p>
1865     </div>
1866
1867 <h3>Voir aussi</h3>
1868 <ul>
1869 <li><a href="#forwardreverse">Mandataires/Passerelles directs et
1870 inverses</a></li>
1871 </ul>
1872 </div>
1873 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1874 <div class="directive-section"><h2><a name="ProxySet" id="ProxySet">ProxySet</a> <a name="proxyset" id="proxyset">Directive</a></h2>
1875 <table class="directive">
1876 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit différents paramètres relatifs à la répartition de
1877 charge des mandataires et aux membres des groupes de répartition de
1878 charge</td></tr>
1879 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySet <var>url</var> <var>clé=valeur [clé=valeur ...]</var></code></td></tr>
1880 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
1881 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1882 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1883 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>ProxySet n'est disponible que depuis la version 2.2
1884 du serveur HTTP Apache.</td></tr>
1885 </table>
1886     <p>Cette directive propose une méthode alternative pour définir tout
1887     paramètre relatif aux répartiteurs de charge et serveurs cibles de
1888     mandataires normalement définis via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Si elle se trouve dans un
1889     conteneur <code>&lt;Proxy <var>url de répartiteur|url de
1890     serveur cible</var>&gt;</code>, l'argument <var>url</var> n'est pas
1891     nécessaire. Comme effet de bord, le répartiteur ou serveur cible respectif
1892     est créé. Ceci peut s'avérer utile pour la mise en oeuvre d'un
1893     mandataire inverse via une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> au lieu de <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1894
1895     <div class="example"><p><code>
1896       &lt;Proxy balancer://hotcluster&gt;<br />
1897       <span class="indent">
1898         BalancerMember http://www2.example.com:8080 loadfactor=1<br />
1899         BalancerMember http://www3.example.com:8080 loadfactor=2<br />
1900         ProxySet lbmethod=bytraffic<br />
1901       </span>
1902       &lt;/Proxy&gt;
1903     </code></p></div>
1904
1905     <div class="example"><p><code>
1906       &lt;Proxy http://backend&gt;<br />
1907       <span class="indent">
1908         ProxySet keepalive=On<br />
1909       </span>
1910       &lt;/Proxy&gt;
1911     </code></p></div>
1912
1913     <div class="example"><p><code>
1914         ProxySet balancer://foo lbmethod=bytraffic timeout=15
1915     </code></p></div>
1916
1917     <div class="example"><p><code>
1918         ProxySet ajp://backend:7001 timeout=15
1919     </code></p></div>
1920
1921    <div class="warning"><h3>Avertissement</h3>
1922       <p>Gardez à l'esprit qu'une même clé de paramètre peut avoir
1923       différentes significations selon qu'elle s'applique à un
1924       répartiteur ou à un serveur cible, et ceci est illustré par les deux
1925       exemples précédents où il est question d'un timeout.</p>
1926    </div>
1927
1928
1929 </div>
1930 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1931 <div class="directive-section"><h2><a name="ProxySourceAddress" id="ProxySourceAddress">ProxySourceAddress</a> <a name="proxysourceaddress" id="proxysourceaddress">Directive</a></h2>
1932 <table class="directive">
1933 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'adresse IP locale pour les connexions mandatées
1934 sortantes</td></tr>
1935 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySourceAddress <var>adresse</var></code></td></tr>
1936 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1937 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1938 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1939 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9</td></tr>
1940 </table>
1941     <p>Cette directive permet de définir une adresse IP locale
1942     spécifique à laquelle faire référence lors d'une connexion à un
1943     serveur d'arrière-plan.</p>
1944
1945
1946 </div>
1947 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1948 <div class="directive-section"><h2><a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a> <a name="proxystatus" id="proxystatus">Directive</a></h2>
1949 <table class="directive">
1950 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Affiche l'état du répartiteur de charge du mandataire dans
1951 mod_status</td></tr>
1952 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyStatus Off|On|Full</code></td></tr>
1953 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyStatus Off</code></td></tr>
1954 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1955 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1956 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1957 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2 d'Apache</td></tr>
1958 </table>
1959     <p>Cette directive permet de spécifier si les données d'état du
1960     répartiteur de charge du mandataire doivent être affichées via la
1961     page d'état du serveur du module <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.</p>
1962     <div class="note"><h3>Note</h3>
1963       <p>L'argument <strong>Full</strong> produit le même effet que
1964       l'argument <strong>On</strong>.</p>
1965     </div>
1966
1967
1968 </div>
1969 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1970 <div class="directive-section"><h2><a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a> <a name="proxytimeout" id="proxytimeout">Directive</a></h2>
1971 <table class="directive">
1972 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Délai d'attente réseau pour les requêtes
1973 mandatées</td></tr>
1974 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyTimeout <var>secondes</var></code></td></tr>
1975 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Valeur de la directive <code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code></code></td></tr>
1976 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1977 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1978 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1979 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0.31 du serveur HTTP Apache</td></tr>
1980 </table>
1981     <p>Cette directive permet à l'utilisateur de spécifier un délai pour
1982     les requêtes mandatées. Ceci s'avère utile dans le cas d'un serveur
1983     d'applications lent et bogué qui a tendance à se bloquer, et si vous
1984     préférez simplement renvoyer une erreur timeout et abandonner la
1985     connexion en douceur plutôt que d'attendre jusqu'à ce que le serveur
1986     veuille bien répondre.</p>
1987
1988 </div>
1989 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1990 <div class="directive-section"><h2><a name="ProxyVia" id="ProxyVia">ProxyVia</a> <a name="proxyvia" id="proxyvia">Directive</a></h2>
1991 <table class="directive">
1992 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information fournie dans l'en-tête de réponse HTTP
1993 <code>Via</code> pour les requêtes mandatées</td></tr>
1994 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyVia On|Off|Full|Block</code></td></tr>
1995 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyVia Off</code></td></tr>
1996 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1997 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1998 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1999 </table>
2000     <p>Cette directive permet de contrôler l'utilisation de l'en-tête
2001     HTTP <code>Via:</code> par le mandataire. Le but recherché est de
2002     contrôler le flux des requêtes mandatées tout au long d'une chaîne
2003     de serveurs mandataires. Voir <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1),
2004     section 14.45 pour une description des lignes d'en-tête
2005     <code>Via:</code>.</p>
2006
2007     <ul>
2008     <li>Si elle est définie à <code>Off</code>, valeur par défaut, cette
2009     directive n'effectue aucun traitement particulier. Si une requête ou
2010     une réponse contient un en-tête <code>Via:</code>, il est transmis
2011     sans modification.</li>
2012
2013     <li>Si elle est définie à <code>On</code>, chaque requête ou réponse
2014     se verra ajouter une ligne d'en-tête <code>Via:</code> pour le
2015     serveur courant.</li>
2016
2017     <li>Si elle est définie à <code>Full</code>, chaque ligne d'en-tête
2018     <code>Via:</code> se verra ajouter la version du serveur Apache
2019     httpd sous la forme d'un champ de commentaire <code>Via:</code>.</li>
2020
2021     <li>Si elle est définie à <code>Block</code>, chaque requête
2022     mandatée verra ses lignes d'en-tête <code>Via:</code> supprimées.
2023     Aucun nouvel en-tête <code>Via:</code> ne sera généré.</li>
2024     </ul>
2025
2026 </div>
2027 </div>
2028 <div class="bottomlang">
2029 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
2030 <a href="../fr/mod/mod_proxy.html" title="Français">&nbsp;fr&nbsp;</a> |
2031 <a href="../ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
2032 </div><div id="footer">
2033 <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>
2034 <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>
2035 </body></html>