From: Lucien Gentis Date: Sat, 28 Jan 2023 16:53:07 +0000 (+0000) Subject: fr doc XML files updates. X-Git-Tag: 2.4.56-candidate~29 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=66682197e681ab763a938b54523fd5feb3a32453;p=thirdparty%2Fapache%2Fhttpd.git fr doc XML files updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1907061 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr index d0fd579c945..5f28d211ed2 100644 --- a/docs/manual/mod/mod_proxy.xml.fr +++ b/docs/manual/mod/mod_proxy.xml.fr @@ -1,7 +1,7 @@ - + @@ -184,6 +184,12 @@ ProxyVia On <Proxy "*"> Require host internal.example.com </Proxy> + + + <a id="wsupgrade" name="wsupgrade">Promotion de protocole + vers Websocket (versions 2.4.47 et ultérieures)</a> + +ProxyPass "/some/ws/capable/path/" "http://example.com/some/ws/capable/path/" upgrade=websocket @@ -1407,11 +1413,15 @@ ProxyPass "/mirror/foo/i" "!" AJP.
Disponible à partir de la version 2.4.42 du serveur HTTP Apache. - upgrade - WebSocket -

Le protocol accepté par mod_proxy_wstunnel dans - l'en-tête Upgrade. Voir la documentation de ce module pour plus de - détails.

+ upgrade + - +

Protocole pris en charge par mod_proxy_http ou + mod_proxy_wstunnel pour le mécanisme de promotion de + protocole HTTP lors d'une négociation du client/navigateur HTTP (en + accord avec RFC 9110 - + Upgrade). Voir la note Promotion de + protocole ci-dessous

mapping - @@ -1695,6 +1705,33 @@ ProxyPassReverse "/mirror/foo/" "http://backend.example.com/" ProxyPassReverse "/mirror/foo/" "https://backend.example.com/" + <a id="protoupgrade" name="protoupgrade">Promotion de + protocole</a> +

Depuis la version 2.4.47 du serveur HTTP Apache, la promotion de + protocole (tunneling) peut être géré bout à bout par + mod_proxy_http en utilisant le paramètre upgrade.

+

Bout à bout signifie que la requête de promotion de protocole en + provenance du client/navigateur est tout d'abord transmise par + mod_proxy_http au serveur origine et que le protocole de + la connexion ne sera modifié (et « tunnelisé » par + mod_proxy_http) que si le serveur origine accepte/initie + la promotion (réponse HTTP 101 Switching Protocols). Si le + serveur origine renvoie une réponse différente, + mod_proxy_http continuera la transmission en utilisant + (et en forçant) le protocole HTTP habituel pour cette connexion.

+

Voir Promotion de protocole vers Websocket + (versions 2.4.47 et ultérieures) pour un exemple de configuration qui + utilisemod_proxy_http.

+

Avec les versions 2.4.46 et antérieures du serveur HTTP Apache (ou si + la directive ProxyWebsocketFallbackToProxyHttp + des versions 2.4.48 et ultérieures désactive la prise en charge par + mod_proxy_http), voir la documentation de + mod_proxy_wstunnel pour la méthode permettant de mandater + le protocole WebSocket.

+ + diff --git a/docs/manual/mod/mod_proxy_wstunnel.xml.fr b/docs/manual/mod/mod_proxy_wstunnel.xml.fr index 7ad0e79b3ca..1999fa0e5ad 100644 --- a/docs/manual/mod/mod_proxy_wstunnel.xml.fr +++ b/docs/manual/mod/mod_proxy_wstunnel.xml.fr @@ -1,7 +1,7 @@ - + @@ -34,6 +34,14 @@ websockets Apache + <a id="deprecation" + name="deprecation">Obsolescence</a> +

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 + mod_proxy_http.

+

Voir Promotion de protocole.

+ +

Pour utiliser ce module, mod_proxy doit être chargé. Il fournit le support du tunnelling pour les connexions websocket vers un serveur websockets d'arrière-plan. La connexion @@ -79,13 +87,21 @@ RewriteRule ^/?(.*) "ws://example.com:9080/$1" [P,L]

La répartition de charge entre plusieurs serveurs d'arrière-plan peut être configurée via le module mod_proxy_balancer.

-

En fait, ce module permet d'accepter d'autres protocoles ; vous pouvez à cet -effet utiliser le paramètre upgrade de la directive ProxyPass. 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 Upgrade -va lire les en-têtes de la requête et les utilisera dans l'en-tête -Upgrade de la réponse.

+

+Ce module peut aussi être utilisé pour la promotion vers des protocoles autres +que WebSocket en définissant le paramètre upgrade de la directive ProxyPass avec un nom de +protocole particulier. +Les valeurs spéciales upgrade=NONE et upgrade=ANY +peuvent être utilisées pour tester ou forcer la promotion de protocole mais leur +utilisation n'est pas recommandée en production pour des +raisons de sécurité. +NONE signifie que la vérification de l'en-tête est omise mais que +la promotion (tunneling) vers WebSocket s'effectuera quand-même. +ANY signifie que la promotion (tunneling) s'effectuera en utilisant +tout protocole demandé par le client. +

 mod_proxy