f072359f493a5209335799da85ac16d6a273303bgryzor<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
f072359f493a5209335799da85ac16d6a273303bgryzor XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
f072359f493a5209335799da85ac16d6a273303bgryzor This file is generated from xml source: DO NOT EDIT
f072359f493a5209335799da85ac16d6a273303bgryzor XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
96ad5d81ee4a2cc66a4ae19893efc8aa6d06fae7jailletc<title>mod_proxy - Serveur Apache HTTP Version 2.5</title>
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
2e545ce2450a9953665f701bb05350f0d3f26275nd<script src="/style/scripts/prettify.min.js" type="text/javascript">
f072359f493a5209335799da85ac16d6a273303bgryzor<link href="/images/favicon.ico" rel="shortcut icon" /></head>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
f072359f493a5209335799da85ac16d6a273303bgryzor<a href="/fr/mod/mod_proxy.html" title="Fran�ais"> fr </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
b475917ddf898282aa51ce31b3275c2c4783ce98coar<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
b475917ddf898282aa51ce31b3275c2c4783ce98coar anglaise pour les changements r�cents.</div>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Serveur mandataire/passerelle multi-protocole</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>proxy_module</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_proxy.c</td></tr></table>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>N'activez pas la fonctionnalit� de mandataire avec la directive
f072359f493a5209335799da85ac16d6a273303bgryzor <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
f072359f493a5209335799da85ac16d6a273303bgryzor d'avoir <a href="#access">s�curis� votre serveur</a>. Les serveurs
f072359f493a5209335799da85ac16d6a273303bgryzor mandataires ouverts sont dangereux pour votre r�seau,
f072359f493a5209335799da85ac16d6a273303bgryzor mais aussi pour l'Internet au sens large.</p>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <p><code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> et ses modules associ�s impl�mentent
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic un mandataire/passerelle pour le serveur HTTP Apache, et supportent
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic de nombreux protocoles courants, ainsi que plusieurs algorithmes de
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic r�partition de charge. Le support de protocoles et d'algorithmes de
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic r�partition de charge suppl�mentaires peut �tre assur� par des
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic modules tiers.</p>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <p>Un jeu de modules charg�s dans le serveur permet de fournir les
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic fonctionnalit�s souhait�es. Ces modules peuvent �tre inclus
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic statiquement � la compilation, ou dynamiquement via la directive
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code>. Ce jeu de module
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic doit comporter :</p>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <li><code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, qui fournit les fonctionnalit�s de
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic base d'un mandataire</li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <li><code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> et un ou plusieurs modules
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic de r�partition, si la r�partition de charge doit �tre mise en
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic oeuvre (Voir la documentation de
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus de d�tails).</li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <li>un ou plusieurs modules de types de mandataire, ou protocoles
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic 1.3)</td><td><code class="module"><a href="/mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code></td></tr>
27a7b74f8c50bd6074b0c71fae9927a71fde5b3fjim SSL)</td><td><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code></td></tr>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <tr><td>FastCGI</td><td><code class="module"><a href="/mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></td></tr>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <tr><td>ftp</td><td><code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></td></tr>
27a7b74f8c50bd6074b0c71fae9927a71fde5b3fjim HTTP/1.1</td><td><code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code></td></tr>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic <tr><td>SCGI</td><td><code class="module"><a href="/mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></td></tr>
63befe0983261d711e62457b380e24ecc3b7b79etrawick <tr><td>WS and WSS (Web-sockets)</td><td><code class="module"><a href="/mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor <p>En outre, d'autres modules fournissent des fonctionnalit�s
f072359f493a5209335799da85ac16d6a273303bgryzor �tendues. <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> et ses modules associ�s
f072359f493a5209335799da85ac16d6a273303bgryzor fournissent la mise en cache. Les directives <code>SSLProxy*</code>
f072359f493a5209335799da85ac16d6a273303bgryzor du module <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> permettent de contacter des
f072359f493a5209335799da85ac16d6a273303bgryzor serveurs distants en utilisant le protocole SSL/TLS. Ces modules
f072359f493a5209335799da85ac16d6a273303bgryzor additionnels devront �tre charg�s et configur�s pour pouvoir
f072359f493a5209335799da85ac16d6a273303bgryzor disposer de ces fonctionnalit�s.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#forwardreverse">Mandataires directs et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#examples">Exemples simples</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#handler">Acc�s via un gestionnaire</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#workers">Workers</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#access">Contr�ler l'acc�s � votre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#startup">Ralentissement au d�marrage</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#intranet">Mandataire en Intranet</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#envsettings">Ajustements relatifs au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#request-bodies">Corps de requ�tes</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><img alt="" src="/images/down.gif" /> <a href="#x-headers">En-t�tes de requ�te du mandataire
45a544a8bb3fa1f95e5edac9fb3e723e2bb7001drbowen<li><img alt="" src="/images/down.gif" /> <a href="#balancergrowth">BalancerGrowth</a></li>
f4e5f2db46dae7401835616fa1893c7922d36291jim<li><img alt="" src="/images/down.gif" /> <a href="#balancerinherit">BalancerInherit</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#balancermember">BalancerMember</a></li>
27a7b74f8c50bd6074b0c71fae9927a71fde5b3fjim<li><img alt="" src="/images/down.gif" /> <a href="#balancerpersist">BalancerPersist</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#noproxy">NoProxy</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxy"><Proxy></a></li>
4c47688d73a9a5ef2735cd84f334b8eb814c74f0igalic<li><img alt="" src="/images/down.gif" /> <a href="#proxyaddheaders">ProxyAddHeaders</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxybadheader">ProxyBadHeader</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyblock">ProxyBlock</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxydomain">ProxyDomain</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyerroroverride">ProxyErrorOverride</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyiobuffersize">ProxyIOBufferSize</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxymatch"><ProxyMatch></a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxymaxforwards">ProxyMaxForwards</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypass">ProxyPass</a></li>
35fe7da687551c1d6e0f62e192f10e39f6a55208rbowen<li><img alt="" src="/images/down.gif" /> <a href="#proxypassinherit">ProxyPassInherit</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassmatch">ProxyPassMatch</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreverse">ProxyPassReverse</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxypreservehost">ProxyPreserveHost</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyremote">ProxyRemote</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyremotematch">ProxyRemoteMatch</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyrequests">ProxyRequests</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyset">ProxySet</a></li>
ee649f9236fe7fcf255bbfa11f2cce080f996521sf<li><img alt="" src="/images/down.gif" /> <a href="#proxysourceaddress">ProxySourceAddress</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxystatus">ProxyStatus</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxytimeout">ProxyTimeout</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><img alt="" src="/images/down.gif" /> <a href="#proxyvia">ProxyVia</a></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code></li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic<li><code class="module"><a href="/mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic<li><code class="module"><a href="/mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code></li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic<li><code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic<li><code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code></li>
70f5253b24dd333c67fb6502d557a8b48ad3ba87igalic<li><code class="module"><a href="/mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code></li>
63befe0983261d711e62457b380e24ecc3b7b79etrawick<li><code class="module"><a href="/mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li>
f072359f493a5209335799da85ac16d6a273303bgryzor<li><code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code></li>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="forwardreverse" id="forwardreverse">Mandataires directs et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le serveur HTTP Apache peut �tre configur� dans les deux modes mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dfn>direct</dfn> et mandataire <dfn>inverse</dfn> (aussi nomm�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un <dfn>mandataire direct</dfn> standard est un serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar interm�diaire qui s'intercale entre le client et le <em>serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar demand�</em>. Pour obtenir un contenu h�berg� par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le serveur demand�, le client envoie une requ�te au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire en nommant le serveur demand� comme
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar cible, puis le mandataire extrait le contenu depuis le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur demand� et le renvoie enfin au client. Le client doit �tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar configur� de mani�re appropri�e pour pouvoir utiliser le mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar direct afin d'acc�der � d'autres sites.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'acc�s � Internet depuis des clients situ�s derri�re un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pare-feu est une utilisation typique du mandataire direct. Le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire direct peut aussi utiliser la mise en cache (fournie
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>) pour r�duire la charge du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�seau.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La fonctionnalit� de mandataire direct est activ�e via la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code>.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Comme les mandataires directs permettent aux clients d'acc�der �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar des sites quelconques via votre serveur et de dissimuler leur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar v�ritable origine, il est indispensable de <a href="#access">s�curiser votre serveur</a> de fa�on � ce que seuls
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les clients autoris�s puissent acc�der � votre serveur avant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'activer la fonctionnalit� de mandataire direct.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un <dfn>mandataire inverse</dfn> (ou <dfn>passerelle</dfn>),
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar quant � lui, appara�t au client comme un serveur web standard.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Aucune configuration particuli�re du client n'est n�cessaire. Le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar client adresse ses demandes de contenus ordinaires dans l'espace
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de nommage du mandataire inverse. Ce dernier d�cide alors o�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar envoyer ces requ�tes, et renvoie le contenu au client comme s'il
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'h�bergeait lui-m�me.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'acc�s d'utilisateurs depuis Internet vers un serveur situ�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar derri�re un pare-feu est une utilisation typique du mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar inverse. On peut aussi utiliser les mandataires inverses pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mettre en oeuvre une r�partition de charge entre plusieurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveurs en arri�re-plan, ou fournir un cache pour un serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan plus lent. Les mandataires inverses peuvent aussi
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tout simplement servir � rassembler plusieurs serveurs dans le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar m�me espace de nommage d'URLs.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La fonctionnalit� de mandataire inverse est activ�e via la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le drapeau <code>[P]</code> de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Il n'est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <strong>pas</strong> n�cessaire de d�finir <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> pour configurer
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar un mandataire inverse.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="examples" id="examples">Exemples simples</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les exemples ci-dessous illustrent de mani�re tr�s basique la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mise en oeuvre de la fonctionnalit� de mandataire et ne sont l� que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pour vous aider � d�marrer. Reportez-vous � la documentation de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar chaque directive.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si en outre, vous d�sirez activer la mise en cache, consultez la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar documentation de <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Mandataire inverse</h3><pre class="prettyprint lang-config">ProxyPass /foo http://foo.example.com/bar
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Mandataire direct</h3><pre class="prettyprint lang-config">ProxyRequests On
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyVia On
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<Proxy *>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="handler" id="handler">Acc�s via un gestionnaire</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Vous pouvez aussi forcer le traitement d'une requ�te en tant que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te de mandataire inverse en cr�ant un gestionnaire de transfert
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar appropri�. Dans l'exemple suivant, toutes les requ�tes pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar des scripts PHP seront transmises au serveur FastCGI
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifi� via un mandat inverse :
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Scripts PHP et mandataire inverse</h3><pre class="prettyprint lang-config"><FilesMatch \.php$>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar SetHandler "proxy:unix:/path/to/app.sock|fcgi://localhost/"
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</FilesMatch></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette fonctionnalit� est disponible � partir de la version
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 2.4.10 du serveur HTTP Apache.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le mandataire g�re la configuration et les param�tres de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar communication des serveurs originaux au sein d'objets nomm�s
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dfn>workers</dfn>. Deux types de worker sont fournis : le worker
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par d�faut du mandataire direct et le worker par d�faut du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire inverse. Il est aussi possible de d�finir explicitement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar des workers suppl�mentaires.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les deux workers par d�faut poss�dent une configuration fig�e
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar et seront utilis�s si aucun autre worker ne correspond � la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te. Ils n'utilisent ni les jeux de connexions (connection
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pooling), ni les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexions HTTP persistantes (Keep-Alive). En effet, les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexions TCP vers le serveur original sont ferm�es et ouvertes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pour chaque requ�te.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les workers d�finis explicitement sont identifi�s par leur URL.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilise dans le cadre d'un mandataire inverse :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><pre class="prettyprint lang-config">ProxyPass /example http://backend.example.com connectiontimeout=5 timeout=30</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive va cr�er un worker associ� � l'URL du serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar original <code>http://backend.example.com</code>, et utilisant les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar valeurs de timeout donn�es. Lorsqu'ils sont utilis�s dans le cadre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'un mandataire direct, les workers sont en g�n�ral d�finis via la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><a href="#proxyset">ProxySet</a></code>,</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><pre class="prettyprint lang-config">ProxySet http://backend.example.com connectiontimeout=5 timeout=30</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <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>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Proxy http://backend.example.com>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ProxySet connectiontimeout=5 timeout=30
4aa603e6448b99f9371397d439795c91a93637eand</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'utilisation de workers d�finis explicitement dans le mode
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire direct n'est pas tr�s courante, car les mandataires
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directs communiquent en g�n�ral avec de nombreux serveurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar originaux. La cr�ation explicite de workers pour certains serveurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar originaux peut cependant s'av�rer utile si ces serveurs sont
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tr�s souvent sollicit�s. A leur niveau, les workers explicitement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finis ne poss�dent aucune notion de mandataire direct ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar inverse. Ils encapsulent un concept de communication commun avec
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les serveurs originaux. Un worker cr�� via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> pour �tre utilis� dans le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar cadre d'un mandataire inverse sera aussi utilis� dans le cadre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'un mandataire directe chaque fois que l'URL vers le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar original correspondra � l'URL du worker, et vice versa.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'URL qui identifie un worker correspond � l'URL de son serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar original, y compris un �ventuel chemin donn� :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass /examples http://backend.example.com/examples
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans cet exemple, deux workers diff�rents sont d�finis, chacun
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'eux utilisant des configurations et jeux de connexions
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s�par�s.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le partage de workers intervient lorsque les URLs des workers
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s'entrecoupent, ce qui arrive lorsque l'URL d'un worker
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspond au d�but de l'URL d'un autre worker d�fini plus loin
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dans le fichier de configuration. Dans l'exemple suivant,</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass /apps http://backend.example.com/ timeout=60
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyPass /examples http://backend.example.com/examples timeout=10</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>le second worker n'est pas vraiment cr��. C'est le premier
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar worker qui est en fait utilis�. L'avantage de ceci r�side dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le fait qu'il n'existe qu'un seul jeu de connexions, ces
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar derni�res �tant donc r�utilis�es plus souvent. Notez que tous
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les attributs de configuration d�finis explicitement pour le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar deuxi�me worker seront ignor�s, ce qui sera journalis� en tant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qu'avertissement. Ainsi, dans l'exemple ci-dessus, la valeur de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si vous voulez emp�cher le partage de workers, classez vos
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finitions de workers selon la longueur des URLs, de la plus
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar longue � la plus courte. Si au contraire vous voulez favoriser
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ce partage, utilisez l'ordre de classement inverse. Voir aussi
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'avertissement � propos de l'ordre de classement des directives
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les workers d�finis explicitement sont de deux sortes :
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dfn>workers directs</dfn> et <dfn>workers de r�partition (de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar charge)</dfn>. Ils supportent de nombreux attributs de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar configuration importants d�crits dans la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Ces m�mes attributs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar peuvent aussi �tre d�finis via la directive <code class="directive"><a href="#proxyset">ProxySet</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le jeu d'options disponibles pour un worker direct d�pend du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar protocole sp�cifi� dans l'URL du serveur original. Les protocoles
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar disponibles comprennent <code>ajp</code>, <code>fcgi</code>,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>ftp</code>, <code>http</code> et <code>scgi</code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les workers de r�partition sont des workers virtuels qui
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilisent les workers directs, connus comme faisant partie de leurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar membres, pour le traitement effectif des requ�tes. Chaque
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur peut comporter plusieurs membres. Lorsqu'il traite une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te, il choisit un de ses membres en fonction de l'algorithme
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de r�partition de charge d�fini.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un worker de r�partition est cr�� si son URL de worker comporte
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>balancer</code> comme indicateur de protocole. L'URL du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur permet d'identifier de mani�re unique le worker de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partition. La directive <code class="directive"><a href="#balancermember">BalancerMember</a></code> permet d'ajouter des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar membres au r�partiteur.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="access" id="access">Contr�ler l'acc�s � votre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Vous pouvez restreindre l'acc�s � votre mandataire via le bloc
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de contr�le <code class="directive"><a href="#proxy"><Proxy></a></code> comme dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'exemple suivant :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Require ip 192.168.0
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Pour plus de d�tails sur les directives de contr�le d'acc�s,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar voir la documentation du module
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Restreindre l'acc�s de mani�re stricte est essentiel si vous
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mettez en oeuvre un mandataire direct (en d�finissant la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> � "on").
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Dans le cas contraire, votre serveur pourrait �tre utilis� par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n'importe quel client pour acc�der � des serveurs quelconques,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tout en masquant sa v�ritable identit�. Ceci repr�sente un danger
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar non seulement pour votre r�seau, mais aussi pour l'Internet au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sens large. Dans le cas de la mise en oeuvre d'un mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar inverse (en utilisant la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> avec <code>ProxyRequests Off</code>), le contr�le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'acc�s est moins critique car les clients ne peuvent contacter
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar que les serveurs que vous avez sp�cifi�s.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p><strong>Voir aussi</strong> la variable d'environnement <a href="mod_proxy_http.html#env">Proxy-Chain-Auth</a>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="startup" id="startup">Ralentissement au d�marrage</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar IP puis ces derni�res mises en cache au cours du d�marrage
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � des fins de tests de comparaisons ult�rieurs. Ce processus peut
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar durer plusieurs secondes (ou d'avantage) en fonction de la vitesse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � laquelle s'effectue la r�solution des noms d'h�tes.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="intranet" id="intranet">Mandataire en Intranet</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un serveur mandataire Apache httpd situ� � l'int�rieur d'un Intranet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar doit faire suivre les requ�tes destin�es � un serveur externe �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar travers le pare-feu de l'entreprise (pour ce faire, d�finissez la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fa�on � ce qu'elle fasse suivre le <var>protocole</var> concern�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar vers le mandataire du pare-feu). Cependant, lorsqu'il doit acc�der
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � des ressources situ�es dans l'Intranet, il peut se passer du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pare-feu pour acc�der aux serveurs. A cet effet, la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#noproxy">NoProxy</a></code> permet de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifier quels h�tes appartiennent � l'Intranet et peuvent donc
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �tre acc�d�s directement.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les utilisateurs d'un Intranet ont tendance � oublier le nom du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar domaine local dans leurs requ�tes WWW, et demandent par exemple
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>http://un-serveur.example.com/</code>. Certains serveurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataires commerciaux acceptent ce genre de requ�te et les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar traitent simplement en utilisant un nom de domaine local
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar implicite. Lorsque la directive <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> est utilis�e et si le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire</a>, Apache httpd peut renvoyer une r�ponse de redirection et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ainsi fournir au client l'adresse de serveur correcte,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar enti�rement qualifi�e. C'est la m�thode � privil�gier car le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fichier des marque-pages de l'utilisateur contiendra alors des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar noms de serveurs enti�rement qualifi�s.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="envsettings" id="envsettings">Ajustements relatifs au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Pour les cas o� <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> envoie des requ�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar vers un serveur qui n'impl�mente pas correctement les connexions
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar persistantes ou le protocole HTTP/1.1, il existe deux variables
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'environnement qui permettent de forcer les requ�tes � utiliser
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le protocole HTTP/1.0 avec connexions non persistantes. Elles
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar peuvent �tre d�finies via la directive <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Il s'agit des variables <code>force-proxy-request-1.0</code> et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Location /buggyappserver/>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar SetEnv force-proxy-request-1.0 1
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar SetEnv proxy-nokeepalive 1
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Location></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="request-bodies" id="request-bodies">Corps de requ�tes</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Certaines m�thodes de requ�tes comme POST comportent un corps de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te. Le protocole HTTP stipule que les requ�tes qui comportent
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar un corps doivent soit utiliser un codage de transmission
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fractionn�e (chunked transfer encoding), soit envoyer un en-t�te de requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>Content-Length</code>. Lorsqu'il fait suivre ce genre de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te vers le serveur demand�, <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s'efforce toujours d'envoyer l'en-t�te <code>Content-Length</code>.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Par contre, si la taille du corps est importante, et si la requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar originale utilise un codage � fractionnement, ce dernier peut aussi
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �tre utilis� dans la requ�te montante. Ce comportement peut �tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'environnement</a>. Ainsi, si elle est d�finie, la variable
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>proxy-sendcl</code> assure une compatibilit� maximale avec les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveurs demand�s en imposant l'envoi de l'en-t�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>proxy-sendchunked</code> diminue la consommation de ressources
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar en imposant l'utilisation d'un codage � fractionnement.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans certaines circonstances, le serveur doit mettre en file
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'attente sur disque les corps de requ�tes afin de satisfaire le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar traitement demand� des corps de requ�tes. Par exemple, cette mise en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar file d'attente se produira si le corps original a �t� envoy� selon un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar codage morcel� (et poss�de une taille importante), alors que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'administrateur a demand� que les requ�tes du serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan soient envoy�es avec l'en-t�te Content-Length ou en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar HTTP/1.0. Cette mise en file d'attente se produira aussi si le corps
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de la requ�te contient d�j� un en-t�te Content-Length, alors que le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur est configur� pour filtrer les corps des requ�tes entrantes.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive"><a href="/mod/core.html#limitrequestbody">LimitRequestBody</a></code> ne s'applique qu'aux
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar corps de requ�tes que le serveur met en file d'attente sur disque.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<h2><a name="x-headers" id="x-headers">En-t�tes de requ�te du mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Lorsqu'il est configur� en mode mandataire inverse (en utilisant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par exemple la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>),
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> ajoute plusieurs en-t�tes de requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar afin de transmettre des informations au serveur demand�. Ces
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar en-t�tes sont les suivants :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dd>L'h�te d'origine demand� par le client dans l'en-t�te de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Ces en-t�tes doivent �tre utilis�s avec pr�cautions sur le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur demand�, car ils contiendront plus d'une valeur (s�par�es
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par des virgules) si la requ�te originale contenait d�j� un de ces
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar en-t�tes. Par exemple, vous pouvez utiliser
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>%{X-Forwarded-For}i</code> dans la cha�ne de format du journal
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar du serveur demand� pour enregistrer les adresses IP des clients
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar originaux, mais il est possible que vous obteniez plusieurs adresses
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar si la requ�te passe � travers plusieurs mandataires.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de contr�ler d'autres en-t�tes de requ�te.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Note : Si vous devez ajouter des en-t�tes particuliers � la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te mandat�e, utilisez la directive <code class="directive"><a href="/mod/mod_headers.html#requestheader">RequestHeader</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="balancergrowth" id="balancergrowth">Directive</a> <a name="BalancerGrowth" id="BalancerGrowth">BalancerGrowth</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre de membres suppl�mentaires pouvant �tre ajout�s
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerGrowth <var>#</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>BalancerGrowth 5</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>BalancerGrowth est disponible depuis la version 2.3.13 du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de d�finir le nombre de membres pouvant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �tre ajout�s au groupe de r�partition de charge pr�configur� d'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur virtuel. Elle n'est active que si le groupe a �t�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pr�configur� avec un membre au minimum.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="balancerinherit" id="balancerinherit">Directive</a> <a name="BalancerInherit" id="BalancerInherit">BalancerInherit</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H�ritage des membres du groupes de r�partition de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar charge du mandataire d�finis au niveau du serveur principal</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerInherit On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>BalancerInherit On</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 2.4.5 du serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet d'attribuer au serveur virtuel courant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'h�ritage des membres de groupes de r�partition de charge
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finis au niveau du serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar principal. Elle ne doit pas �tre activ�e si vous
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilisez la fonctionnalit� de modifications dynamiques du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar gestionnaire de r�partition de charge (Balancer Manager) pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �viter des probl�mes et des comportements inattendus.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les d�finitions au niveau du serveur principal constituent
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les d�finitions par d�faut au niveau des serveurs virtuels.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La d�sactivation de ProxyPassInherit d�sactive aussi la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><a href="#balancerinherit">BalancerInherit</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="balancermember" id="balancermember">Directive</a> <a name="BalancerMember" id="BalancerMember">BalancerMember</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un membre � un groupe de r�partition de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet d'ajouter un membre � un groupe de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partition de charge. Elle peut se trouver dans un conteneur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code><Proxy <var>balancer://</var>...></code>, et accepte
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tous les param�tres de paires cl�/valeur que supporte la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">BalancerMember</code> accepte un param�tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar suppl�mentaire : <var>loadfactor</var>. Il s'agit du facteur de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar charge du membre - un nombre entre 1 (valeur par d�faut) et 100, qui
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finit la charge � appliquer au membre en question.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'argument <var>balancerurl</var> n'est requis que s'il ne se trouve pas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�j� dans la directive de conteneur <code><Proxy
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>balancer://</var>...></code>. Il correspond � l'URL d'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur de charge d�fini par une directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La partie chemin de l'URL du membre du groupe de r�partition de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar charge dans toute directive de conteneur <code><Proxy
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les slashes de fin doivent normalement �tre supprim�s de l'URL
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'un <code class="directive">BalancerMember</code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="balancerpersist" id="balancerpersist">Directive</a> <a name="BalancerPersist" id="BalancerPersist">BalancerPersist</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de conserver les changements effectu�s par le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar gestionnaire de r�partition de charge apr�s un red�marrage du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BalancerPersist On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>BalancerPersist Off</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>BalancerPersist n'est disponible qu'� partir de la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de conserver le contenu de l'espace
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar m�moire partag� associ� aux r�partiteurs de charge et � leurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar membres apr�s un red�marrage du serveur. Ces modifications
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar locales ne sont ainsi pas perdues lors des transitions d'�tat
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dues � un red�marrage.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="noproxy" id="noproxy">Directive</a> <a name="NoProxy" id="NoProxy">NoProxy</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Serveurs, domaines ou r�seaux auquels on se connectera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>NoProxy <var>domaine</var> [<var>domaine</var>] ...</code></td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive n'a d'utilit� que pour les serveurs mandataires
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Apache httpd au sein d'Intranets. La directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">NoProxy</code> permet de sp�cifier une liste de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sous-r�seaux, d'adresses IP, de serveurs et/ou de domaines s�par�s
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par des espaces. Une requ�te pour un serveur qui correspond � un ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar plusieurs crit�res sera toujours servie par ce serveur directement,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sans �tre redirig�e vers le(s) serveur(s) mandataire(s) d�fini(s) par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyRemote * http://firewall.example.com:81
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le type des arguments <var>serveur</var> de la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">NoProxy</code> appartiennent � la liste suivante
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dt><var><a name="domain" id="domain">Domaine</a></var></dt>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un <dfn>domaine</dfn> est ici un nom de domaine DNS partiellement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qualifi� pr�c�d� d'un point. Il repr�sente une liste de serveurs qui
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar appartiennent logiquement au m�me domaine ou � la m�me zonz DNS
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (en d'autres termes, les nom des serveurs se terminent tous par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar syntaxique et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s�mantique, un domaine DNS pouvant aussi avoir un enregistrement DNS
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de type A !), les <var>domaine</var>s sont toujours sp�cifi�s en les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pr�fixant par un point.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les comparaisons de noms de domaines s'effectuent sans tenir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar compte de la casse, et les parties droites des <var>Domaine</var>s
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sont toujours cens�es correspondre � la racine de l'arborescence
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar DNS, si bien que les domaines <code>.ExEmple.com</code> et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>.example.com.</code> (notez le point � la fin du nom) sont
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar consid�r�s comme identiques. Comme une comparaison de domaines ne
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n�cessite pas de recherche DNS, elle est beaucoup plus efficace
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qu'une comparaison de sous-r�seaux.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dt><var><a name="subnet" id="subnet">Sous-r�seau</a></var></dt>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un <dfn>Sous-r�seau</dfn> est une adresse internet partiellement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qualifi�e sous forme num�rique (quatre nombres s�par�s par des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar points), optionnellement suivie d'un slash et du masque de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sous-r�seau sp�cifiant le nombre de bits significatifs dans le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>Sous-r�seau</var>. Il repr�sente un sous-r�seau de serveurs qui
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar peuvent �tre atteints depuis la m�me interface r�seau. En l'absence
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de masque de sous-r�seau explicite, il est sous-entendu que les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar digits manquants (ou caract�res 0) de fin sp�cifient le masque de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sous-r�seau (Dans ce cas, le masque de sous-r�seau ne peut �tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qu'un multiple de 8). Voici quelques exemples :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dt><code>192.168</code> ou <code>192.168.0.0</code></dt>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dd>le sous-r�seau 192.168.0.0 avec un masque de sous-r�seau
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar implicite de 16 bits significatifs (parfois exprim� sous la forme
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dd>le sous-r�seau <code>192.168.112.0/21</code> avec un masque de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sous-r�seau implicite de 21 bits significatifs (parfois exprim�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Comme cas extr�mes, un <em>Sous-r�seau</em> avec un masque de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sous-r�seau de 0 bit significatif (c'est � dire 0.0.0.0/0) est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar identique � la constante <var>_Default_</var>, et peut correspondre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dt><var><a name="ipaddr" id="ipaddr">Adresse IP</a></var></dt>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Une <dfn>Adresse IP</dfn> est une adresse internet pleinement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qualifi�e sous forme num�rique (quatre nombres s�par�s par des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar points). En g�n�ral, cette adresse repr�sente un serveur, mais elle
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ne doit pas n�cessairement correspondre � un nom de domaine DNS.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 192.168.123.7
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Une <dfn>Adresse IP</dfn> ne n�cessite pas de r�solution DNS,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar et peut ainsi s'av�rer plus efficace quant aux performances
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'Apache.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dt><var><a name="hostname" id="hostname">Nom de serveur</a></var></dt>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Un <dfn>Nom de serveur</dfn> est un nom de domaine DNS pleinement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qualifi� qui peut �tre r�solu en une ou plusieurs adresses IP par le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar service de noms de domaines DNS. Il repr�sente un h�te logique (par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar opposition aux <var><a href="#domain">Domaine</a></var>s, voir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'h�tes avec diff�rentes <var><a href="#ipaddr">adresses
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans de nombreuses situations, il est plus efficace de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifier une <var><a href="#ipaddr">adresse IP</a></var> qu'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>Nom de serveur</var> car cela �vite d'avoir � effectuer une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar recherche DNS. La r�solution de nom dans Apache httpd peut prendre un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar temps tr�s long lorsque la connexion avec le serveur de noms
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilise une liaison PPP lente.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les comparaisons de <var>Nom de serveur</var> s'effectuent sans tenir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar compte de la casse, et les parties droites des <var>Noms de serveur</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sont toujours cens�es correspondre � la racine de l'arborescence
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar DNS, si bien que les domaines <code>WWW.ExEmple.com</code> et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>www.example.com.</code> (notez le point � la fin du nom) sont
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar consid�r�s comme identiques.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><a href="/dns-caveats.html">Probl�mes li�s au DNS</a></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxy" id="proxy">Directive</a> <a name="Proxy" id="Proxy"><Proxy></a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant � des ressources
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><Proxy <var>url-avec-jokers</var>> ...</Proxy></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les directives situ�es dans une section <code class="directive"><Proxy></code> ne s'appliquent qu'au contenu
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandat� concern�. Les jokers de style shell sont autoris�s.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Par exemple, les lignes suivantes n'autoriseront � acc�der � un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar contenu via votre serveur mandataire que les h�tes appartenant �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans l'exemple suivant, tous les fichiers du r�pertoire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>foo</code> de <code>example.com</code> seront trait�s par le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar filtre <code>INCLUDES</code> lorsqu'ils seront envoy�s par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'interm�diaire du serveur mandataire :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Proxy http://example.com/foo/*>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar SetOutputFilter INCLUDES
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans l'exemple suivant, les clients web poss�dant l'adresse IP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifi�e seront autoris�s � effectuer des requ�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>https://www.example.com/</code>, sous r�serve que le module
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code> soit charg�.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Proxy www.example.com:443>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="note"><h3>Diff�rences avec la section de configuration Location</h3>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Une URL d'arri�re-plan sera concern�e par le conteneur Proxy si
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar elle commence par la <var>url-avec-jokers</var>, m�me si le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dernier segment de chemin de la directive ne correspond qu'� un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pr�fixe de segment dee chemin de l'URL d'arri�re-plan. Par exemple, <Proxy
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar http://example.com/foo> correspondra entre autres aux URLs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar http://example.com/foobar. La correspondance de l'URL finale
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar diff�re du comportement de la section <code class="directive"><a href="/mod/core.html#location"><Location></a></code> qui, pour le cas de cette note,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar traitera le segment de chemin final comme s'il se terminait par un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar slash.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Pour un contr�le plus fin de la correspondance des URL, voir la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><ProxyMatch></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><code class="directive"><a href="#proxymatch"><ProxyMatch></a></code></li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyaddheaders" id="proxyaddheaders">Directive</a> <a name="ProxyAddHeaders" id="ProxyAddHeaders">ProxyAddHeaders</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des informations � propos du mandataire aux
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyAddHeaders Off|On</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyAddHeaders On</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.10</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de passer au serveur d'arri�re-plan des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar informations � propos du mandataire via les en-t�tes HTTP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar X-Forwarded-For, X-Forwarded-Host et X-Forwarded-Server.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette option n'est utile que dans le cas du mandat HTTP trait�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code>.</p>
564ee5b847469eb8a61120179ce70a0213965785rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxybadheader" id="proxybadheader">Directive</a> <a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBadHeader IsError|Ignore|StartBody</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyBadHeader IsError</code></td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">ProxyBadHeader</code> permet de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�terminer le comportement de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> lorsqu'il
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar re�oit des lignes d'en-t�te de r�ponse dont la syntaxe n'est pas valide (c'est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � dire ne contenant pas de caract�re ':') en provenance du serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar original. Les arguments disponibles sont :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dd>Annule la requ�te et renvoie une r�ponse de code 502 (mauvaise
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar passerelle). C'est le comportement par d�faut.</dd>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dd>Traite les lignes d'en-t�te incorrectes comme si elles n'avaient
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pas �t� envoy�es.</dd>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dd>A la r�ception de la premi�re ligne d'en-t�te incorrecte, les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar autres en-t�tes sont lus et ce qui reste est trait� en tant que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar corps. Ceci facilite la prise en compte des serveurs d'arri�re-plan
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar bogu�s qui oublient d'ins�rer une ligne vide entre les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar en-t�tes et le corps.</dd>
564ee5b847469eb8a61120179ce70a0213965785rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyblock" id="proxyblock">Directive</a> <a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interdit les requ�tes mandat�es vers certains h�tes</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyBlock *|<var>nom d'h�te</var>|<var>nom d'h�te partiel</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar[<var>nom d'h�te</var>|<var>nom d'h�te partiel</var>]...</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">ProxyBlock</code> permet d'interdire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'acc�s FTP ou HTTP via le mandataire � certains h�tes en fonction
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'une correspondance exacte ou partielle avec un nom d'h�te, ou dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la mesure du possible en fonction d'une comparaison d'adresses IP.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Chaque param�tre de la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyBlock</code> accepte comme valeur soit
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>*</code>, soit une cha�ne alphanum�rique. Au d�marrage, le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar module tente de r�soudre toute cha�ne alphanum�rique depuis un nom
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar DNS vers un jeu d'adresses IP, mais toute erreur de DNS est ignor�e.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> interdira l'acc�s � tout site FTP ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans le cas contraire, pour toute requ�te vers une ressource FTP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ou HTTP via le mandataire, <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> va comparer le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar nom d'h�te de l'URI de la requ�te avec chaque cha�ne alphanum�rique
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifi�e. Si une cha�ne correspond, m�me partiellement, l'acc�s est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar refus�. Si aucune cha�ne ne correspond, et si un mandataire distant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (forward) est configur� via la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyRemoteMatch</code>, l'acc�s est autoris�. Si
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aucun mandataire distant (forward) n'est configur�, l'adresse IP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspondant au nom d'h�te de l'URI est compar�e � toutes les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar adresses IP r�solues au d�marrage, et l'acc�s est refus� si une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspondance est trouv�e.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Notez que les recherches DNS peuvent ralentir le processus de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�marrage du serveur.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyBlock news.example.com auctions.example.com friends.example.com</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Notez qu'<code>example</code> suffirait aussi pour atteindre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ces sites.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Hosts conviendrait aussi s'il �tait r�f�renc� par adresse IP.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyBlock *</pre>
564ee5b847469eb8a61120179ce70a0213965785rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxydomain" id="proxydomain">Directive</a> <a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom de domaine par d�faut pour les requ�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyDomain <var>Domaine</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive n'a d'utilit� que pour les serveurs mandataires
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Apache httpd au sein d'un Intranet. La directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyDomain</code> permet de sp�cifier le domaine
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par d�faut auquel le serveur mandataire apache appartient. Si le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur re�oit une requ�te pour un h�te sans nom de domaine, il va
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar g�n�rer une r�ponse de redirection vers le m�me h�te suffix� par le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> ProxyRemote * http://firewall.example.com:81<br />
564ee5b847469eb8a61120179ce70a0213965785rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyerroroverride" id="proxyerroroverride">Directive</a> <a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Outrepasser les pages d'erreur pour les contenus
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyErrorOverride On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyErrorOverride Off</code></td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive est utile pour les configurations de mandataires
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar inverses, lorsque vous souhaitez que les pages d'erreur envoy�es
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aux utilisateurs finaux pr�sentent un aspect homog�ne. Elle permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aussi l'inclusion de fichiers (via les SSI de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>) pour obtenir le code d'erreur et agir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar en cons�quence (le comportement par d�faut afficherait la page
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'erreur du serveur mandat�, alors que c'est le message d'erreur SSI
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qui sera affich� si cette directive est � "on").</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive n'affecte pas le traitement des r�ponses
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar informatives (1xx), de type succ�s normal (2xx), ou de redirection
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (3xx).</p>
564ee5b847469eb8a61120179ce70a0213965785rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyiobuffersize" id="proxyiobuffersize">Directive</a> <a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�termine la taille du tampon interne de transfert de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyIOBufferSize <var>octets</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyIOBufferSize 8192</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">ProxyIOBufferSize</code> permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'ajuster la taille du tampon interne utilis� comme bloc-note pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les transferts de donn�es entre entr�e et sortie. La taille minimale
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans la plupart des cas, il n'y a aucune raison de modifier cette
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar valeur.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si elle est utilis�e avec AJP, cette directive permet de d�finir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la taille maximale du paquet AJP en octets. Si la valeur sp�cifi�e
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar est sup�rieure � 65536, elle est corrig�e et prend la valeur 65536.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Si vous ne conservez pas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la valeur par d�faut, vous devez aussi modifier l'attribut
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>packetSize</code> de votre connecteur AJP du c�t� de Tomcat !
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar L'attribut <code>packetSize</code> n'est disponible que dans Tomcat
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Il n'est normalement pas n�cessaire de modifier la taille
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar maximale du paquet. Des probl�mes ont cependant �t� rapport�s avec
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la valeur par d�faut lors de l'envoi de certificats ou de cha�nes de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar certificats.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxymatch" id="proxymatch">Directive</a> <a name="ProxyMatch" id="ProxyMatch"><ProxyMatch></a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conteneur de directives s'appliquant � des ressources
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarmandat�es correspondant � une expression rationnelle</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><ProxyMatch <var>regex</var>> ...</ProxyMatch></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
35fe7da687551c1d6e0f62e192f10e39f6a55208rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
35fe7da687551c1d6e0f62e192f10e39f6a55208rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive"><ProxyMatch></code> est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar identique � la directive <code class="directive"><a href="#proxy"><Proxy></a></code>, � l'exception qu'elle d�finit
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les URLs auxquelles elle s'applique en utilisant une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression rationnelle</a>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>A partir de la version 2.4.8, les groupes nomm�s et les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�f�rences arri�res sont extraits et enregistr�s dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'environnement avec leur nom en majuscules et pr�fix� par "MATCH_". Ceci permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de r�f�rencer des URLs dans des <a href="/expr.html">expressions</a>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ou au sein de modules comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �viter toute confusion, les r�f�rences arri�res num�rot�es (non
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar nomm�es) sont ignor�es. Vous devez utiliser � la place des groupes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar nomm�s.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<pre class="prettyprint lang-config"><ProxyMatch ^http://(?<sitename>[^/]+)>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</ProxyMatch></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><code class="directive"><a href="#proxy"><Proxy></a></code></li>
35fe7da687551c1d6e0f62e192f10e39f6a55208rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxymaxforwards" id="proxymaxforwards">Directive</a> <a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nombre maximum de mandataires � travers lesquelles une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyMaxForwards <var>nombre</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyMaxForwards -1</code></td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">ProxyMaxForwards</code> permet de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifier le nombre maximum de mandataires � travers lesquels une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te peut passer dans le cas o� la la requ�te ne contient pas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'en-t�te <code>Max-Forwards</code>. Ceci permet de se pr�munir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar contre les boucles infinies de mandataires ou contre les attaques de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar type d�ni de service.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyMaxForwards 15</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Notez que la d�finition de la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyMaxForwards</code> constitue une violation du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar protocole HTTP/1.1 (RFC2616), qui interdit � un mandataire de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finir <code>Max-Forwards</code> si le client ne l'a pas fait
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar lui-m�me. Les versions pr�c�dentes d'Apache httpd la d�finissaient
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar syst�matiquement. Une valeur n�gative de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyMaxForwards</code>, y compris la valeur par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�faut -1, implique un comportement compatible avec le protocole,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mais vous expose aux bouclages infinis.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypass" id="proxypass">Directive</a> <a name="ProxyPass" id="ProxyPass">ProxyPass</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>R�f�rencer des serveurs distants depuis
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPass [<var>chemin</var>] !|<var>url</var> [<var>cl�=valeur</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>[cl�=valeur</var> ...]] [nocanon] [interpolate] [noquery]</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Les Sockets de style Unix (Unix Domain Socket - UDS) sont support�s � partir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de r�f�rencer des serveurs distants depuis
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'espace d'URLs du serveur local ; le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar local n'agit pas en tant que mandataire au sens conventionnel, mais
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar plut�t comme miroir du serveur distant. Le serveur local est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <dfn>passerelle</dfn>. L'argument <var>chemin</var> est le nom d'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar chemin virtuel local ; <var>url</var> est une URL partielle pour le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur distant et ne doit pas contenir de cha�ne d'arguments.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="note"><strong>Note : </strong>Cette directive ne peut pas �tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilis�e dans un contexte de niveau r�pertoire.</div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="warning">En g�n�ral, la directive <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> doit �tre d�finie �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les sockets de style Unix sont support�s � partir de la version
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 2.4.7 du serveur HTTP Apache ; pour utiliser cette fonctionnalit�,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar il suffit d'utiliser une URL cible pr�fix�e par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>unix:/path/lis.sock|</code>. Par exemple, pour mandater HTTP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>unix:/home/www.socket|http://localhost/whatever/</code>. Comme
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le socket est local, le nom d'h�te utilis� (ici
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>localhost</code>) peut �tre sujet � discussion, mais il est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar transmis dans l'en-t�te Host: de la requ�te.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="note"><strong>Note :</strong>Le chemin associ� � l'URL
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">DefaultRuntimeDir</code>.</div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="note"><strong>Note :</strong>Afin d'�viter l'�chappement du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">RewriteRule</code> doit poss�der l'option
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Supposons que le serveur local a pour adresse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Location /mirror/foo/>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Location></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>va convertir en interne toute requ�te pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>http://example.com/miroir/foo/bar</code> en une requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandat�e pour <code>http://backend.example.com/bar</code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La syntaxe alternative suivante est valide, bien qu'elle puisse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar induire une d�gradation des performances lorsqu'elle est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pr�sente en tr�s grand nombre. Elle poss�de l'avantage de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar permettre un contr�le dynamique via l'interface <a href="mod_proxy_balancer.html#balancer_manager">Balancer Manager</a> :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass /miroir/foo/ http://backend.example.com/</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si le premier argument se termine par un slash
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <strong>/</strong>, il doit en �tre de m�me pour le second argument
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar et vice versa. Dans le cas contraire, il risque de manquer des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar slashes n�cessaires dans la requ�te r�sultante vers le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan et les r�sulats ne seront pas ceux attendus.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le drapeau <code>!</code> permet de soustraire un sous-r�pertoire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar du mandat inverse, comme dans l'exemple suivant :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Location /mirror/foo/>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Location>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ProxyPass !
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Location></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass /mirror/foo/i !
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>va mandater toutes les requ�tes pour <code>/miroir/foo</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar vers <code>backend.example.com</code>, <em>sauf</em> les requ�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="warning"><h3>Ordre de classement des directives ProxyPass</h3>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'ordre de leur apparition dans le fichier de configuration. La
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar premi�re r�gle qui correspond s'applique. Vous devez donc en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar g�n�ral classer les r�gles <code class="directive"><a href="#proxypass">ProxyPass</a></code> qui entrent en conflit de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'URL la plus longue � la plus courte. Dans le cas contraire, les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�gles situ�es apr�s une r�gle dont l'URL correspond au d�but de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar leur propre URL seront ignor�es. Notez que tout ceci est en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar relation avec le partage de workers. Par contre, on ne peut placer
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qu'une seule directive <code class="directive"><a href="#proxypass">ProxyPass</a></code> dans une section
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="/mod/core.html#location">Location</a></code>, et c'est la section
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la plus sp�cifique qui l'emportera.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Pour les m�mes raisons, les exclusions doivent se situer
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <em>avant</em> les directives <code class="directive">ProxyPass</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar g�n�rales.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les groupements de connexions vers un serveur d'arri�re-plan. Les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexions cr��es � la demande peuvent �tre enregistr�es dans un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar groupement pour une utilisation ult�rieure. La taille du groupe
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ainsi que d'autres caract�ristiques peuvent �tre d�finies via la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive">ProxyPass</code> au moyen de param�tres
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>cl�=valeur</code> dont la description fait l'objet du tableau
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ci-dessous.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Par d�faut, mod_proxy permet et met en r�serve le nombre maximum
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de connexions pouvant �tre utilis�es simultan�ment par le processus
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar enfant concern� du serveur web. Le param�tre <code>max</code> permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de r�duire cette valeur par d�faut. Le param�tre <code>ttl</code>,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar quant � lui, permet de d�finir une dur�e de vie optionnelle ; les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexions qui n'ont pas �t� utilis�es pendant au moins
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>ttl</code> secondes seront ferm�es. <code>ttl</code> permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aussi d'emp�cher l'utilisation d'une connexion susceptible d'�tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ferm�e suite � une fin de vie de connexion persistante sur le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur d'arri�re-plan.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le groupement de connexions est maintenu au niveau de chaque
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar processus enfant du serveur web, et <code>max</code>, ainsi que les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar autres param�tres, ne font
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'objet d'aucune coordination entre les diff�rents processus
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar enfants, sauf si un seul processus enfant est autoris� par la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar configuration ou la conception du module multi-processus (MPM).</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyPass /example http://backend.example.com max=20 ttl=120 retry=300</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <table class="bordered"><tr><th>Param�tres de BalancerMember</th></tr></table>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Nombre minimum d'entr�es dans le pool de connexions,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar distinct du nombre de connexions effectif. La valeur par d�faut
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ne doit �tre modifi�e que dans des circonstances particuli�res
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar o� la m�moire associ�e aux connexions avec le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan doit �tre pr�allou�e ou r�serv�e dans le tas.</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Nombre maximum de connexions autoris�es vers le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan. La valeur par d�faut correspond au nombre de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar threads par processus pour le MPM (Module Multi Processus)
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar actif. La valeur sera toujours 1 pour le MPM Prefork, alors
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qu'elle d�pendra de la d�finition de la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ThreadsPerChild</code> pour les autres MPMs.</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Les entr�es du pool de connexions conserv�es au del� de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar cette limite sont lib�r�es au cours de certaines op�rations si
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar elles n'ont pas �t� utilis�es au cours de leur dur�e de vie,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finie par le param�tre <code>ttl</code>. Si l'entr�e du pool
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de connexions est associ�e � une connexion, cette derni�re sera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ferm�e. La valeur par d�faut ne doit �tre modifi�e que dans des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar circonstances particuli�res o� les entr�es du pool de connexions
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar et toutes connexions associ�es qui ont d�pass� leur dur�e de vie
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar doivent �tre lib�r�es ou ferm�es de mani�re plus autoritaire.</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Cette cl� permet de d�finir le d�lai maximum d'attente pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar une connexion libre dans le jeu de connexions, en millisecondes.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar S'il n'y a pas de connexion libre dans le jeu, Apache httpd renverra
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>D�lai d'attente d'une connexion en secondes.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar La dur�e en secondes pendant laquelle Apache httpd va attendre pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'�tablissement d'une connexion vers le serveur d'arri�re-plan.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Le d�lai peut �tre sp�cifi� en millisecondes en ajoutant le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar suffixe ms.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Vous pouvez utiliser cette cl� pour forcer mod_proxy �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fermer imm�diatement une connexion vers le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan apr�s utilisation, et ainsi d�sactiver le jeu de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexions permanentes vers ce serveur. Ceci peut s'av�rer utile
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dans des situations o� un pare-feu situ� entre Apache httpd et le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur d'arri�re-plan (quelque soit le protocole) interrompt
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar des connexions de mani�re silencieuse, ou lorsque le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan lui-m�me est accessible par rotation de DNS
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (round-robin DNS). Pour d�sactiver la r�utilisation du jeu de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Fournie � l'intention des gestionnaires de projet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qui n�cessitent un accord pour la r�utilisation des connexions
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (tels que <code class="module"><a href="/mod/mod_proxy_fcgi.html">mod_proxy_fcgi</a></code>),
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar cette option est l'inverse de l'option 'disablereuse' ci-dessus.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Permet de d�finir si le module mandataire doit vider
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar automatiquement le tampon de sortie apr�s chaque tron�on de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar donn�es. 'off' signifie que le tampon sera vid� si n�cessaire,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 'on' que le tampon sera vid� apr�s chaque envoi d'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tron�on de donn�es, et 'auto' que le tampon sera vid� apr�s un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�lai de 'flushwait' millisecondes si aucune entr�e n'est re�ue.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Actuellement, cette cl� n'est support�e que par AJP.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Le d�lai d'attente pour une entr�e additionnelle, en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar millisecondes, avant le vidage du tampon en sortie dans le cas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar o� 'flushpackets' est � 'auto'.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Permet de d�finir la taille du tampon d'entr�es/sorties du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar bloc-notes interne. Cette cl� vous permet d'outrepasser la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive">ProxyIOBufferSize</code> pour un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur cible sp�cifique. La valeur doit �tre au minimum 512 ou d�finie
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � 0 pour la valeur par d�faut du syst�me de 8192.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td><p>Cette cl� doit �tre utilis�e lorsque vous avez un pare-feu
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar entre Apache httpd et le serveur d'arri�re-plan, et si ce dernier tend
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � interrompre les connexions inactives. Cette cl� va faire en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sorte que le syst�me d'exploitation envoie des messages
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>KEEP_ALIVE</code> sur chacune des connexions inactives et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ainsi �viter la fermeture de la connexion par le pare-feu.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Pour conserver les connexions persistantes, definissez cette
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La fr�quence de v�rification des connexions TCP persistantes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar initiale et subs�quentes d�pend de la configuration globale de l'OS,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar et peut atteindre 2 heures. Pour �tre utile, la fr�quence configur�e
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dans l'OS doit �tre inf�rieure au seuil utilis� par le pare-feu.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>D�finit le groupe de r�partition de charge dont le serveur cible
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar est membre. Le r�partiteur de charge va essayer tous les membres
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'un groupe de r�partition de charge de num�ro inf�rieur avant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'essayer ceux dont le groupe poss�de un num�ro sup�rieur.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Avec la cl� Ping, le serveur web va "tester" la connexion
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar vers le serveur d'arri�re-plan avant de transmettre la requ�te.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Pour les valeurs n�gatives, le test est une simple v�rification
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de socket, alors que pour les valeurs positives, il s'agit d'une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar v�rification plus approfondie d�pendant du protocole.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Avec AJP, <code class="module"><a href="/mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code> envoie une requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>CPING</code> sur la connexion ajp13 (impl�ment� sur Tomcat
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 3.3.2+, 4.1.28+ et 5.0.13+). Avec HTTP,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> envoie <code>100-Continue</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar au serveur d'arri�re-plan (seulement avecHTTP/1.1 - pour les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveurs d'arri�re-plan non HTTP/1.1, cette cl� ne produit
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aucun effet). Dans les deux cas, ce param�tre correspond au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�lai en secondes pour l'attente de la r�ponse. Cette
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fonctionnalit� a �t� ajout�e pour �viter les probl�mes avec les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveurs d'arri�re-plan bloqu�s ou surcharg�s.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�seau peut s'en trouver augment� en fonctionnement normal, ce
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar qui peut poser probl�me, mais peut s'en trouver diminu� dans les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar cas o� les noeuds de cluster sont arr�t�s ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar surcharg�s. Le d�lai peut
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aussi �tre d�fini en millisecondes en ajoutant le suffixe
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>D�finit la taille du tampon r�seau explicite (TCP/IP) pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les connexions mandat�es. Cette cl� vous permet d'outrepasser la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive">ProxyReceiveBufferSize</code> pour un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur cible sp�cifique. Sa valeur doit �tre au minimum 512 ou d�finie
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar � 0 pour la valeur par d�faut du syst�me.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Route pour la redirection du serveur cible. Cette valeur est en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar g�n�ral d�finie dynamiquement pour permettre une suppression
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s�curis�e du noeud du cluster. Si cette cl� est d�finie, toutes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les requ�tes sans identifiant de session seront redirig�es vers
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le membre de groupe de r�partition de charge dont la route
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspond � la valeur de la cl�.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>D�lai entre deux essais du serveur cible du jeu de connexions en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar secondes. Si le serveur cible du jeu de connexions vers le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan est dans un �tat d'erreur, Apache httpd ne redirigera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pas de requ�te vers ce serveur avant l'expiration du d�lai
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifi�. Ceci permet d'arr�ter le serveur d'arri�re-plan pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar maintenance, et de le remettre en ligne plus tard. Une valeur de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 0 implique de toujours essayer les serveurs cibles dans un �tat d'erreur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sans d�lai.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>La route du serveur cible lorsqu'il est utilis� au sein d'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur de charge. La route est une valeur ajout�e �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'identifiant de session.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Valeur constitu�e d'une simple lettre et d�finissant l'�tat
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar initial de ce serveur cible.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <tr><td>D: le serveur cible est d�sactiv� et n'accepte aucune requ�te.</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <tr><td>I: le serveur cible est en mode "erreurs ignor�es",
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <tr><td>H: le serveur cible est en mode d'attente et ne sera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilis� que si aucun autre serveur n'est disponible.</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <tr><td>N: le serveur cible est en mode vidage, n'acceptera que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les sessions persistantes qui lui appartiennent, et refusera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Une valeur d'�tat peut �tre d�finie (ce qui
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspond au comportement par d�faut) en pr�fixant la valeur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par '+', ou annul�e en pr�fixant la valeur par '-'. Ainsi, la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar valeur 'S-E' d�finit l'�tat de ce serveur cible � "arr�t�" et supprime
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le drapeau "en-erreur".
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td><code class="directive"><a href="#proxytimeout">ProxyTimeout</a></code></td>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>D�lai d'attente de la connexion en secondes. Le nombre de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar secondes pendant lesquelles Apache httpd attend l'envoi de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar donn�es vers le serveur d'arri�re-plan.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Dur�e de vie des connexions inactives et des entr�es du pool
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de connexions associ�es en secondes. Une fois cette
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar limite atteinte, une connexion ne sera pas r�utilis�e ; elle
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sera ferm�e apr�s un d�lai variable.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si l'URL de la directive Proxy d�bute par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>balancer://cluster</code>, toute information relative au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar chemin est ignor�e), alors un serveur cible virtuel ne communiquant pas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�ellement avec le serveur d'arri�re-plan sera cr��. Celui-ci sera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar en fait responsable de la gestion de plusieurs serveurs cibles "r�els". Dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ce cas, un jeu de param�tres particuliers s'applique � ce serveur cible
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar virtuel. Voir <code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> pour plus
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'informations � propos du fonctionnement du r�partiteur de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <table class="bordered"><tr><th>Param�tres du r�partiteur</th></tr></table>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>M�thode de r�partition de charge utilis�e. Permet de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s�lectionner la m�thode de planification de la r�partition de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar charge � utiliser. La valeur est soit <code>byrequests</code>,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pour effectuer un d�compte de requ�tes pond�r�es, soit
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>bytraffic</code>, pour effectuer une r�partition en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fonction du d�compte des octets transmis, soit
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>bybusyness</code>, pour effectuer une r�partition en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fonction des requ�tes en attente. La valeur par d�faut est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>1 de moins que le nombre de workers, ou 1 avec un seul
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar worker</td>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Nombre maximum d'�checs avant abandon.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Si ce param�tre est d�fini � <code>On</code>, la session va
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar s'interrompre si le serveur cible est dans un �tat d'erreur ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�sactiv�. D�finissez ce param�tre � On si le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan ne supporte pas la r�plication de session.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Nom de session persistant du r�partiteur. La valeur est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>PHPSESSIONID</code>, et d�pend du serveur d'application
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan qui supporte les sessions. Si le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'application d'arri�re-plan utilise des noms diff�rents pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les cookies et les identifiants cod�s d'URL (comme les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar conteneurs de servlet), s�parez-les par le caract�re '|'. La
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar premi�re partie contient le cookie et la seconde le chemin.<br />
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Disponible depuis la version 2.4.4 du serveur HTTP Apache.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Permet de d�finir le caract�re de s�paration dans le cookie
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de session. En effet, certains serveurs d'application d'arri�re-plan
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n'utilisent pas le '.' comme caract�re de s�paration. Par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar exemple, le serveur Oracle Weblogic utilise le caract�re '!'.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Cette option permet donc de d�finir le caract�re de s�paration �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar une valeur appropri�e. Si elle est d�finie � 'Off', aucun
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar caract�re de s�paration ne sera utilis�.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Si ce param�tre est d�fini � <code>On</code>, le caract�re
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ';' sera utilis� comme s�parateur de chemin de session
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar persistante additionnel. Ceci permet principalement de simuler
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le comportement de mod_jk lorsqu'on utilise des chemins du style
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>D�lai du r�partiteur en secondes. Si ce param�tre est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�fini, sa valeur correspond � la dur�e maximale d'attente pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar un serveur cible libre. Le comportement par d�faut est de ne pas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Une liste de codes d'�tat HTTP s�par�s par des virgules. Si
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ce param�tre est pr�sent, le worker se mettra en erreur si le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur d'arri�re-plan renvoie un des codes d'�tat sp�cifi�s
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dans la liste. La r�cup�ration du worker s'effectue comme dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le cas des autres erreurs de worker.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Si ce param�tre est d�fini � "On", un d�lai d'attente
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�pass� en entr�e/sortie apr�s envoi d'une requ�te au serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan va mettre le processus en �tat d'erreur. La
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sortie de cet �tat d'erreur se passe de la m�me fa�on que pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les autres erreurs.<br />
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Disponible depuis la version 2.4.5 du serveur HTTP Apache.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Le nombre � usage unique de protection utilis� dans la page
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de l'application <code>balancer-manager</code>. Par d�faut, la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar protection de la page est assur�e par un nombre � usage unique
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar automatique � base d'UUID. Si une valeur est pr�cis�e, elle sera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilis�e comme nombre � usage unique. La valeur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>None</code> d�sactive la v�rification du nombre � usage
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>En plus du nombre � usage unique, la page de l'application
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>balancer-manager</code> peut �tre prot�g�e par une ACL.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Nombre de membres suppl�mentaires que l'on peut ajouter � ce
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur en plus de ceux d�finis au niveau de la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar configuration.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <td>Force la relance imm�diate de tous les membres sans tenir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar compte de leur param�tre retry dans le cas o� ils sont tous en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �tat d'erreur. Il peut cependant arriver qu'un membre d�j�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar surcharg� entre dans une situation critique si la relance de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tous les membres est forc�e sans tenir compte du param�tre retry
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de chaque membre. Dans ce cas, d�finissez ce param�tre �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Disponible depuis la version 2.4.2 du serveur HTTP Apache.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Exemple de configuration d'un r�partiteur de charge</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass /special-area http://special.example.com smax=5 max=10
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<Proxy balancer://mycluster>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember ajp://1.2.3.4:8009
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember ajp://1.2.3.5:8009 loadfactor=20
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar # Less powerful server, don't send as many requests there,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember ajp://1.2.3.6:8009 loadfactor=5
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Configuration d'un serveur cible de r�serve qui ne sera utilis� que si
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aucun autre serveur cible n'est disponible</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass / balancer://hotcluster/
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<Proxy balancer://hotcluster>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember ajp://1.2.3.4:8009 loadfactor=1
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember ajp://1.2.3.5:8009 loadfactor=2
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar # The server below is on hot standby
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember ajp://1.2.3.6:8009 status=+H
564ee5b847469eb8a61120179ce70a0213965785rbowen ProxySet lbmethod=bytraffic
564ee5b847469eb8a61120179ce70a0213965785rbowen</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Normalement, mod_proxy va mettre sous leur forme canonique les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar URLs trait�es par ProxyPass. Mais ceci peut �tre incompatible avec
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar certains serveurs d'arri�re-plan, et en particulier avec ceux qui
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>nocanon</var> modifie ce comportement et permet de transmettre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar le chemin d'URL sous sa forme brute au serveur d'arri�re-plan. Notez
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar que ceci peut affecter la s�curit� de votre serveur d'arri�re-plan,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar car la protection limit�e contre les attaques � base d'URL que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fournit le mandataire est alors supprim�e.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Par d�faut, mod_proxy inclut la cha�ne de param�tres lors de la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar g�n�ration de la variable d'environnement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>SCRIPT_FILENAME</var>. Le mot-cl� optionnel <var>noquery</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (disponible � partir de la version 2.4.1) permet d'exclure cette
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar cha�ne.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Lorsque la directive ProxyPass est utilis�e � l'int�rieur d'une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>, le premier argument est omis et le r�pertoire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar local est obtenu � partir de la section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>. Il en sera de m�me dans une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar section <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code> ; cependant, ProxyPass
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n'interpr�te pas les expressions rationnelles, et il sera ici
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n�cessaire d'utiliser la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassMatch</code> � la place.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive ne peut pas �tre plac�e dans une section
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="/mod/core.html#files"><Files></a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si vous avez besoin d'un configuration de mandataire inverse plus
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar souple, reportez-vous � la documentaion de la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le mot-cl� optionnel <var>interpolate</var>, en combinaison avec la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassInterpolateEnv</code>, permet � ProxyPass
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'interpoler les variables d'environnement � l'aide de la syntaxe
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>${VARNAME}</var>. Notez que de nombreuses variables
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'environnement standard d�riv�es de CGI n'existeront pas lorsque
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'interpolation se produit ; vous devrez alors encore avoir avoir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar recours � <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> pour des r�gles
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar complexes. Notez aussi que l'interpolation n'est pas support�e dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la partie protocole d'une URL. La d�termination dynamique du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar protocole peut �tre effectu�e � l'aide de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> comme dans l'exemple suivant :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarRewriteCond %{HTTPS} =off
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarRewriteRule . - [E=protocol:http]
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarRewriteCond %{HTTPS} =on
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarRewriteRule . - [E=protocol:https]
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarRewriteRule ^/mirror/foo/(.*) %{ENV:protocol}://backend.example.com/$1 [P]
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyPassReverse /mirror/foo/ http://backend.example.com/
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyPassReverse /mirror/foo/ https://backend.example.com/</pre>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypassinherit" id="proxypassinherit">Directive</a> <a name="ProxyPassInherit" id="ProxyPassInherit">ProxyPassInherit</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>H�ritage des directives ProxyPass d�finies au niveau du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInherit On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPassInherit On</code></td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 2.4.5 du serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet � un serveur virtuel d'h�riter des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directives <code class="directive"><a href="#proxypass">ProxyPass</a></code> d�finies
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar au niveau du serveur principal. Si vous utilisez la fonctionnalit� de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar modifications dynamiques du Balancer Manager, cette directive peut
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar causer des probl�mes et des comportements inattendus et doit donc
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar �tre d�sactiv�e.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Les valeurs d�finies au niveau du serveur principal
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar constituent les valeurs par d�faut pour tous les serveurs virtuels.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La d�sactivation de ProxyPassInherit d�sactive aussi la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive <code class="directive"><a href="#balancerinherit">BalancerInherit</a></code>.</p>
f072359f493a5209335799da85ac16d6a273303bgryzor<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypassinterpolateenv" id="proxypassinterpolateenv">Directive</a> <a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'interpolation des variables d'environnement dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassInterpolateEnv On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPassInterpolateEnv Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
f072359f493a5209335799da85ac16d6a273303bgryzor<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive, ainsi que l'argument <var>interpolate</var> des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassReverseCookieDomain</code> et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassReverseCookiePath</code>, permet de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar configurer dynamiquement un mandataire inverse � l'aide de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar variables d'environnement, ces derni�res pouvant �tre d�finies par un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar autre module comme <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>. Elle affecte les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassReverseCookieDomain</code>, et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassReverseCookiePath</code>, en leur indiquant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de remplacer la cha�ne <code>${nom_var}</code> dans les directives
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de configuration par la valeur de la variable d'environnement
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>nom_var</code> (si l'option <var>interpolate</var> est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifi�e).</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Conservez cette directive � off (pour les performances du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur), sauf si vous en avez r�ellement besoin.</p>
564ee5b847469eb8a61120179ce70a0213965785rbowen<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypassmatch" id="proxypassmatch">Directive</a> <a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre des serveurs distants dans l'espace d'URL
1f1b6bf13313fdd14a45e52e553d3ff28689b717coardu serveur local en utilisant des expressions rationnelles</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassMatch [<var>regex</var>] !|<var>url</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
564ee5b847469eb8a61120179ce70a0213965785rbowen<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive est identique � la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>, mais fait usage des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar expressions rationnelles, au lieu d'une simple comparaison de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pr�fixes. L'expression rationnelle sp�cifi�e est compar�e �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'<var>url</var>, et si elle correspond, le serveur va substituer
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar toute correspondance entre parenth�ses dans la cha�ne donn�e et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="note"><strong>Note : </strong>Cette directive ne peut pas �tre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilis�e dans un contexte de niveau r�pertoire.</div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Supposons que le serveur local a pour adresse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com/$1</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>va provoquer la conversion interne de la requ�te locale
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>http://example.com/foo/bar.gif</code> en une requ�te mandat�e
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pour <code>http://backend.example.com/foo/bar.gif</code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'argument URL doit pouvoir �tre interpr�t� en tant qu'URL
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <em>avant</em> les substitutions d'expressions rationnelles (et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar doit aussi l'�tre apr�s). Ceci limite les correspondances que vous
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pouvez utiliser. Par exemple, si l'on avait utilis�</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPassMatch ^(/.*\.gif)$ http://backend.example.com:8000$1</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>dans l'exemple pr�c�dent, nous aurions provoqu� une erreur de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar syntaxe au d�marrage du serveur. C'est une bogue (PR 46665 dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ASF bugzilla), et il est possible de la contourner en reformulant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar la correspondance :</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPassMatch ^/(.*\.gif)$ http://backend.example.com:8000/$1</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Le drapeau <code>!</code> vous permet de ne pas mandater un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sous-r�pertoire donn�.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans une section <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code>, le premier argument est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar omis et l'expression rationnelle est obtenue � partir de la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Si vous avez besoin d'une configuration du mandataire inverse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar plus flexible, voyez la directive <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> avec le drapeau
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Lorsque le param�tre URL n'utilise pas de r�f�rences arri�res
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar dans l'expression rationnelle, l'URL originale sera ajout�e au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar param�tre URL.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Lors de la construction de l'URL cible de la r�gle, il convient
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de prendre en compte l'impact en mati�re de s�curit� qu'aura le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fait de permettre au client d'influencer le jeu d'URLs pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar lesquelles votre serveur agira en tant que mandataire.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Assurez-vous que la partie protocole://nom-serveur de l'URL soit
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar fixe, ou ne permette pas au client de l'influencer induement.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypassreverse" id="proxypassreverse">Directive</a> <a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverse [<var>chemin</var>] <var>url</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de faire en sorte qu'Apache httpd ajuste l'URL
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>Content-Location</code> et <code>URI</code> des r�ponses de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar redirection HTTP. Ceci est essentiel lorsqu'Apache httpd est utilis� en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar tant que mandataire inverse (ou passerelle), afin d'�viter de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar court-circuiter le mandataire inverse suite aux redirections HTTP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sur le serveur d'arri�re-plan qui restent derri�re le mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar inverse.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Seuls les en-t�tes de r�ponse HTTP sp�cialement mentionn�s
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ci-dessus seront r��crits. Apache httpd ne r��crira ni les autres en-t�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de r�ponse, ni par d�faut les r�f�rences d'URLs dans les pages HTML. Cela
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar signifie que dans le cas o� un contenu mandat� contient des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�f�rences � des URLs absolues, elles court-circuiteront le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire. Pour r��crire un contenu HTML afin qu'il corresponde au
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataire, vous devez charger et activer le module
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy_html.html">mod_proxy_html</a></code>.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p><var>chemin</var> est le nom d'un chemin virtuel local.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>url</var> est une URL partielle pour le serveur distant - ils
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sont utilis�s de la m�me fa�on qu'avec la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Supposons par exemple que le serveur local a pour adresse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPass /mirror/foo/ http://backend.example.com/
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyPassReverse /mirror/foo/ http://backend.example.com/
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarProxyPassReverseCookieDomain backend.example.com public.example.com
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>ne va pas seulement provoquer la conversion interne d'une requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar locale pour <code>http://example.com/miroir/foo/bar</code> en une
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te mandat�e pour <code>http://backend.example.com/bar</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar (la fonctionnalit� fournie par <code>ProxyPass</code>). Il va
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar aussi s'occuper des redirections que le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>http://backend.example.com/bar</code> est redirig� par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar celui-ci vers <code>http://backend.example.com/quux</code>, Apache
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar avant de faire suivre la redirection HTTP au client. Notez que le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar nom d'h�te utilis� pour construire l'URL est choisi en respectant la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d�finition de la directive <code class="directive"><a href="/mod/core.html#usecanonicalname">UseCanonicalName</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Notez que la directive <code class="directive">ProxyPassReverse</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar peut aussi �tre utilis�e en conjonction avec la fonctionnalit�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pass-through (<code>RewriteRule ... [P]</code>) du module
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, car elle ne d�pend pas d'une directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#proxypass">ProxyPass</a></code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspondante.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilis� en combinaison avec la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive">ProxyPassInterpolateEnv</code>, permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'interpolation des variables d'environnement sp�cifi�es en
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar utilisant le format <var>${VARNAME}</var>. Notez que l'interpolation
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n'est pas support�e dans la partie protocole d'une URL.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Lorsque cette directive est utilis�e dans une section <code class="directive"><a href="/mod/core.html#location"><Location></a></code>, le premier
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar argument est omis et le r�pertoire local est obtenu � partir de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'argument de la directive <code class="directive"><a href="/mod/core.html#location"><Location></a></code>. Il en est de m�me � l'int�rieur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'une section <code class="directive"><a href="/mod/core.html#locationmatch"><LocationMatch></a></code>, mais le r�sultat ne sera
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar probablement pas celui attendu car ProxyPassReverse va interpr�ter
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'expression rationnelle litt�ralement comme un chemin ; si besoin
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar est dans ce cas, d�finissez la directive ProxyPassReverse en dehors
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de la section, ou dans une section <code class="directive"><a href="/mod/core.html#location"><Location></a></code> s�par�e.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive ne peut pas �tre plac�e dans une section
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="/mod/core.html#files"><Files></a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypassreversecookiedomain" id="proxypassreversecookiedomain">Directive</a> <a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la cha�ne correspondant au domaine dans les en-t�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookieDomain <var>domaine-interne</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<var>domaine-public</var> [<var>interpolate</var>]</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<p>L'utilisation de cette directive est similaire � celle de la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coardirective <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>,
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarmais au lieu de r��crire des en-t�tes qui contiennent des URLs, elle
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarr��crit la cha�ne correspondant au domaine dans les en-t�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypassreversecookiepath" id="proxypassreversecookiepath">Directive</a> <a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajuste la cha�ne correspondant au chemin dans les en-t�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPassReverseCookiePath <var>chemin-interne</var>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<var>chemin-public</var> [<var>interpolate</var>]</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarCette directive s'av�re utile en conjonction avec la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code> dans les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarsituations o� les chemins d'URL d'arri�re-plan correspondent � des
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarchemins publics sur le mandataire inverse. Cette directive permet de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<code>Set-Cookie</code>. Si le d�but du chemin du cookie correspond �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<var>chemin-interne</var>, le chemin du cookie sera remplac� par
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarDans l'exemple fourni avec la directive <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code>, la directive :
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxyPassReverseCookiePath / /mirror/foo/</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarva r��crire un cookie poss�dant un chemin d'arri�re-plan <code>/</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxypreservehost" id="proxypreservehost">Directive</a> <a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyPreserveHost On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyPreserveHost Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Utilisable
1f1b6bf13313fdd14a45e52e553d3ff28689b717coardans un contexte de r�pertoire depuis la version 2.3.3.</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Lorsqu'elle est activ�e, cette directive va transmettre l'en-t�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Host: de la requ�te entrante vers le serveur mandat�, au lieu du nom
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'h�te sp�cifi� par la directive <code class="directive">ProxyPass</code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive est habituellement d�finie � <code>Off</code>.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Elle est principalement utile dans les configurations particuli�res
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar comme l'h�bergement virtuel mandat� en masse � base de nom, o�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'en-t�te Host d'origine doit �tre �valu� par le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'arri�re-plan.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyreceivebuffersize" id="proxyreceivebuffersize">Directive</a> <a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon r�seau pour les connexions mandat�es HTTP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyReceiveBufferSize <var>octets</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyReceiveBufferSize 0</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">ProxyReceiveBufferSize</code> permet
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de sp�cifier une taille de tampon r�seau explicite (TCP/IP) pour les
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexions mandat�es HTTP et FTP, afin d'am�liorer le d�bit de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar donn�es. Elle doit �tre sup�rieure � <code>512</code> ou d�finie �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>0</code> pour indiquer que la taille de tampon par d�faut du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar syst�me doit �tre utilis�e.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyReceiveBufferSize 2048</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyremote" id="proxyremote">Directive</a> <a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mandataire distant � utiliser pour traiter certaines
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemote <var>comparaison</var> <var>serveur-distant</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de d�finir des mandataires distants pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ce mandataire. <var>comparaison</var> est soit le nom d'un protocole
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar que supporte le serveur distant, soit une URL partielle pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar laquelle le serveur distant devra �tre utilis�, soit <code>*</code>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pour indiquer que le serveur distant doit �tre utilis� pour toutes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les requ�tes. <var>serveur-distant</var> est une URL partielle
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar correspondant au serveur distant. Syntaxe : </p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <var>protocole</var>://<var>nom-serveur</var>[:<var>port</var>]
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p><var>protocole</var> est effectivement le protocole � utiliser
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pour communiquer avec le serveur distant ; ce module ne supporte que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>http</code> et <code>https</code>. Lorsqu'on utilise
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>https</code>, les requ�tes sont redirig�es par le mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar distant en utilisant la m�thode HTTP CONNECT.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">ProxyRemote http://goodguys.example.com/ http://mirrorguys.example.com:8000
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Dans la derni�re ligne de l'exemple, le mandataire va faire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar suivre les requ�tes FTP, encapsul�es dans une autre requ�te mandat�e
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar HTTP, vers un autre mandataire capable de les traiter.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive supporte aussi les configurations de mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar inverse - un serveur web d'arri�re-plan peut �tre int�gr� dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar l'espace d'URL d'un serveur virtuel, m�me si ce serveur est cach�
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar par un autre mandataire direct.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyremotematch" id="proxyremotematch">Directive</a> <a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le mandataire distant � utiliser pour traiter les requ�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>serveur-distant</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>La directive <code class="directive">ProxyRemoteMatch</code> est
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar identique � la directive <code class="directive"><a href="#proxyremote">ProxyRemote</a></code>, � l'exception du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar premier argument qui est une <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expression
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar rationnelle</a> � mettre en correspondance avec l'URL de la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar requ�te.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyrequests" id="proxyrequests">Directive</a> <a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalit� (standard) de mandataire
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyRequests On|Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyRequests Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet d'activer/d�sactiver la fonctionnalit� de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur mandataire direct d'Apache httpd. D�finir ProxyRequests �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>Off</code> n'interdit pas l'utilisation de la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#proxypass">ProxyPass</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Pour une configuration typique de mandataire inverse ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar passerelle, cette directive doit �tre d�finie �
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Afin d'activer la fonctionnalit� de mandataire pour des sites
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar HTTP et/ou FTP, les modules <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> et/ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> doivent �galement �tre charg�s dans le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Pour activer la fonctionnalit� de mandataire sur les sites chiffr�s en HTTPS, le module
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code> doit �galement �tre charg� dans le serveur.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>N'activez pas la fonctionnalit� de mandataire avec la directive
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> avant
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'avoir <a href="#access">s�curis� votre serveur</a>. Les serveurs
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataires ouverts sont dangereux non seulement pour votre
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�seau, mais aussi pour l'Internet au sens large.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<li><a href="#forwardreverse">Mandataires/Passerelles directs et
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyset" id="proxyset">Directive</a> <a name="ProxySet" id="ProxySet">ProxySet</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit diff�rents param�tres relatifs � la r�partition de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coarcharge des mandataires et aux membres des groupes de r�partition de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive propose une m�thode alternative pour d�finir tout
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar param�tre relatif aux r�partiteurs de charge et serveurs cibles de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandataires normalement d�finis via la directive <code class="directive"><a href="#proxypass">ProxyPass</a></code>. Si elle se trouve dans un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar conteneur <code><Proxy <var>url de r�partiteur|url de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur cible</var>></code>, l'argument <var>url</var> n'est pas
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar n�cessaire. Comme effet de bord, le r�partiteur ou serveur cible respectif
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar est cr��. Ceci peut s'av�rer utile pour la mise en oeuvre d'un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar 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>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <div class="example"><pre class="prettyprint lang-config"><Proxy balancer://hotcluster>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember http://www2.example.com:8080 loadfactor=1
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar BalancerMember http://www3.example.com:8080 loadfactor=2
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ProxySet lbmethod=bytraffic
4aa603e6448b99f9371397d439795c91a93637eand</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config"><Proxy http://backend>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar ProxySet keepalive=On
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar</Proxy></pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxySet balancer://foo lbmethod=bytraffic timeout=15</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <pre class="prettyprint lang-config">ProxySet ajp://backend:7001 timeout=15</pre>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Gardez � l'esprit qu'une m�me cl� de param�tre peut avoir
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar diff�rentes significations selon qu'elle s'applique � un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur ou � un serveur cible, et ceci est illustr� par les deux
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar exemples pr�c�dents o� il est question d'un timeout.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxysourceaddress" id="proxysourceaddress">Directive</a> <a name="ProxySourceAddress" id="ProxySourceAddress">ProxySourceAddress</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit l'adresse IP locale pour les connexions mandat�es
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySourceAddress <var>adresse</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.9</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de d�finir une adresse IP locale
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sp�cifique � laquelle faire r�f�rence lors d'une connexion � un
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur d'arri�re-plan.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxystatus" id="proxystatus">Directive</a> <a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Affiche l'�tat du r�partiteur de charge du mandataire dans
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyStatus Off|On|Full</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyStatus Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de sp�cifier si les donn�es d'�tat du
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar r�partiteur de charge du mandataire doivent �tre affich�es via la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar page d'�tat du serveur du module <code class="module"><a href="/mod/mod_status.html">mod_status</a></code>.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>L'argument <strong>Full</strong> produit le m�me effet que
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxytimeout" id="proxytimeout">Directive</a> <a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�lai d'attente r�seau pour les requ�tes
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyTimeout <var>secondes</var></code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<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>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet � l'utilisateur de sp�cifier un d�lai pour
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar les requ�tes mandat�es. Ceci s'av�re utile dans le cas d'un serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar d'applications lent et bogu� qui a tendance � se bloquer, et si vous
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar pr�f�rez simplement renvoyer une erreur timeout et abandonner la
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar connexion en douceur plut�t que d'attendre jusqu'� ce que le serveur
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar veuille bien r�pondre.</p>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<div class="directive-section"><h2><a name="proxyvia" id="proxyvia">Directive</a> <a name="ProxyVia" id="ProxyVia">ProxyVia</a></h2>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Information fournie dans l'en-t�te de r�ponse HTTP
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyVia On|Off|Full|Block</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyVia Off</code></td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy</td></tr>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <p>Cette directive permet de contr�ler l'utilisation de l'en-t�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar HTTP <code>Via:</code> par le mandataire. Le but recherch� est de
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar contr�ler le flux des requ�tes mandat�es tout au long d'une cha�ne
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar de serveurs mandataires. Voir <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1),
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar section 14.45 pour une description des lignes d'en-t�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <li>Si elle est d�finie � <code>Off</code>, valeur par d�faut, cette
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar directive n'effectue aucun traitement particulier. Si une requ�te ou
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar une r�ponse contient un en-t�te <code>Via:</code>, il est transmis
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar sans modification.</li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <li>Si elle est d�finie � <code>On</code>, chaque requ�te ou r�ponse
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar se verra ajouter une ligne d'en-t�te <code>Via:</code> pour le
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar serveur courant.</li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <li>Si elle est d�finie � <code>Full</code>, chaque ligne d'en-t�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <code>Via:</code> se verra ajouter la version du serveur Apache
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar httpd sous la forme d'un champ de commentaire <code>Via:</code>.</li>
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar <li>Si elle est d�finie � <code>Block</code>, chaque requ�te
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar mandat�e verra ses lignes d'en-t�te <code>Via:</code> supprim�es.
1f1b6bf13313fdd14a45e52e553d3ff28689b717coar Aucun nouvel en-t�te <code>Via:</code> ne sera g�n�r�.</li>
f072359f493a5209335799da85ac16d6a273303bgryzor<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> |
f072359f493a5209335799da85ac16d6a273303bgryzor<a href="/fr/mod/mod_proxy.html" title="Fran�ais"> fr </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/ja/mod/mod_proxy.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p>
727872d18412fc021f03969b8641810d8896820bhumbedooh</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
727872d18412fc021f03969b8641810d8896820bhumbedoohvar comments_shortname = 'httpd';
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedoohvar comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy.html';
0d0ba3a410038e179b695446bb149cce6264e0abnd(function(w, d) {
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread"><\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd var s = d.createElement('script');
ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
0d0ba3a410038e179b695446bb149cce6264e0abnd (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd})(window, document);
205f749042ed530040a4f0080dbcb47ceae8a374rjung<p class="apache">Copyright 2015 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
0d0ba3a410038e179b695446bb149cce6264e0abndif (typeof(prettyPrint) !== 'undefined') {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();