From: Lucien Gentis Date: Sat, 1 Apr 2017 16:17:38 +0000 (+0000) Subject: XML updates. X-Git-Tag: 2.5.0-alpha~506 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6d112f200317d6f72b106b77fe196be11a4e7591;p=thirdparty%2Fapache%2Fhttpd.git XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1789811 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_cache_socache.xml.fr b/docs/manual/mod/mod_cache_socache.xml.fr index defe11b7c9a..cafb20c539a 100644 --- a/docs/manual/mod/mod_cache_socache.xml.fr +++ b/docs/manual/mod/mod_cache_socache.xml.fr @@ -1,7 +1,7 @@ - + - + @@ -25,26 +25,26 @@ mod_cache_socache -Module de stockage à base de cache d'objets partagés +Module de stockage à base de cache d'objets partagés (socache) pour le filtre de mise en cache HTTP. Extension mod_cache_socache.c cache_socache_module -

Le module mod_cache_socache implémente un - gestionnaire de stockage à base de cache d'objets partagés (socache) +

Le module mod_cache_socache implémente un + gestionnaire de stockage à base de cache d'objets partagés (socache) pour le module mod_cache.

-

Les en-têtes et corps des réponses mises en cache sont rassemblés - et stockés sous une même clé dans le cache d'objets partagés. Il est +

Les en-têtes et corps des réponses mises en cache sont rassemblés + et stockés sous une même clé dans le cache d'objets partagés. Il est possible de choisir entre plusieurs implémentations de caches d'objets - partagés.

+ href="../socache.html">implémentations de caches d'objets + partagés.

-

Des réponses avec différents contenus négociés peuvent être - stockées simultanément ; cependant, la mise en cache de contenus - partiels n'est pas encore supportée par ce module.

+

Des réponses avec différents contenus négociés peuvent être + stockées simultanément ; cependant, la mise en cache de contenus + partiels n'est pas encore supportée par ce module.

# Activation de la mise en cache @@ -54,7 +54,7 @@ CacheSocacheMaxSize 102400 CacheEnable socache </Location> -# Possibilité de se rabattre sur le cache disque +# Possibilité de se rabattre sur le cache disque CacheSocache shmcb CacheSocacheMaxSize 102400 <Location "/foo"> @@ -66,7 +66,7 @@ CacheSocacheMaxSize 102400 Note :

Le module mod_cache_socache requiert les services du module mod_cache qui doit donc avoir - été préalablement chargé.

+ été préalablement chargé.

 mod_cache @@ -75,20 +75,20 @@ CacheSocacheMaxSize 102400 CacheSocache -Implémentation du cache d'objets partagés à utiliser +Implémentation du cache d'objets partagés à utiliser CacheSocache type[:args] server configvirtual host -Disponible à partir de la version 2.4.5 du serveur HTTP +Disponible à partir de la version 2.4.5 du serveur HTTP Apache

La directive CacheSocache - définit l'implémentation du cache d'objets partagés à utiliser, + définit l'implémentation du cache d'objets partagés à utiliser, suivie d'arguments optionnels. Il est possible de choisir entre plusieurs implémentations de caches d'objets - partagés.

+ href="../socache.html">implémentations de caches d'objets + partagés.

CacheSocache shmcb @@ -98,8 +98,8 @@ Apache CacheSocacheMaxTime -La durée maximale de stockage d'un document dans le cache -avant péremption +La durée maximale de stockage d'un document dans le cache +avant péremption CacheSocacheMaxTime secondes CacheSocacheMaxTime 86400 server config @@ -107,14 +107,14 @@ avant péremption directory .htaccess -Disponible à partir de la version 2.4.5 du serveur HTTP +Disponible à partir de la version 2.4.5 du serveur HTTP Apache

La directive CacheSocacheMaxTime - définit la durée de stockage maximale en secondes d'un document dans - le cache avant péremption. Cette définition l'emporte sur la durée - de fraîcheur définie pour le document par le protocole HTTP.

+ définit la durée de stockage maximale en secondes d'un document dans + le cache avant péremption. Cette définition l'emporte sur la durée + de fraîcheur définie pour le document par le protocole HTTP.

CacheSocacheMaxTime 86400 @@ -124,7 +124,7 @@ Apache CacheSocacheMinTime -La durée minimale de stockage d'un document dans le cache +La durée minimale de stockage d'un document dans le cache CacheSocacheMinTime seconds CacheSocacheMinTime 600 server config @@ -132,16 +132,16 @@ Apache directory .htaccess -Disponible à partir de la version 2.4.5 du serveur HTTP +Disponible à partir de la version 2.4.5 du serveur HTTP Apache

