Module Apache mod_proxy

AllowCONNECT Directive

La directive AllowCONNECT permet de sp�cifier une liste de num�ros de ports auxquels la m�thode de mandataire CONNECT pourra se connecter. Les navigateurs d'aujourd'hui utilisent cette m�thode dans le cas o� une connexion https est requise et o� le tunneling mandataire sur HTTP est en service.

Par d�faut, seuls les ports par d�fauts https (443) et snews (563) sont pris en compte. Vous pouvez utiliser la directive AllowCONNECT pour outrepasser ces valeurs par d�faut et n'autoriser les connexions que vers les ports sp�cifi�s.

Notez que le module mod_proxy_connect doit �tre charg� dans le serveur pour pouvoir acc�der au support de CONNECT.

BalancerMember Directive

Cette directive parmet d'ajouter un membre � un groupe de r�partition de charge. Elle peut se trouver dans un conteneur <Proxy balancer://...>, et accepte tous les param�tres de paires cl�/valeur que supporte la directive ProxyPass.

L'argument balancerurl n'est requis que s'il ne se trouve pas d�j� dans la directive de conteneur <Proxy balancer://...>. Il correspond � l'URL d'un r�partiteur de charge d�fini par une directive ProxyPass.

NoProxy Directive

Cette directive n'a d'utilit� que pour les serveurs mandataires Apache au sein d'Intranets. La directive NoProxy permet de sp�cifier une liste de sous-r�seaux, d'adresses IP, de serveurs et/ou de domaines s�par�s par des espaces. Une requ�te pour un serveur qui correspond � un ou plusieurs crit�res sera toujours servie par ce serveur directement, sans �tre redirig�e vers le(s) serveur(s) mandataire(s) d�fini(s) par la directive ProxyRemote.

Le type des arguments serveur de la directive NoProxy appartiennent � la liste suivante :

Domaine

Un domaine est ici un nom de domaine DNS partiellement qualifi� pr�c�d� d'un point. Il repr�sente une liste de serveurs qui appartiennent logiquement au m�me domaine ou � la m�me zonz DNS (en d'autres termes, les nom des serveurs se terminent tous par domaine).

Exemple

.com .apache.org.

Pour faire la distinction entre domaines et nom d'h�tes (des points de vue � la fois syntaxique et s�mantique, un domaine DNS pouvant aussi avoir un enregistrement DNS de type A !), les domaines sont toujours sp�cifi�s en les pr�fixant par un point.

Note

Les comparaisons de noms de domaines s'effectuent sans tenir compte de la casse, et les parties droites des Domaines sont toujours cens�es correspondre � la racine de l'arborescence DNS, si bien que les domaines .ExEmple.com et .example.com. (notez le point � la fin du nom) sont consid�r�s comme identiques. Comme une comparaison de domaines ne n�cessite pas de recherche DNS, elle est beaucoup plus efficace qu'une comparaison de sous-r�seaux.

Sous-r�seau

Un Sous-r�seau est une adresse internet partiellement qualifi�e sous forme num�rique (quatre nombres s�par�s par des points), optionnellement suivie d'un slash et du masque de sous-r�seau sp�cifiant le nombre de bits significatifs dans le Sous-r�seau. Il repr�sente un sous-r�seau de serveurs qui peuvent �tre atteints depuis la m�me interface r�seau. En l'absence de masque de sous-r�seau explicite, il est sous-entendu que les digits manquants (ou caract�res 0) de fin sp�cifient le masque de sous-r�seau (Dans ce cas, le masque de sous-r�seau ne peut �tre qu'un multiple de 8). Voici quelques exemples :

192.168 ou 192.168.0.0

le sous-r�seau 192.168.0.0 avec un masque de sous-r�seau implicite de 16 bits significatifs (parfois exprim� sous la forme 255.255.0.0)

192.168.112.0/21

le sous-r�seau 192.168.112.0/21 avec un masque de sous-r�seau implicite de 21 bits significatifs (parfois exprim� sous la forme255.255.248.0)

Comme cas extr�mes, un Sous-r�seau avec un masque de sous-r�seau de 32 bits significatifs est �quivalent � une adresse IP, alors qu'un Sous-r�seau avec un masque de sous-r�seau de 0 bit significatif (c'est � dire 0.0.0.0/0) est identique � la constante _Default_, et peut correspondre � toute adresse IP.

