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