httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lgen...@apache.org
Subject svn commit: r1805630 [21/30] - in /httpd/httpd/trunk/docs/manual: ./ mod/
Date Mon, 21 Aug 2017 13:43:47 GMT
Modified: httpd/httpd/trunk/docs/manual/mod/mod_reflector.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_reflector.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_reflector.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_reflector.html.fr Mon Aug 21 13:43:45 2017
@@ -83,19 +83,17 @@ filtres en sortie.</td></tr>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="reflectorheader" id="reflectorheader">Directive</a> <a name="ReflectorHeader" id="ReflectorHeader">ReflectorHeader</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Renvoie un en-tête d'entrée dans les en-têtes de sortie</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReflectorHeader <var>en-tête-entrée</var> <var>[en-tête-sortie]</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Reflect an input header to the output headers</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReflectorHeader <var>inputheader</var> <var>[outputheader]</var></code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Options</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_reflector</td></tr>
 </table>
-    <p>Cette directive permet de contrôler la répercution des en-têtes
-    de la requête dans la réponse. Le premier argument correspond au nom
-    de l'en-tête à copier. Si le second argument (optionnel) est
-    spécifié, il définit le nom sous lequel l'en-tête sera répercuté
-    dans la réponse ; dans le cas contraire, c'est le nom de l'en-tête
-    original qui sera utilisé.</p>
+    <p>This directive controls the reflection of request headers to the response.
+    The first argument is the name of the request header to copy. If the optional
+    second argument is specified, it will be used as the name of the response
+    header, otherwise the original request header name will be used.</p>
 
 </div>
 </div>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_remoteip.html.fr Mon Aug 21 13:43:45 2017
@@ -139,57 +139,48 @@ répartiteur de charge via les en-têtes
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteipheader" id="remoteipheader">Directive</a> <a name="RemoteIPHeader" id="RemoteIPHeader">RemoteIPHeader</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le champ d'en-tête qui contiendra les adresses IP
-du client</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>en-tête</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare the header field which should be parsed for useragent IP addresses</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>header-field</var></code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
 </table>
-    <p>La directive <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> indique à
-    <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> de traiter la valeur de
-    l'<var>en-tête</var> spécifié comme l'adresse IP du client, ou comme
-    une liste d'adresses IP clients intermédiaires, en fonction de la
-    configuration des directives
-    <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> et
-    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>.</p>
-    
-    <div class="warning">Si ces deux dernières
-    directives ne sont pas utilisées, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
-    traitera tout hôte présentant une adresse non interne
-    dans l'en-tête <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> comme hôte de
-    confiance.</div>
+    <p>The <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> directive triggers
+    <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> to treat the value of the specified
+    <var>header-field</var> header as the useragent IP address, or list
+    of intermediate useragent IP addresses, subject to further configuration
+    of the <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> and
+    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> directives.</p>
 