La directive CacheSocacheMinTime - définit le nombre de secondes au delà de la durée de fraîcheur de la - réponse pendant lesquelles cette dernière devra être stockée dans le - cache d'objets partagés. En effet, si une réponse n'est stockée que - pour une durée égale à sa durée de fraîcheur, elle n'a pas besoin - d'être rafraîchie.

+ définit le nombre de secondes au delà de la durée de fraîcheur de la + réponse pendant lesquelles cette dernière devra être stockée dans le + cache d'objets partagés. En effet, si une réponse n'est stockée que + pour une durée égale à sa durée de fraîcheur, elle n'a pas besoin + d'être rafraîchie.

CacheSocacheMinTime 600 @@ -151,7 +151,7 @@ Apache CacheSocacheMaxSize -La taille maximale d'une entrée pouvant être placée dans le +La taille maximale d'une entrée pouvant être placée dans le cache CacheSocacheMaxSize octets CacheSocacheMaxSize 102400 @@ -160,22 +160,22 @@ cache directory .htaccess -Disponible à partir de la version 2.4.5 du serveur HTTP +Disponible à partir de la version 2.4.5 du serveur HTTP Apache

La directive CacheSocacheMaxSize - définit la taille maximale, en octets, de la somme des en-têtes et - du corps d'un document pouvant être stocké dans le cache. Bien - entendu, plus la taille des en-têtes sera grande, plus la taille - maximale du corps du document s'en trouvera réduite.

+ définit la taille maximale, en octets, de la somme des en-têtes et + du corps d'un document pouvant être stocké dans le cache. Bien + entendu, plus la taille des en-têtes sera grande, plus la taille + maximale du corps du document s'en trouvera réduite.

Le module mod_cache_socache ne tentera de mettre - en cache que des réponses qui possèdent une taille de contenu + en cache que des réponses qui possèdent une taille de contenu explicite, ou dont la taille est suffisamment petite pour qu'elles - soient écrites en une seule passe. Ceci permet au module - mod_cache_disk de mettre en cache des réponses dont - la taille est trop importante pour pouvoir être mises en cache par + soient écrites en une seule passe. Ceci permet au module + mod_cache_disk de mettre en cache des réponses dont + la taille est trop importante pour pouvoir être mises en cache par mod_cache_socache.

@@ -186,7 +186,7 @@ Apache CacheSocacheReadSize -La quantité minimale de données du document à lire et +La quantité minimale de données du document à lire et mettre en cache avant envoi au client CacheSocacheReadSize octets CacheSocacheReadSize 0 @@ -195,33 +195,33 @@ mettre en cache avant envoi au client directory .htaccess -Disponible à partir de la version 2.4.5 du serveur HTTP +Disponible à partir de la version 2.4.5 du serveur HTTP Apache

La directive CacheSocacheReadSize - définit la quantité minimale de données, en octets, à lire depuis - l'arrière-plan avant envoi au client. Avec la valeur par défaut 0, - les données sont transmises au client dès leur arrivée et quelle que - soit leur taille. Si la valeur définie est non nulle, le cache - disque va mettre en tampon au moins la quantité de données - correspondante avant envoi au client. Ceci peut améliorer les + définit la quantité minimale de données, en octets, à lire depuis + l'arrière-plan avant envoi au client. Avec la valeur par défaut 0, + les données sont transmises au client dès leur arrivée et quelle que + soit leur taille. Si la valeur définie est non nulle, le cache + disque va mettre en tampon au moins la quantité de données + correspondante avant envoi au client. Ceci peut améliorer les performances en cas de mise en cache de contenu en provenance d'un mandataire inverse lent.

-

Cette directive n'a d'effet qu'au moment où les données sont - stockées dans le cache, et non lorsqu'elles sont servies depuis le +

Cette directive n'a d'effet qu'au moment où les données sont + stockées dans le cache, et non lorsqu'elles sont servies depuis le cache.

- CacheReadSize 102400 + CacheSocacheReadSize 102400 CacheSocacheReadTime -La durée minimale de lecture avant l'envoi des données +La durée minimale de lecture avant l'envoi des données CacheSocacheReadTime millisecondes CacheSocacheReadTime 0 server config @@ -229,27 +229,27 @@ Apache directory .htaccess -Disponible à partir de la version 2.4.5 du serveur HTTP +Disponible à partir de la version 2.4.5 du serveur HTTP Apache

La directive CacheSocacheReadTime - définit le temps minimal qui doit s'écouler avant de tenter - l'envoi des données au client. Cette durée sera mise à profit pour - lire et mettre en tampon les données avant leur envoi au client. - Ceci peut améliorer les performances en cas de mise en cache de + définit le temps minimal qui doit s'écouler avant de tenter + l'envoi des données au client. Cette durée sera mise à profit pour + lire et mettre en tampon les données avant leur envoi au client. + Ceci peut améliorer les performances en cas de mise en cache de contenu en provenance d'un mandataire inverse.

-