Adresse IP

Une Adresse IP est une adresse internet pleinement qualifi�e sous forme num�rique (quatre nombres s�par�s par des points). En g�n�ral, cette adresse repr�sente un serveur, mais elle ne doit pas n�cessairement correspondre � un nom de domaine DNS.

Exemple

192.168.123.7

Note

Une Adresse IP ne n�cessite pas de r�solution DNS, et peut ainsi s'av�rer plus efficace quant aux performances d'Apache.

Nom de serveur

Un Nom de serveur est un nom de domaine DNS pleinement qualifi� qui peut �tre r�solu en une ou plusieurs adresses IP par le service de noms de domaines DNS. Il repr�sente un h�te logique (par opposition aux Domaines, voir ci-dessus), et doit pouvoir �tre r�solu en une ou plusieurs adresses IP (ou souvent en une liste d'h�tes avec diff�rentes adresses IP).

Exemples

prep.ai.example.com
www.apache.org

Note

Dans de nombreuses situations, il est plus efficace de sp�cifier une adresse IP qu'un Nom de serveur car cela �vite d'avoir � effectuer une recherche DNS. La r�solution de nom dans Apache peut prendre un temps tr�s long lorsque la connexion avec le serveur de noms utilise une liaison PPP lente.

Les comparaisons de Nom de serveur s'effectuent sans tenir compte de la casse, et les parties droites des Noms de serveur sont toujours cens�es correspondre � la racine de l'arborescence DNS, si bien que les domaines WWW.ExEmple.com et www.example.com. (notez le point � la fin du nom) sont consid�r�s comme identiques.

Voir aussi

• Probl�mes li�s au DNS

<Proxy> Directive

Les directives situ�es dans une section <Proxy> ne s'appliquent qu'au contenu mandat� concern�. Les jokers de style shell sont autoris�s.

Par exemple, les lignes suivantes n'autoriseront � acc�der � un contenu via votre serveur mandataire que les h�tes appartenant � votre-reseau.example.com :

Dans l'exemple suivant, tous les fichiers du r�pertoire foo de example.com seront trait�s par le filtre INCLUDES lorsqu'ils seront envoy�s par l'interm�diaire du serveur mandataire :

Voir aussi

• <ProxyMatch>

ProxyBadHeader Directive

La directive ProxyBadHeader permet de d�terminer le comportement de mod_proxy lorsqu'il re�oit des lignes d'en-t�te de r�ponse dont la syntaxe n'est pas valide (c'est � dire ne contenant pas de caract�re ':') en provenance du serveur original. Les arguments disponibles sont :

IsError

Annule la requ�te et renvoie une r�ponse de code 502 (mauvaise passerelle). C'est le comportement par d�faut.

Ignore

Traite les lignes d'en-t�te incorrectes comme si elles n'avaient pas �t� envoy�es.

StartBody

A la r�ception de la premi�re ligne d'en-t�te incorrecte, les autres en-t�tes sont lus et ce qui reste est trait� en tant que corps. Ceci facilite la prise en compte des serveurs d'arri�re-plan bogu�s qui oublient d'ins�rer une ligne vide entre les en-t�tes et le corps.

ProxyBlock Directive

La directive ProxyBlock permet de sp�cifier une liste de termes, serveurs et/ou domaines, s�par�s par des espaces. Les requ�tes de documents HTTP, HTTPS, FTP vers des sites dont les noms contiennent des termes, noms de serveur ou domaine correspondants seront bloqu�s par le serveur mandataire. La module proxy va aussi tenter de d�terminer les adresses IP des items de la liste qui peuvent correspondre � des noms d'h�tes au cours du d�marrage, et les mettra en cache � des fins de comparaisons ult�rieures. Ceci peut ralentir le d�marrage du serveur.

