<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1901499:1907047 (outdated) -->
+<!-- English Revision: 1907047 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<Proxy "*">
Require host internal.example.com
</Proxy>
+ </highlight>
+ </example>
+ <example><title><a id="wsupgrade" name="wsupgrade">Promotion de protocole
+ vers Websocket (versions 2.4.47 et ultérieures)</a></title>
+ <highlight language="config">
+ProxyPass "/some/ws/capable/path/" "http://example.com/some/ws/capable/path/" upgrade=websocket
</highlight>
</example>
</section> <!-- /examples -->
AJP.<br />
Disponible à partir de la version 2.4.42 du serveur HTTP Apache.
</td></tr>
- <tr><td>upgrade</td>
- <td>WebSocket</td>
- <td><p>Le protocol accepté par <module>mod_proxy_wstunnel</module> dans
- l'en-tête Upgrade. Voir la documentation de ce module pour plus de
- détails.</p>
+ <tr><td><a id="upgrade" name="upgrade">upgrade</a></td>
+ <td>-</td>
+ <td><p>Protocole pris en charge par <module>mod_proxy_http</module> ou
+ <module>mod_proxy_wstunnel</module> 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>
ProxyPassReverse "/mirror/foo/" "https://backend.example.com/"
</highlight>
+ <note><title><a id="protoupgrade" name="protoupgrade">Promotion de
+ protocole</a></title>
+ <p>Depuis la version 2.4.47 du serveur HTTP Apache, la promotion de
+ protocole (tunneling) peut être géré bout à bout par
+ <module>mod_proxy_http</module> 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
+ <module>mod_proxy_http</module> au serveur origine et que le protocole de
+ la connexion ne sera modifié (et « tunnelisé » par
+ <module>mod_proxy_http</module>) 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,
+ <module>mod_proxy_http</module> 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<module>mod_proxy_http</module>.</p>
+ <p>Avec les versions 2.4.46 et antérieures du serveur HTTP Apache (ou si
+ la directive <directive
+ module="mod_proxy_wstunnel">ProxyWebsocketFallbackToProxyHttp</directive>
+ des versions 2.4.48 et ultérieures désactive la prise en charge par
+ <module>mod_proxy_http</module>), voir la documentation de
+ <module>mod_proxy_wstunnel</module> pour la méthode permettant de mandater
+ le protocole WebSocket.</p>
+ </note>
+
</usage>
</directivesynopsis>
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1890113:1907042 (outdated) -->
+<!-- English Revision: 1907042 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Apache</compatibility>
<summary>
+ <note type="warning"><title><a id="deprecation"
+ name="deprecation">Obsolescence</a></title>
+ <p>Depuis la version 2.4.47 du serveur HTTP Apache, la promotion de
+ protocole (tunneling) peut être pris en charge de manière plus efficace par
+ <module>mod_proxy_http</module>.</p>
+ <p>Voir <a href="mod_proxy.html#protoupgrade">Promotion de protocole</a>.</p>
+ </note>
+
<p>Pour utiliser ce module, <module>mod_proxy</module> doit être
chargé. Il fournit le support du tunnelling pour les connexions
websocket vers un serveur websockets d'arrière-plan. La connexion
<p>La répartition de charge entre plusieurs serveurs d'arrière-plan peut être
configurée via le module <module>mod_proxy_balancer</module>.</p>
-<p>En fait, ce module permet d'accepter d'autres protocoles ; vous pouvez à cet
-effet utiliser le paramètre <code>upgrade</code> de la directive <directive
-type="ProxyPass" module="mod_proxy">ProxyPass</directive>. La valeur NONE
-signifie que vous court-circuitez la consultation de l'en-tête, mais que vous
-autorisez quand-même WebSocket. La valeur ANY signifie que <code>Upgrade</code>
-va lire les en-têtes de la requête et les utilisera dans l'en-tête
-<code>Upgrade</code> de la réponse.</p>
+<p>
+Ce module peut aussi être utilisé pour la promotion vers des protocoles autres
+que WebSocket en définissant le paramètre <var><a
+href="mod_proxy.html#upgrade">upgrade</a></var> de la directive <directive
+type="ProxyPass" module="mod_proxy">ProxyPass</directive> avec un nom de
+protocole particulier.
+Les valeurs spéciales <code>upgrade=NONE</code> et <code>upgrade=ANY</code>
+peuvent être utilisées pour tester ou forcer la promotion de protocole mais leur
+utilisation <strong>n'est pas recommandée</strong> en production pour des
+raisons de sécurité.
+<code>NONE</code> signifie que la vérification de l'en-tête est omise mais que
+la promotion (tunneling) vers WebSocket s'effectuera quand-même.
+<code>ANY</code> signifie que la promotion (tunneling) s'effectuera en utilisant
+tout protocole demandé par le client.
+</p>
</summary>
<seealso><module>mod_proxy</module></seealso>
projects / thirdparty / apache / httpd.git / commitdiff
