granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy_http.xml.fr

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1652400 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_proxy_http.xml.meta">
  26
  27 <name>mod_proxy_http</name>
  28 <description>Module fournissant le support HTTP &agrave;
  29 <module>mod_proxy</module></description>
  30 <status>Extension</status>
  31 <sourcefile>mod_proxy_http.c</sourcefile>
  32 <identifier>proxy_http_module</identifier>
  33
  34 <summary>
  35     <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
  36     chargement de <module>mod_proxy</module>. Il fournit le support du
  37     mandatement des requ&ecirc;tes HTTP et HTTPS. <module>mod_proxy_http</module>
  38     supporte HTTP/0.9, HTTP/1.0 et HTTP/1.1. Il ne fournit
  39     <em>aucune</em> fonctionnalit&eacute; de mise en cache. Si vous souhaitez
  40     mettre en oeuvre un mandataire qui assure aussi les fonctions de
  41     mise en cache, vous devez utiliser les services du module
  42     <module>mod_cache</module>.</p>
  43
  44     <p>Ainsi, pour pouvoir traiter les requ&ecirc;tes HTTP mandat&eacute;es,
  45     <module>mod_proxy</module>, et <module>mod_proxy_http</module>
  46     doivent &ecirc;tre charg&eacute;s dans le serveur.</p>
  47
  48     <note type="warning"><title>Avertissement</title>
  49       <p>N'activez pas la fonctionnalit&eacute; de mandataire avant d'avoir <a
  50       href="mod_proxy.html#access">s&eacute;curis&eacute; votre serveur</a>. Les
  51       serveurs mandataires ouverts sont dangereux non seulement pour
  52       votre r&eacute;seau, mais aussi pour l'Internet au sens large.</p>
  53     </note>
  54 </summary>
  55 <seealso><module>mod_proxy</module></seealso>
  56 <seealso><module>mod_proxy_connect</module></seealso>
  57
  58 <section id="env"><title>Variables d'environnement</title>
  59     <p>Outre les directives de configuration qui contr&ocirc;lent le
  60     comportement de <module>mod_proxy</module>, plusieurs <dfn>variables
  61     d'environnement</dfn> permettent de contr&ocirc;ler le fournisseur du
  62     protocole HTTP. Parmi les variables suivantes, celle qui ne
  63     n&eacute;cessitent pas de valeur particuli&egrave;re sont d&eacute;finies quelle que soit
  64     la valeur qu'on leur affecte.</p>
  65     <dl>
  66         <dt>proxy-sendextracrlf</dt>
  67         <dd>Provoque l'envoi par le mandataire d'une nouvelle ligne
  68         CR-LF suppl&eacute;mentaire &agrave; la fin de la requ&ecirc;te.
  69         Ceci constitue un
  70         moyen de contournement d'une bogue de certains
  71         navigateurs.</dd>
  72         <dt>force-proxy-request-1.0</dt>
  73         <dd>Force le mandataire &agrave; envoyer des requ&ecirc;tes vers le serveur
  74         cible selon le protocole HTTP/1.0 et d&eacute;sactive les
  75         fonctionnalit&eacute;s propres &agrave; HTTP/1.1.</dd>
  76         <dt>proxy-nokeepalive</dt>
  77         <dd>Force le mandataire &agrave; fermer la connexion avec le serveur
  78         cible apr&egrave;s chaque requ&ecirc;te.</dd>
  79         <dt>proxy-chain-auth</dt>
  80         <dd>Si le mandataire requiert une authentification, il va lire
  81         et exploiter les donn&eacute;es d'authentification pour mandataire
  82         envoy&eacute;es par le client. Si <var>proxy-chain-auth</var> est
  83         d&eacute;finie, il va <em>aussi</em> faire suivre ces donn&eacute;es vers le
  84         mandataire suivant dans la cha&icirc;ne. Ceci peut s'av&eacute;rer n&eacute;cessaire
  85         si une cha&icirc;ne de mandataires partagent les informations
  86         d'authentification.
  87         <strong>Avertissement concernant la s&eacute;curit&eacute; :</strong>
  88         Ne d&eacute;finissez cette variable que si vous &ecirc;tes s&ucirc;r d'en avoir
  89         besoin, car elle peut provoquer la divulgation d'informations
  90         sensibles !</dd>
  91         <dt>proxy-sendcl</dt>
  92         <dd>Avec HTTP/1.0, toutes les requ&ecirc;tes qui poss&egrave;dent un corps
  93         (par exemple les requ&ecirc;tes POST) doivent comporter un en-t&ecirc;te
  94         <var>Content-Length</var>. Cette variable d'environnement force
  95         le mandataire Apache &agrave; envoyer cet en-t&ecirc;te au serveur cible,
  96         sans tenir compte de ce que lui a envoy&eacute; le client. Ceci permet
  97         d'assurer la compatibilit&eacute; lorsqu'on mandate un serveur cible
  98         mettant en oeuvre un protocole de type HTTP/1.0 ou inconnu. Elle
  99         peut cependant n&eacute;cessiter la mise en tampon de l'int&eacute;gralit&eacute; de
 100         la requ&ecirc;te par le mandataire, ce qui s'av&egrave;re tr&egrave;s inefficace
 101         pour les requ&ecirc;tes de grande taille.</dd>
 102         <dt>proxy-sendchunks ou proxy-sendchunked</dt>
 103         <dd>Cette variable constitue l'oppos&eacute; de
 104         <var>proxy-sendcl</var>. Elle permet la transmission des corps
 105         de requ&ecirc;tes vers le serveur cible en utilisant un codage de
 106         transfert fractionn&eacute;. Ceci permet une transmission des requ&ecirc;tes
 107         plus efficace, mais n&eacute;cessite que le serveur cible supporte le
 108         protocole HTTP/1.1.</dd>
 109         <dt>proxy-interim-response</dt>
 110         <dd>Cette variable peut prendre les valeurs <code>RFC</code>
 111         (valeur par d&eacute;faut) ou
 112         <code>Suppress</code>. Les versions pr&eacute;c&eacute;dentes de httpd
 113         supprimaient les r&eacute;ponses interm&eacute;diaires HTTP (1xx) envoy&eacute;es par
 114         le serveur cible. En pratique, si un serveur cible envoie une
 115         r&eacute;ponse interm&eacute;diaire, il se peut qu'il &eacute;tende lui-m&ecirc;me le
 116         protocole d'une mani&egrave;re dont nous n'avons pas connaissance, ou
 117         tout simplement non conforme. Le comportement du mandataire est
 118         donc maintenant configurable : d&eacute;finissez
 119         <code>proxy-interim-response RFC</code> pour &ecirc;tre totalement
 120         compatible avec le protocole, ou <code>proxy-interim-response
 121         Suppress</code> pour supprimer les r&eacute;ponses interm&eacute;diaires.</dd>
 122         <dt>proxy-initial-not-pooled</dt>
 123         <dd>Si cette variable est d&eacute;finie, aucune connexion faisant
 124         partie d'un jeu ne sera r&eacute;utilis&eacute;e si la requ&ecirc;te
 125         du client est la requ&ecirc;te initiale pour une connexion.
 126         Ceci permet d'&eacute;viter le message d'erreur
 127         "proxy: error reading status line from remote server" caus&eacute; par
 128         la situation de comp&eacute;tition au cours de laquelle le serveur
 129         cible ferme la connexion du jeu apr&egrave;s la v&eacute;rification de la
 130         connexion par le mandataire,  et avant que les donn&eacute;es envoy&eacute;es
 131         par le mandataire n'atteignent le serveur cible. Il faut
 132         cependant garder &agrave; l'esprit que la d&eacute;finition de cette variable
 133         d&eacute;grade les performances, particuli&egrave;rement avec les clients
 134         HTTP/1.0.
 135         </dd>
 136     </dl>
 137 </section>
 138
 139 <section id="notes"><title>Informations sur les requ&ecirc;tes</title>
 140     <p><module>mod_proxy_http</module> enregistre les informations
 141     suivantes pour journalisation via le format <code>%{NOMVAR}n</code>
 142     dans les directives <directive
 143     module="mod_log_config">LogFormat</directive> ou <directive
 144     module="core">ErrorLogFormat</directive> :
 145     </p>
 146     <dl>
 147         <dt>proxy-source-port</dt>
 148         <dd>Le port local utilis&eacute; pour la connexion vers le serveur
 149         d'arri&egrave;re-plan.</dd>
 150         <dt>proxy-status</dt>
 151         <dd>Le code d'&eacute;tat HTTP re&ccedil;u du serveur d'arri&egrave;re-plan.</dd>
 152     </dl>
 153 </section>
 154
 155 </modulesynopsis>