rocky.wotsamattau.edu aurait aussi correspondu s'il avait �t� sp�cifi� par son adresse IP.

Notez que wotsamattau aurait suffi pour correspondre � wotsamattau.edu.

Notez aussi que

bloque les connexions vers tous les sites.

ProxyDomain Directive

Cette directive n'a d'utilit� que pour les serveurs mandataires Apache au sein d'un Intranet. La directive ProxyDomain permet de sp�cifier le domaine par d�faut auquel le serveur mandataire apache appartient. Si le serveur re�oit une requ�te pour un h�te sans nom de domaine, il va g�n�rer une r�ponse de redirection vers le m�me h�te suffix� par le Domaine sp�cifi�.

ProxyErrorOverride Directive

Cette directive est utile pour les configurations de mandataires inverses, lorsque vous souhaitez que les pages d'erreur envoy�es aux utilisateurs finaux pr�sentent un aspect homog�ne. Elle permet aussi l'inclusion de fichiers (via les SSI de mod_include) pour obtenir le code d'erreur et agir en cons�quence (le comportement par d�faut afficherait la page d'erreur du serveur mandat�, alors que c'est le message d'erreur SSI qui sera affich� si cette directive est � "on").

Cette directive n'affecte pas le traitement des r�ponses informatives (1xx), de type succ�s normal (2xx), ou de redirection (3xx).

ProxyFtpDirCharset Directive

La directive ProxyFtpDirCharset permet de d�finir le jeu de caract�res � utiliser pour les listings FTP en HTML g�n�r�s par mod_proxy_ftp.

ProxyIOBufferSize Directive

La directive ProxyIOBufferSize permet d'ajuster la taille du tampon interne utilis� comme bloc-note pour les transferts de donn�es entre entr�e et sortie. La taille doit �tre au minimum �gale � 8192 octets.

Lorsqu'on utilise mod_proxy_ajp, la valeur minimale est align�e sur la limite de 1024 octets, et les valeurs sup�rieures � 65536 octets sont ramen�es � 65536 octets, comme pr�conis� par le protocole AJP.

Dans la plupart des cas, il n'y a aucune raison de modifier cette valeur.

<ProxyMatch> Directive

La directive <ProxyMatch> est identique � la directive <Proxy>, � l'exception qu'elle d�finit les URLs auxquelles elle s'applique en utilisant une expression rationnelle.

Voir aussi

• <Proxy>

ProxyMaxForwards Directive

La directive ProxyMaxForwards permet de sp�cifier le nombre maximum de mandataires � travers lesquels une requ�te peut passer dans le cas o� la la requ�te ne contient pas d'en-t�te Max-Forwards. Ceci permet de se pr�munir contre les boucles infinies de mandataires ou contre les attaques de type d�ni de service.

Notez que la d�finition de la directive ProxyMaxForwards constitue une violation du protocole HTTP/1.1 (RFC2616), qui interdit � un mandataire de d�finir Max-Forwards si le client ne l'a pas fait lui-m�me. Les versions pr�c�dentes d'Apache la d�finissaient syst�matiquement. Une valeur n�gative de ProxyMaxForwards, y compris la valeur par d�faut -1, implique un comportement compatible avec le protocole, mais vous expose aux bouclages infinis.

ProxyPass Directive

Cette directive permet r�f�rencer des serveurs distants depuis l'espace d'URLs du serveur local ; le serveur local n'agit pas en tant que mandataire au sens conventionnel, mais plut�t comme miroir du serveur distant. Le serveur local est souvent nomm� mandataire inverse ou passerelle. L'argument chemin est le nom d'un chemin virtuel local ; url est une URL partielle pour le serveur distant et ne doit pas contenir de cha�ne d'arguments.

Supposons que le serveur local a pour adresse http://example.com/ ; alors la ligne

va convertir en interne toute requ�te pour http://example.com/miroir/foo/bar en une requ�te mandat�e pour http://backend.example.com/bar.