La valeur par défaut 0 désactive cette directive.

+

La valeur par défaut 0 désactive cette directive.

-

Cette directive n'a d'effet qu'au moment où les données sont - stockées dans le cache, et non lorsqu'elles sont servies depuis le - cache. Il est recommandé d'utiliser cette directive en concomitance +

Cette directive n'a d'effet qu'au moment où les données sont + stockées dans le cache, et non lorsqu'elles sont servies depuis le + cache. Il est recommandé d'utiliser cette directive en concomitance avec la directive CacheSocacheReadSize afin de - s'assurer que le serveur ne mette pas les données en tampon de - manière excessive dans le cas où les données arriveraient plus vite - que prévu.

+ s'assurer que le serveur ne mette pas les données en tampon de + manière excessive dans le cas où les données arriveraient plus vite + que prévu.

CacheSocacheReadTime 1000 diff --git a/docs/manual/mod/mod_remoteip.xml b/docs/manual/mod/mod_remoteip.xml index fba09fa608a..23cc6d01e37 100644 --- a/docs/manual/mod/mod_remoteip.xml +++ b/docs/manual/mod/mod_remoteip.xml @@ -235,7 +235,8 @@ RemoteIPProxiesHeader X-Forwarded-By If enabled with the On flag, the upstream client must 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 RemoteIPProxyProtocolDisableHosts directive. + module="mod_remoteip">RemoteIPProxyProtocolDisableHosts + directive.

While this directive may be specified in any virtual host, it is important to understand that because the PROXY protocol is connection diff --git a/docs/manual/mod/mod_remoteip.xml.fr b/docs/manual/mod/mod_remoteip.xml.fr index c27d8f4d95d..9823c8c70ee 100644 --- a/docs/manual/mod/mod_remoteip.xml.fr +++ b/docs/manual/mod/mod_remoteip.xml.fr @@ -1,7 +1,7 @@ - + @@ -255,7 +255,7 @@ RemoteIPProxiesHeader X-Forwarded-By RemoteIPProxyProtocol Active ou désactive la gestion du protocole PROXY -RemoteIPProxyProtocol On|Optional|Off +RemoteIPProxyProtocol On|Off server configvirtual host Disponible à partir de la version 2.4.26 du serveur HTTP Apache @@ -265,9 +265,10 @@ RemoteIPProxiesHeader X-Forwarded-By 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 à On, la demande du client doit envoyer l'en-tête approprié pour chaque - nouvelle connexion, sinon cette dernière sera fermée. Si elle est définie à - Optional, la demande du client peut envoyer l'en-tête - approprié, mais ce n'est pas obligatoire.

+ nouvelle connexion, sinon cette dernière sera fermée à moins qu'il ne fasse + partie de la liste, définie via la directive RemoteIPProxyProtocolDisableHosts, des + hôtes pour lesquels le protocole PROXY est désactivé.

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 @@ -282,46 +283,53 @@ RemoteIPProxiesHeader X-Forwarded-By 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.

- Lorsque plusieurs serveurs virtuels avec le même couple - adresse IP/port sont configurés avec une combinaison de drapeaux - On et Optional, les connexions ne seront pas - fermées si l'en-tête approprié n'est pas envoyé. L'activation interviendra - alors après la lecture de la requête si bien que les serveurs virtuels - configurés avec le drapeau On renverront une erreur 400 Bad - Request. Les serveurs virtuels configurés avec le drapeau - Optional quant à eux continueront de fonctionner de manière - habituelle mais sans remplacer les informations IP du client. - Listen 80 -<VirtualHost *:80> - ServerName www.example.com - RemoteIPProxyProtocol Optional - - #Les requêtes pour ce serveur virtuel ne doivent pas obligatoirement - #contenir d'en-tête du protocole PROXY -</VirtualHost> - <VirtualHost *:80> 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, une erreur 400 sera renvoyée + #protocole PROXY. Si ce n'est pas le cas, la connexion sera fermée. </VirtualHost> Listen 8080 <VirtualHost *:8080> ServerName www.example.com RemoteIPProxyProtocol On + RemoteIPProxyProtocolDisableHosts 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 + #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 </VirtualHost> + +RemoteIPProxyProtocolDisableHosts +Désactive la prise en compte de l'en-tête PROXY pour certains hôtes +ou réseaux +RemoteIPProxyProtocolDisableHosts host|range [host|range] [host|range] +server configvirtual host + +RemoteIPProxyProtocolDisableHosts est disponible à partir de la +version 2.4.26 du serveur HTTP Apache + + +

La directive RemoteIPProxyProtocol 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. Elle est en général utilisée dans le cadre du monitoring du + trafic vers un serveur virtuel à destination du serveur situé derrière le + répartiteur de charge.

+ + + RemoteIPTrustedProxy Restreint les adresses IP clients dignes de