diff options
Diffstat (limited to '')
| -rw-r--r-- | docs/manual/mod/mod_proxy.html.fr.utf8 | 248 |
1 files changed, 193 insertions, 55 deletions
diff --git a/docs/manual/mod/mod_proxy.html.fr.utf8 b/docs/manual/mod/mod_proxy.html.fr.utf8 index 9e15bd2..d05e64e 100644 --- a/docs/manual/mod/mod_proxy.html.fr.utf8 +++ b/docs/manual/mod/mod_proxy.html.fr.utf8 @@ -30,6 +30,8 @@ <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="outofdate">Cette traduction peut être périmée. Vérifiez la version + anglaise pour les changements récents.</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> @@ -79,7 +81,9 @@ <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> @@ -117,6 +121,7 @@ <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> @@ -234,6 +239,9 @@ ProxyVia On 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></h2> @@ -513,9 +521,6 @@ ProxyPass "/examples" "http://backend.example.com/examples" timeout=10</pre> 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> - <p>La directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> ne s'applique qu'aux - corps de requêtes que le serveur met en file d'attente sur disque.</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 @@ -701,7 +706,7 @@ NoProxy ".example.com" "192.168.112.0/21"</pre> 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>.example.com.</code> (notez le point à la fin du nom) sont + <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> @@ -846,6 +851,29 @@ mandatées</td></tr> </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></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></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des informations à propos du mandataire aux @@ -968,11 +996,13 @@ ProxyDomain ".example.com"</pre> <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 On|Off</code></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'états a été ajoutée à partir de la version +2.4.47 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 @@ -987,6 +1017,21 @@ mandatés</td></tr> 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></h2> @@ -1486,7 +1531,7 @@ ProxyPass "/mirror/foo" "http://backend.example.com"</pre> </td></tr> <tr><td>timeout</td> <td><code class="directive"><a href="#proxytimeout">ProxyTimeout</a></code></td> - <td>Délai d'attente de la connexion en secondes. Le nombre de + <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. </td></tr> @@ -1504,14 +1549,69 @@ ProxyPass "/mirror/foo" "http://backend.example.com"</pre> </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>Le mot de passe utilisé par <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>. Il doit + identique au mot de passe configuré sur le côté serveur de la connexion + AJP.<br /> + Disponible à partir de la version 2.4.42 du serveur HTTP Apache. + </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>upgrade</td> - <td>WebSocket</td> - <td><p>Le protocol accepté par <code class="module"><a href="../mod/mod_proxy_wstunnel.html">mod_proxy_wstunnel</a></code> dans - l'en-tête Upgrade. Voir la documentation de ce module pour plus de - détails.</p> + <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> @@ -1719,7 +1819,7 @@ ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofail souple, reportez-vous à la documentaion de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> et son drapeau <code>[P]</code>.</p> - <p>Le mot-clé optionnel <var>interpolate</var>, en combinaison avec la directive + <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 @@ -1747,6 +1847,31 @@ 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> @@ -1786,7 +1911,7 @@ les configurations de mandataires inverses</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.2.9 d'Apache</td></tr> </table> - <p>Cette directive, ainsi que l'argument <var>interpolate</var> des + <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 @@ -1800,7 +1925,7 @@ les configurations de mandataires inverses</td></tr> <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 <var>interpolate</var> est + <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 @@ -1821,12 +1946,15 @@ les configurations de mandataires inverses</td></tr> <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>clé=valeur</var> - <var>[clé=valeur</var> ...]]</code></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 @@ -1848,22 +1976,6 @@ du serveur local en utilisant des expressions rationnelles</td></tr> <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> - <div class="note"><h3>Note</h3> - <p>L'argument URL doit pouvoir être interprété en tant qu'URL - <em>avant</em> les substitutions d'expressions rationnelles (et - doit aussi l'être après). Ceci limite les correspondances que vous - pouvez utiliser. Par exemple, si l'on avait utilisé</p> - <pre class="prettyprint lang-config"> ProxyPassMatch "^(/.*\.gif)$" - "http://backend.example.com:8000$1"</pre> - - <p>dans l'exemple précédent, nous aurions provoqué une erreur de - syntaxe au démarrage du serveur. C'est une bogue (PR 46665 dans - ASF bugzilla), et il est possible de la contourner en reformulant - la correspondance :</p> - <pre class="prettyprint lang-config">ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com:8000/$1"</pre> - - </div> - <p>Le drapeau <code>!</code> vous permet de ne pas mandater un sous-répertoire donné.</p> @@ -1883,6 +1995,25 @@ du serveur local en utilisant des expressions rationnelles</td></tr> </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 @@ -1900,7 +2031,7 @@ du serveur local en utilisant des expressions rationnelles</td></tr> <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> -[<var>interpolate</var>]</code></td></tr> +[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> @@ -1959,13 +2090,11 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre> <code class="directive"><a href="#proxypass">ProxyPass</a></code> correspondante.</p> - <p>Le mot-clé optionnel <var>interpolate</var>, en - combinaison avec la directive - <code class="directive">ProxyPassInterpolateEnv</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>Le mot-clé optionnel <code>interpolate</code>, 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 @@ -1987,7 +2116,7 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/"</pre> <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> [<var>interpolate</var>]</code></td></tr> +<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> @@ -2005,7 +2134,7 @@ réécrit la chaîne correspondant au domaine dans les en-têtes <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> [<var>interpolate</var>]</code></td></tr> +<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> @@ -2045,8 +2174,8 @@ du mandataire</td></tr> 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 - Host: 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> + <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 @@ -2082,25 +2211,27 @@ et FTP</td></tr> <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>comparaison</var> <var>serveur-distant</var></code></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 facultatif est disponible depuis 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>comparaison</var> est soit le nom d'un protocole + 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>serveur-distant</var> est une URL partielle + 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>] + <dfn>remote-server</dfn> = + <var>scheme</var>://<var>hostname</var>[:<var>port</var>] </code></p></div> - <p><var>protocole</var> est effectivement le protocole à utiliser + <p><var>scheme</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 @@ -2120,6 +2251,13 @@ ProxyRemote "ftp" "http://ftpproxy.mydomain:8080"</pre> 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></h2> @@ -2330,7 +2468,7 @@ mandatées</td></tr> <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 again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div> +</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/2.4/mod/mod_proxy.html'; @@ -2348,7 +2486,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_proxy.html'; } })(window, document); //--><!]]></script></div><div id="footer"> -<p class="apache">Copyright 2019 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="apache">Copyright 2024 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/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- if (typeof(prettyPrint) !== 'undefined') { prettyPrint(); |