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:54:09 UTC
svn commit: r1907062 - in /httpd/httpd/branches/2.4.x/docs/manual/mod: mod_proxy.html.fr.utf8 mod_proxy.xml.meta mod_proxy_wstunnel.html.fr.utf8 mod_proxy_wstunnel.xml.meta
Author: lgentis
Date: Sat Jan 28 16:54:08 2023
New Revision: 1907062
URL: http://svn.apache.org/viewvc?rev=1907062&view=rev
Log:
fr doc rebuild.
Modified:
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.html.fr.utf8
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.xml.meta
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8
httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.xml.meta
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.html.fr.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.html.fr.utf8?rev=1907062&r1=1907061&r2=1907062&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.html.fr.utf8 [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.html.fr.utf8 [utf-8] Sat Jan 28 16:54:08 2023
@@ -30,8 +30,6 @@
<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>
@@ -239,6 +237,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>
@@ -1551,11 +1552,14 @@ ProxyPass "/mirror/foo" "http://backend.
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 <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><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>
@@ -1835,6 +1839,31 @@ ProxyPassReverse "/mirror/foo/" "http:/
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>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.xml.meta?rev=1907062&r1=1907061&r2=1907062&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy.xml.meta Sat Jan 28 16:54:08 2023
@@ -8,7 +8,7 @@
<variants>
<variant>en</variant>
- <variant outdated="yes">fr</variant>
+ <variant>fr</variant>
<variant outdated="yes">ja</variant>
</variants>
</metafile>
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8?rev=1907062&r1=1907061&r2=1907062&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8 [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.html.fr.utf8 [utf-8] Sat Jan 28 16:54:08 2023
@@ -29,8 +29,6 @@
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_wstunnel.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_proxy_wstunnel.html" title="Français"> fr </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>Module pour <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> supportant les
websockets</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
@@ -40,6 +38,13 @@ websockets</td></tr>
Apache</td></tr></table>
<h3>Sommaire</h3>
+ <div class="warning"><h3><a id="deprecation" name="deprecation">Obsolescence</a></h3>
+ <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
+ <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>.</p>
+ <p>Voir <a href="mod_proxy.html#protoupgrade">Promotion de protocole</a>.</p>
+ </div>
+
<p>Pour utiliser ce module, <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> doit être
chargé. Il fournit le support du tunnelling pour les connexions
websocket vers un serveur websockets d'arrière-plan. La connexion
@@ -76,12 +81,19 @@ RewriteRule ^/?(.*) "ws://example.com:90
<p>La répartition de charge entre plusieurs serveurs d'arrière-plan peut être
configurée via le module <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>.</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 <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>. 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 <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> 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>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><h3 class="directives">Directives</h3>
<ul id="toc">
Modified: httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.xml.meta?rev=1907062&r1=1907061&r2=1907062&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/mod/mod_proxy_wstunnel.xml.meta Sat Jan 28 16:54:08 2023
@@ -8,6 +8,6 @@
<variants>
<variant>en</variant>
- <variant outdated="yes">fr</variant>
+ <variant>fr</variant>
</variants>
</metafile>