You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2023/01/28 16:41:58 UTC
svn commit: r1907058 - in /httpd/httpd/trunk/docs/manual/mod: mod_proxy.xml.fr mod_proxy_wstunnel.xml.fr
Author: lgentis
Date: Sat Jan 28 16:41:58 2023
New Revision: 1907058
URL: http://svn.apache.org/viewvc?rev=1907058&view=rev
Log:
fr doc XML files updates.
Modified:
httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr
httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.fr
Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr?rev=1907058&r1=1907057&r2=1907058&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr [utf-8] Sat Jan 28 16:41:58 2023
@@ -1,7 +1,7 @@
<?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: 1904804:1907035 (outdated) -->
+<!-- English Revision:1907035 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -186,6 +186,12 @@ ProxyVia On
</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 -->
<section id="handler"><title>Accès via un gestionnaire</title>
@@ -1453,11 +1459,15 @@ ProxyPass "/mirror/foo/i" "!"
<td><p>Le mot de passe utilisé par <module>mod_proxy_ajp</module>. Voir
la documentation de ce module pour plus de détails.</p>
</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>
@@ -1723,6 +1733,33 @@ ProxyPassReverse "/mirror/foo/" "http:/
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>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.fr?rev=1907058&r1=1907057&r2=1907058&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.fr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy_wstunnel.xml.fr [utf-8] Sat Jan 28 16:41:58 2023
@@ -1,7 +1,7 @@
<?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: 1890110:1907040 (outdated) -->
+<!-- English Revision: 1907040 -->
<!-- French translation : Lucien GENTIS -->
<!--
@@ -33,6 +33,14 @@ websockets</description>
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
@@ -65,13 +73,21 @@ ProxyPass "/" "http://backend.example.c
<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>