Le drapeau ! permet de soustraire un sous-r�pertoire du mandat inverse, comme dans l'exemple suivant :

va mandater toutes les requ�tes pour /miroir/foo vers backend.example.com, sauf les requ�tes pour /miroir/foo/i.

Depuis la version 2.1 du serveur HTTP Apache, mod_proxy supporte les jeux de connexions vers un serveur d'arri�re-plan. Ainsi, les connexions cr��es � la demande peuvent �tre conserv�es dans un jeu pour une utilisation ult�rieure. Les limites de la taille du jeu de connexions et d'autres param�tres peuvent �tre d�finis au niveau de la directive ProxyPass via des arguments cl�=valeur d�crits dans la table ci-dessous.

Par d�faut, mod_proxy permettra de conserver le nombre maximum de connexions pouvant �tre utilis�es simultan�ment par le processus enfant concern� du serveur web. Vous pouvez utiliser le param�tre max pour r�duire ce nombre par rapport � la valeur par d�faut. Vous pouvez aussi utiliser le param�tre ttl pour d�finir une dur�e de vie optionnelle ; ainsi, les connections qui n'ont pas �t� utilis�es au bout de ttl secondes seront ferm�es. Le param�tre ttl permet aussi d'emp�cher l'utilisation d'une connexion susceptible d'�tre ferm�e suite � l'expiration de la dur�e de vie des connexions persistantes sur le serveur d'arri�re-plan.

Le jeu de connexions est maintenu au niveau de chaque processus enfant du serveur web, et max et les autres param�tres ne font l'objet d'aucune coordination entre les diff�rents processus enfants, sauf bien sur dans le cas o� un seul processus enfant est permis par la configuration du module multiprocessus.

Si l'URL de la directive ProxyPass d�bute par balancer:// (par exemple: balancer://cluster/, toute information relative au chemin est ignor�e), alors un serveur cible virtuel ne communiquant pas r�ellement avec le serveur d'arri�re-plan sera cr��. Celui-ci sera en fait responsable de la gestion de plusieurs serveurs cibles "r�els". Dans ce cas, un jeu de param�tres particuliers s'applique � ce serveur cible virtuel. Voir mod_proxy_balancer pour plus d'informations � propos du fonctionnement du r�partiteur de charge.

Exemple de configuration d'un r�partiteur

Configuration d'un serveur cible de r�serve qui ne sera utilis� que si aucun autre serveur cible n'est disponible

Normalement, mod_proxy va mettre sous leur forme canonique les URLs trait�es par ProxyPass. Mais ceci peut �tre incompatible avec certains serveurs d'arri�re-plan, et en particulier avec ceux qui utilisent PATH_INFO. Le mot-cl� optionnel nocanon modifie ce comportement et permet de transmettre le chemin d'URL sous sa forme brute au serveur d'arri�re-plan. Notez que ceci peut affecter la s�curit� de votre serveur d'arri�re-plan, car la protection limit�e contre les attaques � base d'URL que fournit le mandataire est alors supprim�e.

Lorsque la directive ProxyPass est utilis�e � l'int�rieur d'une section <Location>, le premier argument est omis et le r�pertoire local est obtenu � partir de la section <Location>. Il en est de m�me � l'int�rieur d'une section <LocationMatch> ; cependant, ProxyPass n'interpr�te pas les expressions rationnelles, et dans ce cas, il est n�cessaire d'utiliser la directive ProxyPassMatch.

Cette directive ne peut pas �tre plac�e dans une section <Directory> ou <Files>.

Si vous avez besoin d'un configuration de mandataire inverse plus souple, reportez-vous � la documentaion de la directive RewriteRule et son drapeau [P].

