mod_proxy_http.xml.fr revision c3a2738228cb6ba4a48c425711e728d3410a458e
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<!-- English Revision : 1154342 -->
fd9abdda70912b99b24e3bf1a38f26fde908a74cnd<!-- French translation : Lucien GENTIS -->
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe<!-- Reviewed by : Vincent Deffontaines -->
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe Licensed to the Apache Software Foundation (ASF) under one or more
96ad5d81ee4a2cc66a4ae19893efc8aa6d06fae7jailletc contributor license agreements. See the NOTICE file distributed with
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe this work for additional information regarding copyright ownership.
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe The ASF licenses this file to You under the Apache License, Version 2.0
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen (the "License"); you may not use this file except in compliance with
2e545ce2450a9953665f701bb05350f0d3f26275nd the License. You may obtain a copy of the License at
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe Unless required by applicable law or agreed to in writing, software
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen distributed under the License is distributed on an "AS IS" BASIS,
3f08db06526d6901aa08c110b5bc7dde6bc39905nd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe See the License for the specific language governing permissions and
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe limitations under the License.
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe<description>Module fournissant le support HTTP à
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe chargement de <module>mod_proxy</module>. Il fournit le support du
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe mandatement des requêtes HTTP et HTTPS. <module>mod_proxy_http</module>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe supporte HTTP/0.9, HTTP/1.0 et HTTP/1.1. Il ne fournit
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <em>aucune</em> fonctionnalité de mise en cache. Si vous souhaitez
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe mettre en oeuvre un mandataire qui assure aussi les fonctions de
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe mise en cache, vous devez utiliser les services du module
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <p>Ainsi, pour pouvoir traiter les requêtes HTTP mandatées,
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <module>mod_proxy</module>, et <module>mod_proxy_http</module>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe doivent être chargés dans le serveur.</p>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe href="mod_proxy.html#access">sécurisé votre serveur</a>. Les
cae0359c9286c8e34cbccd15eee2da90562c1ee2sf serveurs mandataires ouverts sont dangereux non seulement pour
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh votre réseau, mais aussi pour l'Internet au sens large.</p>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe<section id="env"><title>Variables d'environnement</title>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <p>Outre les directives de configuration qui contrôlent le
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe comportement de <module>mod_proxy</module>, plusieurs <dfn>variables
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe d'environnement</dfn> permettent de contrôler le fournisseur du
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe protocole HTTP :</p>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Provoque l'envoi par le mandataire d'une nouvelle ligne
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe CR-LF supplémentaire à la fin de la requête. Cei constitue un
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe moyen de contournement d'une bogue de certains
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe navigateurs.</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Force le mandataire à envoyer des requêtes vers le serveur
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe cible selon le protocole HTTP/1.0 et désactive les
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe fonctionnalités propres à HTTP/1.1.</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Force le mandataire à fermer la connexion avec le serveur
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe cible après chaque requête.</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Si le mandataire requiert une authentification, il va lire
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe et exploiter les données d'authentification pour mandataire
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe envoyées par le client. Si <var>proxy-chain-auth</var> est
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe définie, il va <em>aussi</em> faire suivre ces données vers le
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe mandataire suivant dans la chaîne. Ceci peut s'avérer nécessaire
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe si une chaîne de mandataires partagent les informations
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe d'authentification.
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <strong>Avertissement concernant la sécurité :</strong>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe Ne définissez cette variable que si vous êtes sûr d'en avoir
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe besoin, car elle peut provoquer la divulgation d'informations
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe sensibles !</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Avec HTTP/1.0, toutes les requêtes qui possèdent un corps
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe (par exemple les requêtes POST) doivent comporter un en-tête
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <var>Content-Length</var>. Cette variable d'environnement force
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe le mandataire Apache à envoyer cet en-tête au serveur cible,
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe sans tenir compte de ce que lui a envoyé le client. Ceci permet
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe d'assurer la compatibilité lorsqu'on mandate un serveur cible
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe mettant en oeuvre un protocole de type HTTP/1.0 ou inconnu. Elle
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe peut cependant nécessiter la mise en tampon de l'intégralité de
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe la requête par le mandataire, ce qui s'avère très inefficace
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe pour les requêtes de grande taille.</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Cette variable constitue l'opposé de
49acc6accb4061182ef84dc991aaa346ad01a8ecsf <var>proxy-sendcl</var>. Elle permet la transmission des corps
49acc6accb4061182ef84dc991aaa346ad01a8ecsf de requêtes vers le serveur cible en utilisant un codage de
49acc6accb4061182ef84dc991aaa346ad01a8ecsf transfert fractionné. Ceci permet une transmission des requêtes
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe plus efficace, mais nécessite que le serveur cible supporte le
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Cette variable peut prendre les valeurs <code>RFC</code>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe (valeur par défaut) ou
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <code>Suppress</code>. Les versions précédentes de httpd
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe supprimaient les réponses intermédiaires HTTP (1xx) envoyées par
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe le serveur cible. En pratique, si un serveur cible envoie une
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe réponse intermédiaire, il se peut qu'il étende lui-même le
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe protocole d'une manière dont nous n'avons pas connaissance, ou
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe tout simplement non conforme. Le comportement du mandataire est
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe donc maintenant configurable : définissez
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <code>proxy-interim-response RFC</code> pour être totalement
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe compatible avec le protocole, ou <code>proxy-interim-response
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe Suppress</code> pour supprimer les réponses intermédiaires.</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Si cette variable est définie, aucune connexion faisant
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe partie d'un jeu ne sera réutilisée si la connexion client est
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe une connexion initiale. Ceci permet d'éviter le message d'erreur
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe "proxy: error reading status line from remote server" causé par
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe la situation de compétition au cours de laquelle le serveur
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe cible ferme la connexion du jeu après la vérification de la
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe connexion par le mandataire, et avant que les données envoyées
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe par le mandataire n'atteignent le serveur cible. Il faut
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe cependant garder à l'esprit que la définition de cette variable
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe dégrade les performances, particulièrement avec les clients
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe<section id="notes"><title>Informations sur les requêtes</title>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <p><module>mod_proxy_http</module> enregistre les informations
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe suivantes pour journalisation via le format <code>%{NOMVAR}n</code>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe dans les directives <directive
b7f8d802ecaed65eada1fc31472d06d8460d5528igalic module="mod_log_config">LogFormat</directive> ou <directive
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Le port local utilisé pour la connexion vers le serveur
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe d'arrière-plan.</dd>
fc32fe886201ffcf1ca557bdf7d34a7468ab3374wrowe <dd>Le code d'état HTTP reçu du serveur d'arrière-plan.</dd>
9652bc3a93433d52f80579062986ead2afe0d11fsf</modulesynopsis>