mirror of
https://github.com/apache/httpd.git
synced 2025-10-28 20:34:59 +03:00
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1826413 13f79535-47bb-0310-9956-ffa450edef68
428 lines
29 KiB
Plaintext
428 lines
29 KiB
Plaintext
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
|
||
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
|
||
<!--
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
This file is generated from xml source: DO NOT EDIT
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
-->
|
||
<title>mod_remoteip - Serveur Apache HTTP Version 2.5</title>
|
||
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
|
||
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
|
||
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
|
||
<script src="../style/scripts/prettify.min.js" type="text/javascript">
|
||
</script>
|
||
|
||
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
|
||
<body>
|
||
<div id="page-header">
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
|
||
<p class="apache">Serveur Apache HTTP Version 2.5</p>
|
||
<img alt="" src="../images/feather.png" /></div>
|
||
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
|
||
<div id="path">
|
||
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
|
||
<div id="page-content">
|
||
<div id="preamble"><h1>Module Apache mod_remoteip</h1>
|
||
<div class="toplang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_remoteip.html" title="Fran<61>ais"> fr </a></p>
|
||
</div>
|
||
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Remplace l'adresse IP du client
|
||
pour la requ<71>te par l'adresse IP pr<70>sent<6E>e par un mandataire ou un
|
||
r<EFBFBD>partiteur de charge via les en-t<>tes de la requ<71>te.
|
||
</td></tr>
|
||
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
|
||
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>remoteip_module</td></tr>
|
||
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_remoteip.c</td></tr></table>
|
||
<h3>Sommaire</h3>
|
||
|
||
<p>Ce module permet de traiter le client qui a initi<74> la
|
||
requ<71>te en tant que client original du point de vue de httpd <20>
|
||
des fins d'autorisation et de connexion, m<>me si ce client se
|
||
trouve derri<72>re un r<>partiteur de charge, un serveur frontal, ou un
|
||
serveur mandataire.</p>
|
||
|
||
<p>Le module remplace l'adresse IP du client
|
||
pour la connexion par l'adresse IP indiqu<71>e dans
|
||
l'en-t<>te de requ<71>te configur<75> via la directive
|
||
<code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.</p>
|
||
|
||
<p>En outre, ce module impl<70>mente la partie serveur du <a href="http://blog.haproxy.com/haproxy/proxy-protocol/">protocole PROXY</a>
|
||
de HAProxy lorsqu'on utilise la directive <code class="directive"><a href="#remoteipproxyprotocol">RemoteIPProxyProtocol</a></code>.</p>
|
||
|
||
<p>Une fois sa valeur modifi<66>e comme indiqu<71>, cette adresse IP client est
|
||
utilis<69>e pour la fonctionnalit<69> <code class="directive"><a href="../mod/mod_authz_host.html#require">Require ip</a></code> de
|
||
<code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ; elle est aussi affich<63>e par
|
||
<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, et enregistr<74>e via les cha<68>nes de formatage
|
||
<code>%a</code> des modules <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> et <code class="module"><a href="../mod/core.html">core</a></code>.
|
||
L'adresse IP client sous-jacente de la connexion est enregistr<74>e via la cha<68>ne de
|
||
formatage <code>%{c}a</code>.
|
||
</p>
|
||
|
||
<div class="warning">Il est essentiel de n'activer cette
|
||
fonctionnalit<69> que pour les requ<71>tes en provenance des serveurs
|
||
interm<72>diaires (mandataires, etc...) auxquels le serveur peut faire
|
||
confiance, car il est trivial pour le client distant d'usurper
|
||
l'identit<69> d'un autre client.</div>
|
||
</div>
|
||
<div id="quickview"><h3>Sujets</h3>
|
||
<ul id="topics">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#processing">Traitement des adresses distantes</a></li>
|
||
</ul><h3 class="directives">Directives</h3>
|
||
<ul id="toc">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteipheader">RemoteIPHeader</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteipproxyprotocol">RemoteIPProxyProtocol</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteipproxyprotocolexceptions">RemoteIPProxyProtocolExceptions</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></li>
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></li>
|
||
</ul>
|
||
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_remoteip">Probl<62>mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_remoteip">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
|
||
<ul class="seealso">
|
||
<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li>
|
||
<li><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></li>
|
||
<li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li>
|
||
<li><a href="http://www.haproxy.org/download/1.8/doc/proxy-protocol.txt">Proxy Protocol Spec</a></li>
|
||
<li><a href="#comments_section">Commentaires</a></li></ul></div>
|
||
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
|
||
<div class="section">
|
||
<h2><a name="processing" id="processing">Traitement des adresses distantes</a></h2>
|
||
|
||
<p>Par d<>faut, Apache identifie le client via la valeur client_ip de la
|
||
connexion, et de cette valeur d<>coulent les valeurs remote_host et
|
||
remote_logname de la connexion. Ces champs jouent un r<>le
|
||
dans l'authentification, l'autorisation et la journalisation, ainsi que
|
||
dans d'autres traitements effectu<74>s par d'autres modules
|
||
chargeables.</p>
|
||
|
||
<p>mod_remoteip remplace l'adresse IP client de la connexion par l'adresse IP client
|
||
indiqu<71>e par exemple par un mandataire ou un r<>partiteur de charge
|
||
pour toute la dur<75>e de la requ<71>te. Un r<>partiteur de charge pourra ainsi
|
||
<20>tablir une connexion keepalive de longue dur<75>e avec le serveur, chaque
|
||
requ<71>te conservant alors l'adresse IP client correcte bien que l'adresse IP
|
||
client sous-jacente du r<>partiteur de charge reste inchang<6E>e.</p>
|
||
|
||
<p>Lorsque la valeur de l'en-t<>te comporte plusieurs adresses IP
|
||
client s<>par<61>es par des virgules, celles-ci sont trait<69>es de la
|
||
droite vers la gauche. Le traitement s'arr<72>te lorsque l'adresse IP
|
||
client courante n'est pas digne de confiance pour pr<70>senter
|
||
l'adresse IP pr<70>c<EFBFBD>dente. Le champ d'en-t<>te est alors mis <20> jour de
|
||
fa<66>on <20> ne contenir que cette liste d'adresses non confirm<72>es, ou
|
||
bien, si toutes les adresses IP sont dignes de confiance, cet
|
||
en-t<>te est tout bonnement supprim<69> de la requ<71>te.</p>
|
||
|
||
<p>Lors du remplacement de l'adresse IP client, le module stocke
|
||
la liste des h<>tes interm<72>diaires dans un m<>mo
|
||
remoteip-proxy-ip-list, que l'on peut faire enregistrer par
|
||
<code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> en utilisant le symbole de format
|
||
<code>%{remoteip-proxy-ip-list}n</code>. Si l'administrateur doit
|
||
stocker ceci dans un en-t<>te additionnel, la m<>me valeur peut aussi
|
||
<20>tre enregistr<74>e sous la forme d'un en-t<>te en utilisant la
|
||
directive <code class="directive"><a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></code>.</p>
|
||
|
||
<div class="note"><h3>Adresses IPv4 converties au format IPv6</h3>
|
||
Avec httpd, d'une mani<6E>re g<>n<EFBFBD>rale, toute adresse IPv4 convertie au
|
||
format IPv6 est enregistr<74>e sous sa forme IPv4.</div>
|
||
|
||
<div class="note"><h3>Adresses internes (priv<69>es)</h3>
|
||
Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16,
|
||
169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc
|
||
public 2000::/3 block) ne sont <20>valu<6C>es par mod_remoteip que lorsque
|
||
des mandataires internes (intranet)
|
||
<code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> sont enregistr<74>s.</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="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#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 <20>
|
||
<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<73>cifi<66> comme l'adresse IP du client, ou comme
|
||
une liste d'adresses IP clients interm<72>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<6E>res
|
||
directives ne sont pas utilis<69>es, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>
|
||
traitera tout h<>te pr<70>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>
|
||
|
||
<div class="example"><h3>Exemple <20> usage interne (r<>partiteur de
|
||
charge)</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>
|
||
|
||
</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<70>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#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<70>senter une valeur RemoteIPHeader
|
||
valide de l'adresse IP du client. A la diff<66>rence de la directive
|
||
<code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>, toute adresse IP
|
||
pr<70>sent<6E>e dans cet en-t<>te, y comprises les adresses intranet
|
||
priv<69>es, sont consid<69>r<EFBFBD>es comme dignes de confiance lorsqu'elles
|
||
sont indiqu<71>es par ces mandataires.</p>
|
||
|
||
<div class="example"><h3>Exemple <20> usage interne (r<>partiteur de
|
||
charge)</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Client-IP
|
||
RemoteIPInternalProxy 10.0.2.0/24
|
||
RemoteIPInternalProxy gateway.localdomain</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="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<70>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#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<73>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<70>senter une valeur RemoteIPHeader
|
||
valide de l'adresse IP du client.</p>
|
||
|
||
<p>Le caract<63>re '<code>#</code>' indique une ligne de commentaires,
|
||
sinon, toutes les lignes s<>par<61>es par un caract<63>re <code>nouvelle
|
||
ligne</code> ou
|
||
tous les <20>l<EFBFBD>ments d'une ligne s<>par<61>s par un espace sont trait<69>s de
|
||
la m<>me fa<66>on qu'avec la directive
|
||
<code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code>.</p>
|
||
|
||
<div class="example"><h3>Exemple <20> usage interne (r<>partiteur de
|
||
charge)</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>
|
||
<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<72>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#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<73>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<72>diaires
|
||
auxquelles on pourra faire confiance pour r<>soudre l'adresse IP
|
||
client de la requ<71>te. Notez que les adresses interm<72>diaires
|
||
<code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code> sont enregistr<74>es dans
|
||
cet en-t<>te, alors que toute adresse interm<72>diaire
|
||
<code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code> est omise.</p>
|
||
|
||
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
|
||
RemoteIPProxiesHeader X-Forwarded-By</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="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#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<69>:</a></th><td>Disponible <20> partir de la version 2.4.31 du serveur HTTP Apache</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 <20> <code>On</code>, la
|
||
demande du client <em>doit</em> envoyer l'en-t<>te appropri<72> pour chaque
|
||
nouvelle connexion, sinon cette derni<6E>re sera ferm<72>e <20> 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<69>.</p>
|
||
|
||
<p>Bien que cette directive peut <20>tre d<>finie au niveau de n'importe quel
|
||
serveur virtuel, il est important de garder <20> l'esprit que, <20>tant donn<6E> que
|
||
le protocole PROXY est bas<61> sur la connexion et agnostique quant au
|
||
protocle, son activation/d<>sactivation est bas<61>e sur le couple adresse
|
||
IP/port. Cela signifie que si plusieurs serveurs virtuels <20> base de nom sont
|
||
configur<75>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<6E>re directive l'emporte sur les autres et une notification sera
|
||
enregistr<74>e dans le journal pour indiquer les r<>glages qui ont <20>t<EFBFBD> annul<75>s.</p>
|
||
|
||
<pre class="prettyprint lang-config">Listen 80
|
||
<VirtualHost *:80>
|
||
ServerName www.example.com
|
||
RemoteIPProxyProtocol On
|
||
|
||
#Les requ<71>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<72>e.
|
||
</VirtualHost>
|
||
|
||
Listen 8080
|
||
<VirtualHost *:8080>
|
||
ServerName www.example.com
|
||
RemoteIPProxyProtocol On
|
||
RemoteIPProxyProtocolExceptions 127.0.0.1 10.0.0.0/8
|
||
|
||
#Les requ<71>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<72>e <20> moins
|
||
que sa source ne soit localhost ou la gamme d'adresses RFC1918 10.x.x.x
|
||
</VirtualHost></pre>
|
||
|
||
|
||
</div>
|
||
<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#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<69>:</a></th><td>RemoteIPProxyProtocolExceptions est disponible <20> partir de la
|
||
version 2.4.31 du serveur HTTP Apache</td></tr>
|
||
</table>
|
||
<p>La directive <code class="directive">RemoteIPProxyProtocol</code> permet de
|
||
contr<74>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<70>sence de l'en-t<>te PROXY, mais aussi de permettre aux autres clients de
|
||
se connecter sans ce dernier. Cette directive permet <20> l'administrateur du
|
||
serveur d'autoriser cette possibilit<69> <20> un h<>te isol<6F> ou <20> une gamme d'h<>tes
|
||
au format CIDR.</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<70>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#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<69>r<EFBFBD>es comme de confiance pour pr<70>senter une valeur RemoteIPHeader
|
||
valide de l'adresse IP du client.</p>
|
||
|
||
<p>A la diff<66>rence de la directive
|
||
<code class="directive"><a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></code>, toutes les adresses IP
|
||
intranet ou priv<69>es indiqu<71>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<74>e en dehors du bloc IPv6 public 2000::/3), ne sont pas
|
||
dignes de confiance en tant qu'adresses IP clientes, et se situent
|
||
<20> 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<69>rera comme de confiance tout h<>te pr<70>sentant une adresse non
|
||
interne dans l'en-t<>te <code class="directive"><a href="#remoteipheader">RemoteIPHeader</a></code>.
|
||
</div>
|
||
|
||
<div class="example"><h3>Exemple d'adresse de confiance (r<>partiteur de
|
||
charge</h3><pre class="prettyprint lang-config">RemoteIPHeader X-Forwarded-For
|
||
RemoteIPTrustedProxy 10.0.2.16/28
|
||
RemoteIPTrustedProxy proxy.example.com</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="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<70>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#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<73>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<70>senter une valeur RemoteIPHeader
|
||
valide de l'adresse IP du client.</p>
|
||
|
||
<p>Le caract<63>re '<code>#</code>' indique une ligne de commentaires,
|
||
sinon, toutes les lignes s<>par<61>es par un caract<63>re nouvelle ligne ou
|
||
tous les <20>l<EFBFBD>ments d'une ligne s<>par<61>s par un espace sont trait<69>s de
|
||
la m<>me fa<66>on qu'avec la directive
|
||
<code class="directive"><a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></code>.</p>
|
||
|
||
<div class="example"><h3>Exemple d'adresse de confiance (r<>partiteur de
|
||
charge</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<66>s<br />
|
||
192.0.2.16/28 #groupe wap phone de mandataires<br />
|
||
proxy.isp.example.com #un FAI bien connu
|
||
</code></p></div>
|
||
|
||
</div>
|
||
</div>
|
||
<div class="bottomlang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_remoteip.html" title="Fran<61>ais"> fr </a></p>
|
||
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
|
||
<script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
var comments_shortname = 'httpd';
|
||
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_remoteip.html';
|
||
(function(w, d) {
|
||
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
|
||
d.write('<div id="comments_thread"><\/div>');
|
||
var s = d.createElement('script');
|
||
s.type = 'text/javascript';
|
||
s.async = true;
|
||
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
|
||
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
|
||
}
|
||
else {
|
||
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
|
||
}
|
||
})(window, document);
|
||
//--><!]]></script></div><div id="footer">
|
||
<p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
|
||
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
|
||
if (typeof(prettyPrint) !== 'undefined') {
|
||
prettyPrint();
|
||
}
|
||
//--><!]]></script>
|
||
</body></html> |