-    <div class="example"><h3>Exemple à usage interne (répartiteur de
-    charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP</pre>
+    <div class="warning"> Unless these other directives are used, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> 
+    will trust all hosts presenting a non internal address in the 
+    <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> header value.
+    </div>
+
+    <div class="example"><h3>Internal (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP</pre>
 </div>
 
-    <div class="example"><h3>Exemple dans le cas d'un mandataire</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For</pre>
+    <div class="example"><h3>Proxy Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For</pre>
 </div>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteipinternalproxy" id="remoteipinternalproxy">Directive</a> <a name="RemoteIPInternalProxy" id="RemoteIPInternalProxy">RemoteIPInternalProxy</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
-confiance pour présenter la valeur RemoteIPHeader</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy
-<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
 </table>
-    <p>La directive <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> permet
-    d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles
-    on peut faire confiance pour présenter une valeur RemoteIPHeader
-    valide de l'adresse IP du client. A la différence de la directive
-    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>, toute adresse IP
-    présentée dans cet en-tête, y comprises les adresses intranet
-    privées, sont considérées comme dignes de confiance lorsqu'elles
-    sont indiquées par ces mandataires.</p>
+    <p>The <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> directive adds one
+    or more addresses (or address blocks) to trust as presenting a valid
+    RemoteIPHeader value of the useragent IP.  Unlike the
+    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> directive, any IP address
+    presented in this header, including private intranet addresses, are
+    trusted when passed from these proxies.</p>
 
-    <div class="example"><h3>Exemple à usage interne (répartiteur de
-    charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
+    <div class="example"><h3>Internal (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
 RemoteIPInternalProxy 10.0.2.0/24
 RemoteIPInternalProxy gateway.localdomain</pre>
 </div>
@@ -198,56 +189,47 @@ RemoteIPInternalProxy gateway.localdomai
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteipinternalproxylist" id="remoteipinternalproxylist">Directive</a> <a name="RemoteIPInternalProxyList" id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de
-confiance pour présenter la valeur RemoteIPHeader</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare client intranet IP addresses trusted to present the RemoteIPHeader value</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>filename</var></code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
 </table>
-    <p>La directive <code class="directive"><a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></code>
-    permet de spécifier un fichier parcouru au démarrage du serveur pour
-    construire une liste d'adresses (ou blocs d'adresses), auxquelles
-    on peut faire confiance pour présenter une valeur RemoteIPHeader
-    valide de l'adresse IP du client.</p>
-
-    <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
-    sinon, toutes les lignes séparées par un caractère <code>nouvelle
-    ligne</code> ou
-    tous les éléments d'une ligne séparés par un espace sont traités de
-    la même façon qu'avec la directive
-    <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code>.</p>
+    <p>The <code class="directive"><a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></code> directive specifies
+    a file parsed at startup, and builds a list of addresses (or address blocks)
+    to trust as presenting a valid RemoteIPHeader value of the useragent IP.</p>
+
+    <p>The '<code>#</code>' hash character designates a comment line, otherwise
+    each whitespace or newline separated entry is processed identically to
+    the <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> directive.</p>
 
-    <div class="example"><h3>Exemple à usage interne (répartiteur de
-    charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
+    <div class="example"><h3>Internal (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
 RemoteIPInternalProxyList conf/trusted-proxies.lst</pre>
 </div>
 
-    <div class="example"><h3>contenu de conf/mandataires-de-confiance.lst</h3><pre>         # Nos mandataires internes de confiance
-         10.0.2.0/24         # Tout le monde dans le groupe de test
-         passerelle.domaine-local # Le frontal répartiteur de charge</pre></div>
+    <div class="example"><h3>conf/trusted-proxies.lst contents</h3><pre># Our internally trusted proxies;
+10.0.2.0/24         #Everyone in the testing group
+gateway.localdomain #The front end balancer</pre></div>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteipproxiesheader" id="remoteipproxiesheader">Directive</a> <a name="RemoteIPProxiesHeader" id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare le champ d'en-tête qui contiendra toutes les
-adresses IP intermédiaires</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>Nom_en-tête</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Declare the header field which will record all intermediate IP addresses</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>HeaderFieldName</var></code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
 </table>
-    <p>La directive <code class="directive"><a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></code> permet
-    de spécifier l'en-tête dans lequel <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> va
-    collecter une liste de toutes les adresses IP clients intermédiaires
-    auxquelles on pourra faire confiance pour résoudre l'adresse IP
-    client de la requête. Notez que les adresses intermédiaires
-    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> sont enregistrées dans
-    cet en-tête, alors que toute adresse intermédiaire
-    <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> est omise.</p>
+    <p>The <code class="directive"><a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></code> directive specifies
+    a header into which <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> will collect a list of
+    all of the intermediate client IP addresses trusted to resolve the useragent
+    IP of the request. Note that intermediate
+    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> addresses are recorded in
+    this header, while any intermediate
+    <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> addresses are discarded.</p>
 
-    <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
+    <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
 RemoteIPProxiesHeader X-Forwarded-By</pre>
 </div>
 
@@ -255,41 +237,38 @@ RemoteIPProxiesHeader X-Forwarded-By</pr
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteipproxyprotocol" id="remoteipproxyprotocol">Directive</a> <a name="RemoteIPProxyProtocol" id="RemoteIPProxyProtocol">RemoteIPProxyProtocol</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive la gestion du protocole PROXY</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enable or disable PROXY protocol handling</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxyProtocol On|Off</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.26 du serveur HTTP Apache</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>RemoteIPProxyProtocol is only available in httpd 2.4.26 and newer</td></tr>
 </table>
-    <p>La directive <code class="directive">RemoteIPProxyProtocol</code> permet
-    d'activer ou de désactiver la prise en compte et la gestion de l'en-tête de
-    connexion du protocole PROXY. Si elle est définie à <code>On</code>, la
-    demande du client <em>doit</em> envoyer l'en-tête approprié pour chaque
-    nouvelle connexion, sinon cette dernière sera fermée à moins qu'il ne fasse
-    partie de la liste, définie via la directive <code class="directive"><a href="#remoteipproxyprotocoldisablehosts">RemoteIPProxyProtocolDisableHosts</a></code>, des
-    hôtes pour lesquels le protocole PROXY est désactivé.</p>
-
-    <p>Bien que cette directive peut être définie au niveau de n'importe quel
-    serveur virtuel, il est important de garder à l'esprit que, étant donné que
-    le protocole PROXY est basé sur la connexion et agnostique quant au
-    protocle, son activation/désactivation est basée sur le couple adresse
-    IP/port. Cela signifie que si plusieurs serveurs virtuels à base de nom sont
-    configurés avec le même couple adresse IP/port, et si vous activez le
-    protocole PROXY pour l'un d'entre eux, il le sera aussi pour tous les autres
-    (avec le même couple adresse IP/port). Cela signifie aussi que si vous
-    tentez d'activer le protocole PROXY pour un serveur virtuel et de le
-    désactiver pour un autre, cela ne marchera pas ; dans ce dernier cas, la
-    dernière directive l'emporte sur les autres et une notification sera
-    enregistrée dans le journal pour indiquer les réglages qui ont été annulés.</p>
+    <p>The <code class="directive">RemoteIPProxyProtocol</code> directive enables or 
+    disables the reading and handling of the PROXY protocol connection header.
+    If enabled with the <code>On</code> flag, the upstream client <em>must</em>
+    send the header every time it opens a connection or the connection will
+    be aborted unless it is in the list of disabled hosts provided by <code class="directive"><a href="#remoteipproxyprotocolexceptions">RemoteIPProxyProtocolExceptions</a></code>
+    directive.</p>
+
+    <p>While this directive may be specified in any virtual host, it is
+    important to understand that because the PROXY protocol is connection
+    based and protocol agnostic, the enabling and disabling is actually based
+    on ip-address and port. This means that if you have multiple name-based
+    virtual hosts for the same host and port, and you enable it any one of
+    them, then it is enabled for all them (with that host and port). It also
+    means that if you attempt to enable the PROXY protocol in one and disable
+    in the other, that won't work; in such a case the last one wins and a
+    notice will be logged indicating which setting was being overridden.</p>
 
     <pre class="prettyprint lang-config">Listen 80
 &lt;VirtualHost *:80&gt;
     ServerName www.example.com
     RemoteIPProxyProtocol On
 
-    #Les requêtes pour ce serveur virtuel doivent contenir un en-tête du
-    #protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée.
+    #Requests to this virtual host must have a PROXY protocol
+    # header provided. If it is missing, the connection will
+    # be aborted
 &lt;/VirtualHost&gt;
 
 Listen 8080
@@ -298,9 +277,10 @@ Listen 8080
     RemoteIPProxyProtocol On
     RemoteIPProxyProtocolExceptions 127.0.0.1 10.0.0.0/8
 
-    #Les requêtes pour ce serveur virtuel doivent contenir un en-tête du
-    #protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée à moins
-    que sa source ne soit localhost ou la gamme d'adresses RFC1918 10.x.x.x
+    #Requests to this virtual host must have a PROXY protocol
+    # header provided. If it is missing, the connection will
+    # be aborted except when coming from localhost or the
+    # 10.x.x.x RFC1918 range
 &lt;/VirtualHost&gt;</pre>
 
 
@@ -308,56 +288,46 @@ Listen 8080
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteipproxyprotocolexceptions" id="remoteipproxyprotocolexceptions">Directive</a> <a name="RemoteIPProxyProtocolExceptions" id="RemoteIPProxyProtocolExceptions">RemoteIPProxyProtocolExceptions</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive la prise en compte de l'en-tête PROXY pour certains hôtes
-ou réseaux</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Disable processing of PROXY header for certain hosts or networks</td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxyProtocolExceptions host|range [host|range] [host|range]</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>RemoteIPProxyProtocolExceptions est disponible à partir de la
-version 2.4.26 du serveur HTTP Apache</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>RemoteIPProxyProtocolExceptions is only available in httpd 2.4.26 and newer</td></tr>
 </table>
-    <p>La directive <code class="directive">RemoteIPProxyProtocol</code> permet de
-    contrôler la prise en compte de l'en-tête de connexion du protocole PROXY.
-    Il est parfois souhaitable d'exiger pour certains clients la
-    présence de l'en-tête PROXY, mais aussi de permettre aux autres clients de
-    se connecter sans ce dernier. Cette directive permet à l'administrateur du
-    serveur d'autoriser cette possibilité à un hôte isolé ou à une gamme d'hôtes
-    au format CIDR.</p>
+    <p>The <code class="directive">RemoteIPProxyProtocol</code> directive enables or
+    disables the reading and handling of the PROXY protocol connection header.
+    Sometimes it is desirable to require clients to provide the PROXY header, but
+    permit other clients to connect without it. This directive allows a server 
+    administrator to configure a single host or CIDR range of hosts that may do
+    so.</p>
 
 </div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteiptrustedproxy" id="remoteiptrustedproxy">Directive</a> <a name="RemoteIPTrustedProxy" id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restreint les adresses IP clients dignes de
-confiance pour présenter la valeur RemoteIPHeader</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy
-<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict client IP addresses trusted to present the RemoteIPHeader value</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy <var>proxy-ip</var>|<var>proxy-ip/subnet</var>|<var>hostname</var> ...</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
 </table>
-    <p>La directive <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> permet
-    de définir quelles adresses IP (ou blocs d'adresses) seront
-    considérées comme de confiance pour présenter une valeur RemoteIPHeader
-    valide de l'adresse IP du client.</p>
-    
-    <p>A la différence de la directive
-    <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code>, toutes les adresses IP
-    intranet ou privées indiquées par de tels mandataires, y compris les
-    blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8
-    (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas
-    dignes de confiance en tant qu'adresses IP clientes, et se situent
-    à gauche dans le contenu de l'en-tête
-    <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.</p>
-
-    <div class="warning">Par défaut, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
-    considérera comme de confiance tout hôte présentant une adresse non
-    interne dans l'en-tête <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.
+    <p>The <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> 
+    directive restricts which peer IP addresses (or address blocks) will be
+    trusted to present  a valid RemoteIPHeader value of the useragent IP.</p>
+  
+    <p> Unlike the <code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> directive, any intranet
+    or private IP address reported by such proxies, including the 10/8, 172.16/12,
+    192.168/16, 169.254/16 and 127/8 blocks (or outside of the IPv6 public
+    2000::/3 block) are not trusted as the useragent IP, and are left in the
+    <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> header's value.</p>
+
+    <div class="warning">By default, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> will trust 
+    all hosts presenting a non internal address in the 
+    <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code> header value.
     </div>
 
-    <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
-    charge</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
+    <div class="example"><h3>Trusted (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
 RemoteIPTrustedProxy 10.0.2.16/28
 RemoteIPTrustedProxy proxy.example.com</pre>
 </div>
@@ -366,34 +336,28 @@ RemoteIPTrustedProxy proxy.example.com</
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="remoteiptrustedproxylist" id="remoteiptrustedproxylist">Directive</a> <a name="RemoteIPTrustedProxyList" id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restreint les adresses IP clients dignes de
-confiance pour présenter la valeur RemoteIPHeader</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Restrict client IP addresses trusted to present the RemoteIPHeader value</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>filename</var></code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr>
 </table>
-    <p>La directive <code class="directive"><a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></code>
-    permet de spécifier un fichier parcouru au démarrage du serveur pour
-    construire une liste d'adresses (ou blocs d'adresses), auxquelles
-    on peut faire confiance pour présenter une valeur RemoteIPHeader
-    valide de l'adresse IP du client.</p>
-
-    <p>Le caractère '<code>#</code>' indique une ligne de commentaires,
-    sinon, toutes les lignes séparées par un caractère nouvelle ligne ou
-    tous les éléments d'une ligne séparés par un espace sont traités de
-    la même façon qu'avec la directive
-    <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>.</p>
+    <p>The <code class="directive"><a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></code> directive specifies
+    a file parsed at startup, and builds a list of addresses (or address blocks)
+    to trust as presenting a valid RemoteIPHeader value of the useragent IP.</p>
+
+    <p>The '<code>#</code>' hash character designates a comment line, otherwise
+    each whitespace or newline separated entry is processed identically to
+    the <code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> directive.</p>
 
-    <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de
-    charge</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
+    <div class="example"><h3>Trusted (Load Balancer) Example</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
 RemoteIPTrustedProxyList conf/trusted-proxies.lst</pre>
 </div>
 
-    <div class="example"><h3>conf/mandataires-de-confiance.lst contents</h3><p><code>
-       # Mandataires externes identifiés<br />
-       192.0.2.16/28         #groupe wap phone de mandataires<br />
-       proxy.isp.example.com #un FAI bien connu
+    <div class="example"><h3>conf/trusted-proxies.lst contents</h3><p><code>
+       # Identified external proxies;<br />
+       192.0.2.16/28         #wap phone group of proxies<br />
+       proxy.isp.example.com #some well known ISP
     </code></p></div>
 
 </div>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_reqtimeout.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_reqtimeout.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_reqtimeout.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_reqtimeout.html.fr Mon Aug 21 13:43:45 2017
@@ -95,91 +95,84 @@ données minimum pour la réception des
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="requestreadtimeout" id="requestreadtimeout">Directive</a> <a name="RequestReadTimeout" id="RequestReadTimeout">RequestReadTimeout</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des délais maximums pour la réception des en-têtes
-et corps des requêtes en provenance du client.
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set timeout values for receiving request headers and body from client.
 </td></tr>
 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RequestReadTimeout
-[header=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
-[body=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]
+[header=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>rate</var>]
+[body=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>rate</var>]
 </code></td></tr>
 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>header=20-40,MinRate=500 body=20,MinRate=500</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_reqtimeout</td></tr>
-<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Désactivée par défaut jusqu'à la version 2.3.14.</td></tr>
+<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Defaulted to disabled in
+version 2.3.14 and earlier.</td></tr>
 </table>
-    <p>Cette directive permet de définir différents délais pour la
-    réception des en-têtes et corps des requêtes en provenance du
-    client. Si le client ne parvient pas à respecter ces délais, un code
-    d'erreur <code>408 REQUEST TIME OUT</code> est envoyé.</p>
-
-    <p>Pour les serveurs virtuels SSL, le délai concernant les en-têtes
-    inclut le temps nécessaire à la négociation SSL initiale. Si le
-    navigateur du client est configuré pour demander des listes de
-    révocations de certificats, et si le serveur correspondant n'est pas
-    disponible, le délai avant lequel le navigateur va abandonner son
-    attente de CRL au cours de la négociation SSL initiale peut être
-    assez important. Par conséquent, les valeurs de délais d'en-têtes ne
-    doivent pas être trop basses pour les serveurs virtuels SSL. Le délai
-    concernant le corps inclut le temps nécessaire à la renégociation
-    SSL (si elle est nécessaire).</p>
-
-    <p>Lorsqu'une directive <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> est active (ce qui est en
-    général le cas sous Linux et FreeBSD), le socket n'est envoyé au
-    processus du serveur qu'après la réception du premier octet (ou de
-    l'ensemble de la requête si <code>httpready</code> est défini). Le
-    délai configuré pour les en-têtes via la directive
-    <code>RequestReadTimeout</code> n'entre en ligne de compte qu'une fois
-    le socket reçu par le processus du serveur.</p>
+    <p>This directive can set various timeouts for receiving the request headers
+    and the request body from the client. If the client fails to send headers or
+    body within the configured time, a <code>408 REQUEST TIME OUT</code> error
+    is sent.</p>
+
+    <p>For SSL virtual hosts, the header timeout values include the time needed
+    to do the initial SSL handshake.  If the user's browser is configured to
+    query certificate revocation lists and the CRL server is not reachable, the
+    initial SSL handshake may take a significant time until the browser gives up
+    waiting for the CRL.  Therefore the header timeout values should not be set
+    to very low values for SSL virtual hosts.
+    The body timeout values include the time needed for SSL renegotiation
+    (if necessary).</p>
+
+    <p>When an <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> is in use
+    (usually the case on Linux and FreeBSD), the socket is not sent to the
+    server process before at least one byte (or the whole request for
+    <code>httpready</code>) is received. The header timeout configured with
+    <code>RequestReadTimeout</code> is only effective after the server process has
+    received the socket.</p>
 
-    <p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête
-    ou le corps) :
+    <p>For each of the two timeout types (header or body), there are three ways
+    to specify the timeout:
     </p>
 
     <ul>
 
-    <li><strong>Valeur de délai fixe</strong>:<br />
+    <li><strong>Fixed timeout value</strong>:<br />
 
-    <div class="example"><p><code><var>type</var>=<var>délai</var></code></p></div>
+    <div class="example"><p><code><var>type</var>=<var>timeout</var></code></p></div>
 
-    <p>Le temps en secondes alloué pour la lecture des en-têtes ou du
-    corps de la requête. La valeur 0 signifie aucune limite.</p>
+    <p>The time in seconds allowed for reading all of the request headers or
+    body, respectively. A value of 0 means no limit.</p>
     </li>
 
-    <li><strong>Désactivation du module pour un serveur virtuel :</strong>:<br />
+    <li><strong>Disable module for a vhost:</strong>:<br />
 
     <div class="example"><p><code>header=0 body=0</code></p></div>
 
-    <p>Avec cet exemple, le module <code class="module"><a href="../mod/mod_reqtimeout.html">mod_reqtimeout</a></code> est
-    complètement désactivé.</p>
+    <p>This disables <code class="module"><a href="../mod/mod_reqtimeout.html">mod_reqtimeout</a></code> completely.</p>
     </li>
 
-    <li><strong>La valeur du délai qui est augmentée lorsque des données
-    sont reçues</strong> :<br />
+    <li><strong>Timeout value that is increased when data is
+    received</strong>:<br />
     <div class="example"><p><code>
-    <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>
+    <var>type</var>=<var>timeout</var>,MinRate=<var>data_rate</var>
     </code></p></div>
 
-    <p>Identique à ce qui précède, mais chaque fois que des données sont
-    reçues, la valeur du délai est augmentée en fonction du taux-mini
-    spécifié (en octets par seconde).</p>
+    <p>Same as above, but whenever data is received, the timeout value is
+    increased according to the specified minimum data rate (in bytes per
+    second).</p>
     </li>
 
-    <li><strong>La valeur du délai augmente lorsque des données sont
-    reçues, jusqu'à une limite supérieure</strong>:<br />
+    <li><strong>Timeout value that is increased when data is received, with an
+    upper bound</strong>:<br />
     <div class="example"><p><code>
-    <var>type</var>=<var>délai</var>-<var>délai-maxi</var>,MinRate=<var>taux-mini</var>
+    <var>type</var>=<var>timeout</var>-<var>maxtimeout</var>,MinRate=<var>data_rate</var>
     </code></p></div>
 
-    <p>Identique à ce qui précède, mais le délai n'augmentera pas au
-    delà de la borne supérieure du délai spécifiée.</p>
+    <p>Same as above, but the timeout will not be increased above the second
+    value of the specified timeout range.</p>
     </li>
 
     </ul>
 
-      
-    
-    
 
 </div>
 </div>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_request.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_request.html.fr?rev=1805630&r1=1805629&r2=1805630&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_request.html.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_request.html.fr Mon Aug 21 13:43:45 2017
@@ -48,62 +48,57 @@ les corps de requêtes HTTP</td></tr>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="directive-section"><h2><a name="keptbodysize" id="keptbodysize">Directive</a> <a name="KeptBodySize" id="KeptBodySize">KeptBodySize</a></h2>
 <table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Conserve le corps de la requête à concurrence de la taille
-maximale spécifiée, pour une utilisation éventuelle par des filtres
-comme mod_include.</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeptBodySize <var>taille maximale en octets</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Keep the request body instead of discarding it up to
+the specified maximum size, for potential use by filters such as
+mod_include.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>KeptBodySize <var>maximum size in bytes</var></code></td></tr>
 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>KeptBodySize 0</code></td></tr>
 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_request</td></tr>
 </table>
-    <p>Dans une situation normale, les gestionnaires de requête tels que
-    le gestionnaire par défaut des fichiers statiques suppriment le
-    corps de la requête s'il n'est pas nécessaire au gestionnaire de
-    requête. Il en résulte que les filtres comme mod_include sont
-    limités à des requêtes <code>GET</code> lors de l'inclusion d'autres
-    URLs en tant que sous-requêtes, et ceci même si la requête originale
-    était une requête <code>POST</code>, car le corps de la requête a
-    été supprimé et n'est donc plus disponible une fois le traitement du
-    filtre mis en oeuvre.</p>
-
-    <p>Lorsque l'argument de cette directive a une valeur supérieure à
-    zéro, les gestionnaires de requête qui suppriment habituellement les
-    corps de requête vont alors conserver ces corps de requête, à
-    concurrence de la taille maximale spécifiée, pour être
-    éventuellement utilisés par des filtres. Dans le cas du filtre
-    mod_include, une tentative de requête <code>POST</code> pour un
-    fichier shtml statique se traduira par des sous-requêtes
-    <code>POST</code>, et non par des sous-requêtes <code>GET</code>
-    comme avant.</p>
-
-    <p>Cette fonctionnalité permet de découper des pages web complexes
-    et des applications web en petits éléments individuels, et de
-    combiner ces éléments avec la structure de la page web sous-jacente
-    en utilisant <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. Les éléments peuvent se
-    présenter sous la forme de programmes CGI, de langages de scripts,
-    ou d'URLs issues d'un mandataire inverse dans l'espace d'URL d'un
-    autre serveur en utilisant <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
-
-    <p><strong>Note :</strong> Chaque requête dont le corps est ainsi
-    conservé doit être enregistrée temporairement en mémoire vive
-    jusqu'à la fin du traitement de la requête. Il faut donc s'assurer
-    que la mémoire RAM du serveur est suffisante pour pouvoir supporter
-    la charge induite. L'utilisation de cette directive doit être
-    limitée à certaines portions de votre espace d'URL bien précises qui
-    le nécessitent, et en spécifiant comme taille maximale une valeur la
-    plus petite possible, mais tout de même suffisante pour un corps de
-    requête.</p>
+    <p>Under normal circumstances, request handlers such as the
+    default handler for static files will discard the request body
+    when it is not needed by the request handler. As a result,
+    filters such as mod_include are limited to making <code>GET</code> requests
+    only when including other URLs as subrequests, even if the
+    original request was a <code>POST</code> request, as the discarded
+    request body is no longer available once filter processing is
+    taking place.</p>
+
+    <p>When this directive has a value greater than zero, request
+    handlers that would otherwise discard request bodies will
+    instead set the request body aside for use by filters up to
+    the maximum size specified. In the case of the mod_include
+    filter, an attempt to <code>POST</code> a request to the static
+    shtml file will cause any subrequests to be <code>POST</code>
+    requests, instead of <code>GET</code> requests as before.</p>
+
+    <p>This feature makes it possible to break up complex web pages and
+    web applications into small individual components, and combine
+    the components and the surrounding web page structure together
+    using <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>. The components can take the
+    form of CGI programs, scripted languages, or URLs reverse proxied
+    into the URL space from another server using
+    <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p>
+
+    <p><strong>Note:</strong> Each request set aside has to be set
+    aside in temporary RAM until the request is complete. As a result,
+    care should be taken to ensure sufficient RAM is available on the
+    server to support the intended load. Use of this directive
+    should be limited to where needed on targeted parts of your
+    URL space, and with the lowest possible value that is still big
+    enough to hold a request body.</p>
 
-    <p>Si la taille de la requête envoyée par le client dépasse la taille
-    maximale autorisée par cette directive, le serveur renverra l'erreur
+    <p>If the request size sent by the client exceeds the maximum
+    size allocated by this directive, the server will return
     <code>413 Request Entity Too Large</code>.</p>
 
 
 <h3>Voir aussi</h3>
 <ul>
-<li>la documentation de <a href="mod_include.html">mod_include</a></li>
-<li>la documentation de <a href="mod_auth_form.html">mod_auth_form</a></li>
+<li><a href="mod_include.html">mod_include</a> documentation</li>
+<li><a href="mod_auth_form.html">mod_auth_form</a> documentation</li>
 </ul>
 </div>
 </div>



Mime
View raw message