Le mot-cl� optionnel interpolate (disponible depuis httpd 2.2.9), en combinaison avec la directive ProxyPassInterpolateEnv, permet � ProxyPass d'interpoler les variables d'environnement � l'aide de la syntaxe ${VARNAME}. Notez que de nombreuses variables d'environnement standard d�riv�es de CGI n'existeront pas lorsque l'interpolation se produit ; vous devrez alors encore avoir avoir recours � mod_rewrite pour des r�gles complexes. Notez aussi que l'interpolation n'est pas support�e dans la partie protocole d'une URL. La d�termination dynamique du protocole peut �tre effectu�e � l'aide de mod_rewrite comme dans l'exemple suivant :

RewriteEngine On

RewriteCond %{HTTPS} =off
RewriteRule . - [E=protocol:http]
RewriteCond %{HTTPS} =on
RewriteRule . - [E=protocol:https]

RewriteRule ^/mirror/foo/(.*) %{ENV:protocol}://backend.example.com/$1 [P]
ProxyPassReverse  /mirror/foo/ http://backend.example.com/
ProxyPassReverse  /mirror/foo/ https://backend.example.com/

ProxyPassInterpolateEnv Directive

Cette directive, ainsi que l'argument interpolate des directives ProxyPass, ProxyPassReverse, ProxyPassReverseCookieDomain et ProxyPassReverseCookiePath, permet de configurer dynamiquement un mandataire inverse � l'aide de variables d'environnement, ces derni�res pouvant �tre d�finies par un autre module comme mod_rewrite. Elle affecte les directives ProxyPass, ProxyPassReverse, ProxyPassReverseCookieDomain, et ProxyPassReverseCookiePath, en leur indiquant de remplacer la cha�ne ${nom_var} dans les directives de configuration par la valeur de la variable d'environnement nom_var (si l'option interpolate est sp�cifi�e).

Conservez cette directive � off (pour les performances du serveur), sauf si vous en avez r�ellement besoin.

ProxyPassMatch Directive

Cette directive est identique � la directive ProxyPass, mais fait usage des expressions rationnelles, au lieu d'une simple comparaison de pr�fixes. L'expression rationnelle sp�cifi�e est compar�e � l'url, et si elle correspond, le serveur va substituer toute correspondance entre parenth�ses dans la cha�ne donn�e et l'utiliser comme nouvelle url.

Supposons que le serveur local a pour adresse http://example.com/ ; alors

va provoquer la conversion interne de la requ�te locale http://example.com/foo/bar.gif en une requ�te mandat�e pour http://backend.example.com/foo/bar.gif.

Le drapeau ! vous permet de ne pas mandater un sous-r�pertoire donn�.

Lorsque cette directive se situe � l'int�rieur d'une section <LocationMatch>, le premier argument est omis et l'expression rationnelle est obtenue � partir de la directive <LocationMatch>.

Si vous avez besoin d'une configuration de mandataire inverse plus flexible, reportez-vous � la directive RewriteRule avec le drapeau [P].

ProxyPassReverse Directive

Cette directive permet de faire en sorte qu'Apache ajuste l'URL dans les en-t�tes Location, Content-Location et URI des r�ponses de redirection HTTP. Ceci est essentiel lorsqu'Apache est utilis� en tant que mandataire inverse (ou passerelle), afin d'�viter de court-circuiter le mandataire inverse suite aux redirections HTTP sur le serveur d'arri�re-plan qui restent derri�re le mandataire inverse.

Seuls les en-t�tes de r�ponse HTTP sp�cialement mentionn�s ci-dessus seront r��crits. Apache ne r��crira ni les autres en-t�tes de r�ponse, ni les r�f�rences d'URLs dans les pages HTML. Cela signifie que dans le cas o� un contenu mandat� contient des r�f�rences � des URLs absolues, elles court-circuiteront le mandataire. Le module mod_proxy_html de Nick Kew est un module tiers qui parcourt le code HTML et r��crit les r�f�rences d'URL.

chemin est le nom d'un chemin virtuel local. url est une URL partielle pour le serveur distant - ils sont utilis�s de la m�me fa�on qu'avec la directive ProxyPass.

Supposons par exemple que le serveur local a pour adresse http://example.com/ ; alors

ne va pas seulement provoquer la conversion interne d'une requ�te locale pour http://example.com/miroir/foo/bar en une requ�te mandat�e pour http://backend.example.com/bar (la fonctionnalit� fournie par ProxyPass). Il va aussi s'occuper des redirections que le serveur backend.example.com envoie : lorsque http://backend.example.com/bar est redirig� par celui-ci vers http://backend.example.com/quux, Apache corrige ceci en http://example.com/miroir/foo/quux avant de faire suivre la redirection HTTP au client. Notez que le nom d'h�te utilis� pour construire l'URL est choisi en respectant la d�finition de la directive UseCanonicalName.

Notez que la directive ProxyPassReverse peut aussi �tre utilis�e en conjonction avec la fonctionnalit� pass-through (RewriteRule ... [P]) du module mod_rewrite, car elle ne d�pend pas d'une directive ProxyPass correspondante.

Le mot-cl� optionnel interpolate (disponible depuis httpd 2.2.9), utilis� en combinaison avec la directive ProxyPassInterpolateEnv, permet l'interpolation des variables d'environnement sp�cifi�es en utilisant le format ${VARNAME} Notez que l'interpolation n'est pas support�e dans la partie protocole d'une URL.

Lorsque cette directive est utilis�e dans une section <Location>, le premier argument est omis et le r�pertoire local est obtenu � partir de l'argument de la directive <Location>. Il en est de m�me � l'int�rieur d'une section <LocationMatch>, mais le r�sultat ne correspondra probablement pas � ce que vous attendez, car ProxyPassReverse interpr�te l'expression rationnelle litt�ralement comme un chemin ; si n�cessaire dans cette situation, sp�cifiez la directive ProxyPassReverse en dehors de la section, ou dans une section <Location> s�par�e.

Cette directive ne peut pas �tre plac�e dans une section <Directory> ou <Files>.

ProxyPassReverseCookieDomain Directive

L'utilisation de cette directive est similaire � celle de la directive ProxyPassReverse, mais au lieu de r��crire des en-t�tes qui contiennent des URLs, elle r��crit la cha�ne correspondant au domaine dans les en-t�tes Set-Cookie.

ProxyPassReverseCookiePath Directive

Cette directive s'av�re utile en conjonction avec la directive ProxyPassReverse dans les situations o� les chemins d'URL d'arri�re-plan correspondent � des chemins publics sur le mandataire inverse. Cette directive permet de r��crire la cha�ne path dans les en-t�tes Set-Cookie. Si le d�but du chemin du cookie correspond � chemin-interne, le chemin du cookie sera remplac� par chemin-public.

Dans l'exemple fourni avec la directive ProxyPassReverse, la directive :

va r��crire un cookie poss�dant un chemin d'arri�re-plan / (ou /example ou en fait tout chemin) en /mirror/foo/..

ProxyPreserveHost Directive

Lorsqu'elle est activ�e, cette directive va transmettre l'en-t�te Host: de la requ�te entrante vers le serveur mandat�, au lieu du nom d'h�te sp�cifi� par la directive ProxyPass.

Cette directive est habituellement d�finie � Off. Elle est principalement utile dans les configurations particuli�res comme l'h�bergement virtuel mandat� en masse � base de nom, o� l'en-t�te Host d'origine doit �tre �valu� par le serveur d'arri�re-plan.

ProxyReceiveBufferSize Directive

La directive ProxyReceiveBufferSize permet de sp�cifier une taille de tampon r�seau explicite (TCP/IP) pour les connexions mandat�es HTTP et FTP, afin d'am�liorer le d�bit de donn�es. Elle doit �tre sup�rieure � 512 ou d�finie � 0 pour indiquer que la taille de tampon par d�faut du syst�me doit �tre utilis�e.

ProxyRemote Directive

Cette directive permet de d�finir des mandataires distants pour ce mandataire. comparaison est soit le nom d'un protocole que supporte le serveur distant, soit une URL partielle pour laquelle le serveur distant devra �tre utilis�, soit * pour indiquer que le serveur distant doit �tre utilis� pour toutes les requ�tes. serveur-distant est une URL partielle correspondant au serveur distant. Syntaxe :

protocole est effectivement le protocole � utiliser pour communiquer avec le serveur distant ; ce module ne supporte que http et https. Avec https, les requ�tes sont transmises par le mandataire distant via la m�thode HTTP CONNECT.

Dans la derni�re ligne de l'exemple, le mandataire va faire suivre les requ�tes FTP, encapsul�es dans une autre requ�te mandat�e HTTP, vers un autre mandataire capable de les traiter.

Cette directive supporte aussi les configurations de mandataire inverse - un serveur web d'arri�re-plan peut �tre int�gr� dans l'espace d'URL d'un serveur virtuel, m�me si ce serveur est cach� par un autre mandataire direct.

ProxyRemoteMatch Directive

La directive ProxyRemoteMatch est identique � la directive ProxyRemote, � l'exception que le premier argument est une expression rationnelle � mettre en correspondance avec l'URL de la requ�te.

ProxyRequests Directive

Cette directive permet d'activer/d�sactiver la fonctionnalit� de serveur mandataire direct d'Apache. D�finir ProxyRequests � Off n'interdit pas l'utilisation de la directive ProxyPass.

Pour une configuration typique de mandataire inverse ou passerelle, cette directive doit �tre d�finie � Off.

Afin d'activer la fonctionnalit� de mandataire pour des sites HTTP et/ou FTP, les modules mod_proxy_http et/ou mod_proxy_ftp doivent aussi �tre charg�s dans le serveur.

mod_proxy_connect doit �tre activ� pour pouvoir mandater (en direct) des sites HTTPS.

Voir aussi

• Mandataires/Passerelles directs et inverses

ProxySet Directive

Cette directive propose une m�thode alternative pour d�finir tout param�tre relatif aux r�partiteurs de charge et serveurs cibles de mandataires normalement d�fini via la directive ProxyPass. Si elle se trouve dans un conteneur <Proxy url de r�partiteur|url de serveur cible>, l'argument url n'est pas n�cessaire. Comme effet de bord, le r�partiteur ou serveur cible respectif est cr��. Ceci peut s'av�rer utile pour la mise en oeuvre d'un mandataire inverse via une directive RewriteRule au lieu de ProxyPass.

ProxyStatus Directive

Cette directive permet de sp�cifier si les donn�es d'�tat du r�partiteur de charge du mandataire doivent �tre affich�es via la page d'�tat du serveur du module mod_status.

ProxyTimeout Directive

Cette directive permet � l'utilisateur de sp�cifier un d�lai pour les requ�tes mandat�es. Ceci s'av�re utile dans le cas d'un serveur d'applications lent et bogu� qui a tendance � se bloquer, et si vous pr�f�rez simplement renvoyer une erreur timeout et abandonner la connexion en douceur plut�t que d'attendre jusqu'� ce que le serveur veuille bien r�pondre.

ProxyVia Directive

Cette directive permet de contr�ler l'utilisation de l'en-t�te HTTP Via: par le mandataire. Le but recherch� est de contr�ler le flux des requ�tes mandat�es tout au long d'une cha�ne de serveurs mandataires. Voir RFC 2616 (HTTP/1.1), section 14.45 pour une description des lignes d'en-t�te Via:.

• Si elle est d�finie � Off, valeur par d�faut, cette directive n'effectue aucun traitement particulier. Si une requ�te ou une r�ponse contient un en-t�te Via:, il est transmis sans modification.
• Si elle est d�finie � On, chaque requ�te ou r�ponse se verra ajouter une ligne d'en-t�te Via: pour le serveur courant.
• Si elle est d�finie � Full, chaque ligne d'en-t�te Via: se verra ajouter la version du serveur Apache sous la forme d'un champ de commentaire Via:.
• Si elle est d�finie � Block, chaque requ�te mandat�e verra ses lignes d'en-t�te Via: supprim�es. Aucun nouvel en-t�te Via: ne sera g�n�r�.