From: Lucien Gentis <lgentis@apache.org>
Date: Sat, 28 Jan 2023 16:41:58 +0000 (+0000)
Subject: fr doc XML files updates.
X-Git-Tag: 2.5.0-alpha2-ci-test-only~125
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=222c0cf28f6f6bb8057c6c8f62be7aad68baf90b;p=thirdparty%2Fapache%2Fhttpd.git

fr doc XML files updates.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1907058 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr
index cf8f873c33d..0db4cc92c79 100644
--- a/docs/manual/mod/mod_proxy.xml.fr
+++ b/docs/manual/mod/mod_proxy.xml.fr
@@ -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 -->
 
@@ -184,6 +184,12 @@ ProxyVia On
 &lt;Proxy *&gt;
   Require host internal.example.com
 &lt;/Proxy&gt;
+    </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 -->
@@ -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://backend.example.com/"
 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>
 
diff --git a/docs/manual/mod/mod_proxy_wstunnel.xml.fr b/docs/manual/mod/mod_proxy_wstunnel.xml.fr
index db821320850..d2560042f84 100644
--- a/docs/manual/mod/mod_proxy_wstunnel.xml.fr
+++ b/docs/manual/mod/mod_proxy_wstunnel.xml.fr
@@ -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.com:9080/"
 <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>