XML updates.

<?xml version="1.0"?>

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1568654 -->

<modulesynopsis metafile="mod_remoteip.xml.meta">

<name>mod_remoteip</name>

<description>Remplace l'adresse IP et le nom d'h&ocirc;te apparents du client

pour la requête par l'adresse IP présentée par un mandataire ou un

répartiteur de charge via les en-têtes de la requête.

<description>Remplace l'adresse IP du client

pour la requête par l'adresse IP présentée par un mandataire ou un

répartiteur de charge via les en-têtes de la requête.

</description>

<status>Base</status>

<identifier>remoteip_module</identifier>

<summary>

    <p>Ce module permet de traiter l'h&ocirc;te distant qui a initi&eacute; la

    requête en tant qu'hôte distant original du point de vue de httpd à

    des fins d'autorisation et de connexion, même si cet hôte distant se

    trouve derrière un répartiteur de charge, un serveur frontal, ou un

    <p>Ce module permet de traiter le client qui a initié la

    requête en tant que client original du point de vue de httpd à

    des fins d'autorisation et de connexion, même si ce client se

    trouve derrière un répartiteur de charge, un serveur frontal, ou un

    serveur mandataire.</p>

    <p>Le module remplace les adresse IP et nom d'h&ocirc;te apparents

    distants (du client) pour la requête par l'adresse IP indiquée dans

    l'en-tête de requête configuré via la directive

    <p>Le module remplace l'adresse IP du client

    pour la connexion par l'adresse IP indiquée dans

    l'en-tête de requête configuré via la directive

    <directive module="mod_remoteip">RemoteIPHeader</directive>.</p>

    <p>Une fois remplac&eacute;e comme indiqu&eacute;, cette adresse IP apparente est

    utilis&eacute;e pour la fonctionnalit&eacute; <directive

    module="mod_authz_core" name="require">Require ip</directive> de

    <module>mod_authz_host</module> ; elle est aussi affich&eacute;e par

    <module>mod_status</module>, et enregistr&eacute;e via les directives

    <code>%a</code> et <code>%h</code> du module

    <module>mod_log_config</module>. Elle permet aussi d'identifier la

    machine en essayant de lui attribuer une identité inetd via le

    module <module>mod_ident</module> et en fonction de la configuration

    de la directive <directive

    module="mod_ident">IdentityCheck</directive>.</p>

    <p>Une fois sa valeur modifiée comme indiqué, cette adresse IP client est

    utilisée pour la fonctionnalité <directive

    module="mod_authz_host" name="require">Require ip</directive> de

    <module>mod_authz_host</module> ; elle est aussi affichée par

    <module>mod_status</module>, et enregistrée via les chaînes de formatage

    <code>%a</code> des modules <module>mod_log_config</module> et <module>core</module>.

    L'adresse IP client sous-jacente de la connexion est enregistrée via la chaîne de

    formatage <code>%{c}a</code>.

    </p>

    <note type="warning">Il est essentiel de n'activer cette

    fonctionnalité que pour les requêtes en provenance des serveurs

    intermédiaires (mandataires, etc...) auxquels le serveur peut faire

    fonctionnalité que pour les requêtes en provenance des serveurs

    intermédiaires (mandataires, etc...) auxquels le serveur peut faire

    confiance, car il est trivial pour le client distant d'usurper

    l'identit&eacute; d'un autre client.</note>

    l'identité d'un autre client.</note>

</summary>

<seealso><module>mod_authz_host</module></seealso>

<seealso><module>mod_status</module></seealso>

<seealso><module>mod_log_config</module></seealso>

<seealso><module>mod_ident</module></seealso>

<section id="processing"><title>Traitement des adresses distantes</title>

    <p>Apache identifie le client par la valeur remote_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 connexion, ainsi que

    dans d'autres traitements effectués par d'autres modules

    <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és par d'autres modules

    chargeables.</p>

    <p>mod_remoteip remplace la v&eacute;ritable remote_ip par la remote_ip

    indiquée par exemple par un mandataire chaque fois que le serveur

    effectue une évaluation du client, et réinitialise les valeurs de

    remote_host et remote_logname afin de déclencher une nouvelle

    requ&ecirc;te dns ou ident sur l'adresse IP distante.</p>

    <p>Lorsque la valeur de l'en-t&ecirc;te comporte plusieurs adresses IP

    distantes séparées par des virgules, celles-ci sont traitées de la

    droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP

    distante courante n'est pas digne de confiance pour présenter

    l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de

    façon à ne contenir que cette liste d'adresses non confirmées, ou

    <p>mod_remoteip remplace l'adresse IP client de la connexion par l'adresse IP client

    indiquée par exemple par un mandataire ou un répartiteur de charge

    pour toute la durée de la requête. Un répartiteur de charge pourra ainsi

    établir une connexion keepalive de longue durée avec le serveur, chaque

    requête conservant alors l'adresse IP client correcte bien que l'adresse IP

    client sous-jacente du répartiteur de charge reste inchangée.</p>

    <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP

    client séparées par des virgules, celles-ci sont traitées de la

    droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP

    client courante n'est pas digne de confiance pour présenter

    l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de

    façon à ne contenir que cette liste d'adresses non confirmées, ou

    bien, si toutes les adresses IP sont dignes de confiance, cet

    en-t&ecirc;te est tout bonnement supprim&eacute; de la requ&ecirc;te.</p>

    en-tête est tout bonnement supprimé de la requête.</p>

    <p>Lors du remplacement de l'adresse IP distante, le module stocke

    la liste des hôtes intermédiaires dans un mémo

    <p>Lors du remplacement de l'adresse IP client, le module stocke

    la liste des hôtes intermédiaires dans un mémo

    remoteip-proxy-ip-list, que l'on peut faire enregistrer par

    <module>mod_log_config</module> 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

    être enregistrée sous la forme d'un en-tête en utilisant la

    stocker ceci dans un en-tête additionnel, la même valeur peut aussi

    être enregistrée sous la forme d'un en-tête en utilisant la

    directive <directive module="mod_remoteip">RemoteIPProxiesHeader</directive>.</p>

    <note><title>Adresses IPv4 converties au format IPv6</title>

    Avec httpd, d'une manière générale, toute adresse IPv4 convertie au

    format IPv6 est enregistr&eacute;e sous sa forme IPv4.</note>

    Avec httpd, d'une manière générale, toute adresse IPv4 convertie au

    format IPv6 est enregistrée sous sa forme IPv4.</note>

    <note><title>Adresses internes (priv&eacute;es)</title>

    <note><title>Adresses internes (privées)</title>

    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 évaluées par mod_remoteip que lorsque

    public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque

    des mandataires internes (intranet)

    <directive module="mod_remoteip">RemoteIPInternalProxy</directive> sont enregistr&eacute;s.</note>

    <directive module="mod_remoteip">RemoteIPInternalProxy</directive> sont enregistrés.</note>

</section>

<directivesynopsis>

<name>RemoteIPHeader</name>

<description>D&eacute;finit le champ d'en-t&ecirc;te qui contiendra les adresses IP

<description>Définit le champ d'en-tête qui contiendra les adresses IP

du client</description>

<syntax>RemoteIPHeader <var>en-t&ecirc;te</var></syntax>

<syntax>RemoteIPHeader <var>en-tête</var></syntax>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage>

    <p>La directive <directive module="mod_remoteip">RemoteIPHeader</directive> indique &agrave;

    <p>La directive <directive module="mod_remoteip">RemoteIPHeader</directive> indique à

    <module>mod_remoteip</module> de traiter la valeur de

    l'<var>en-t&ecirc;te</var> sp&eacute;cifi&eacute; comme l'adresse IP du client, ou comme

    une liste d'adresses IP clients intermédiaires, en fonction de la

    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

    <directive module="mod_remoteip">RemoteIPInternalProxy</directive> et

    <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>. Si ces deux derni&egrave;res

    directives ne sont pas utilis&eacute;es, <module>mod_remoteip</module>

    traitera tout hôte présentant une valeur d'IP

    <directive module="mod_remoteip">RemoteIPHeader</directive> comme h&ocirc;te de confiance.</p>

    <example><title>Exemple &agrave; usage interne (r&eacute;partiteur de

    <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>. Si ces

    deux dernières directives ne sont pas utilisées,

    <module>mod_remoteip</module> traitera tout hôte présentant une adresse non

    interne dans l'en-tête <directive

    module="mod_remoteip">RemoteIPHeader</directive> comme hôte de confiance.</p>

    <note type="warning">Si ces deux dernières

    directives ne sont pas utilisées, <module>mod_remoteip</module>

    traitera tout hôte présentant une adresse non interne

    dans l'en-tête <directive

    module="mod_remoteip">RemoteIPHeader</directive> comme hôte de

    confiance.</note>

    <example><title>Exemple à usage interne (répartiteur de

    charge)</title>

    <highlight language="config">

        RemoteIPHeader X-Client-IP

<directivesynopsis>

<name>RemoteIPInternalProxy</name>

<description>D&eacute;clare les adresses IP intranet clients comme dignes de

confiance pour pr&eacute;senter la valeur RemoteIPHeader</description>

<description>Déclare les adresses IP intranet clients comme dignes de

confiance pour présenter la valeur RemoteIPHeader</description>

<syntax>RemoteIPInternalProxy

<var>ip-mandataire</var>|<var>ip-mandataire/sous-r&eacute;seau</var>|<var>nom-h&ocirc;te</var> ...</syntax>

<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage>

    <p>La directive <directive module="mod_remoteip">RemoteIPInternalProxy</directive> 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

    on peut faire confiance pour présenter une valeur RemoteIPHeader

    valide de l'adresse IP du client. A la différence de la directive

    <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>, 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&eacute;es par ces mandataires.</p>

    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>

    <example><title>Exemple &agrave; usage interne (r&eacute;partiteur de

    <example><title>Exemple à usage interne (répartiteur de

    charge)</title>

        <highlight language="config">

RemoteIPHeader X-Client-IP

<directivesynopsis>

<name>RemoteIPInternalProxyList</name>

<description>D&eacute;clare les adresses IP intranet clients comme dignes de

confiance pour pr&eacute;senter la valeur RemoteIPHeader</description>

<description>Déclare les adresses IP intranet clients comme dignes de

confiance pour présenter la valeur RemoteIPHeader</description>

<syntax>RemoteIPInternalProxyList <var>nom-fichier</var></syntax>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage>

    <p>La directive <directive module="mod_remoteip">RemoteIPInternalProxyList</directive>

    permet de spécifier un fichier parcouru au démarrage du serveur pour

    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

    on peut faire confiance pour présenter une valeur RemoteIPHeader

    valide de l'adresse IP du client.</p>

    <p>Le caract&egrave;re '<code>#</code>' indique une ligne de commentaires,

    sinon, toutes les lignes s&eacute;par&eacute;es par un caract&egrave;re <code>nouvelle

    <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

    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

    <directive module="mod_remoteip">RemoteIPInternalProxy</directive>.</p>

    <example><title>Exemple &agrave; usage interne (r&eacute;partiteur de

    <example><title>Exemple à usage interne (répartiteur de

    charge)</title>

        <highlight language="config">

RemoteIPHeader X-Client-IP

    <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

         passerelle.domaine-local # Le frontal répartiteur de charge

    </pre>

    </example>

</usage>

<directivesynopsis>

<name>RemoteIPProxiesHeader</name>

<description>D&eacute;clare le champ d'en-t&ecirc;te qui contiendra toutes les

adresses IP interm&eacute;diaires</description>

<syntax>RemoteIPProxiesHeader <var>Nom_en-t&ecirc;te</var></syntax>

<description>Déclare le champ d'en-tête qui contiendra toutes les

adresses IP intermédiaires</description>

<syntax>RemoteIPProxiesHeader <var>Nom_en-tête</var></syntax>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage>

    <p>La directive <directive module="mod_remoteip">RemoteIPProxiesHeader</directive> permet

    de sp&eacute;cifier l'en-t&ecirc;te dans lequel <module>mod_remoteip</module> va

    collecter une liste de toutes les adresses IP clients intermédiaires

    auxquelles on pourra faire confiance pour résoudre la véritable

    adresse IP distante. Notez que les adresses intermédiaires

    <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> sont enregistr&eacute;es dans

    cet en-tête, alors que toute adresse intermédiaire

    de spécifier l'en-tête dans lequel <module>mod_remoteip</module> 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

    <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> sont enregistrées dans

    cet en-tête, alors que toute adresse intermédiaire

    <directive module="mod_remoteip">RemoteIPInternalProxy</directive> est omise.</p>

    <example><title>Exemple</title>

<directivesynopsis>

<name>RemoteIPTrustedProxy</name>

<description>D&eacute;clare les adresses IP intranet clients comme dignes de

confiance pour pr&eacute;senter la valeur RemoteIPHeader</description>

<description>Déclare les adresses IP clientes de l'intranet dignes de

confiance pour présenter la valeur RemoteIPHeader</description>

<syntax>RemoteIPTrustedProxy

<var>ip-mandataire</var>|<var>ip-mandataire/sous-r&eacute;seau</var>|<var>nom-h&ocirc;te</var> ...</syntax>

<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage>

    <p>La directive <directive module="mod_remoteip">RemoteIPTrustedProxy</directive> 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

    on peut faire confiance pour présenter une valeur RemoteIPHeader

    valide de l'adresse IP du client. A la différence de la directive

    <directive module="mod_remoteip">RemoteIPInternalProxy</directive>, toutes les adresses IP

    intranet ou privées indiquées par de tels mandataires, y compris les

    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

    (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas

    dignes de confiance en tant qu'adresses IP distantes, et se situent

    à gauche dans le contenu de l'en-tête

    à gauche dans le contenu de l'en-tête

    <directive module="mod_remoteip">RemoteIPHeader</directive>.</p>

    <example><title>Exemple d'adresse de confiance (r&eacute;partiteur de

    <example><title>Exemple d'adresse de confiance (répartiteur de

    charge</title>

        <highlight language="config">

RemoteIPHeader X-Forwarded-For

<directivesynopsis>

<name>RemoteIPTrustedProxyList</name>

<description>D&eacute;clare les adresses IP intranet clients comme dignes de

confiance pour pr&eacute;senter la valeur RemoteIPHeader</description>

<description>Déclare les adresses IP intranet clients comme dignes de

confiance pour présenter la valeur RemoteIPHeader</description>

<syntax>RemoteIPTrustedProxyList <var>nom-fichier</var></syntax>

<contextlist><context>server config</context><context>virtual host</context></contextlist>

<usage>

    <p>La directive <directive module="mod_remoteip">RemoteIPTrustedProxyList</directive>

    permet de spécifier un fichier parcouru au démarrage du serveur pour

    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

    on peut faire confiance pour présenter une valeur RemoteIPHeader

    valide de l'adresse IP du client.</p>

    <p>Le caract&egrave;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

    <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

    <directive module="mod_remoteip">RemoteIPTrustedProxy</directive>.</p>

    <example><title>Exemple d'adresse de confiance (r&eacute;partiteur de

    <example><title>Exemple d'adresse de confiance (répartiteur de

    charge</title>

        <highlight language="config">

RemoteIPHeader X-Forwarded-For

    </example>

    <example><title>conf/mandataires-de-confiance.lst contents</title>

       # Mandataires externes identifi&eacute;s<br/>

       # Mandataires externes identifiés<br/>

       192.0.2.16/28         #groupe wap phone de mandataires<br/>

       proxy.isp.example.com #un FAI bien connu

    </example>

</modulesynopsis>

<name>mod_setenvif</name>

<description>Permet de définir des variables d'environnement en fonction

de caractéristiques de la requête</description>

de certainescaractéristiques de la requête</description>

<status>Base</status>

<sourcefile>mod_setenvif.c</sourcefile>

<identifier>setenvif_module</identifier>

<summary>

    <p>Le module <module>mod_setenvif</module> vous permet de définir

    des variables d'environnement internes en fonction du fait que telle ou telle

    caractéristique de la requête correspond ou non aux expressions

    rationnelles que vous spécifiez. Ces variables d'environnement

    des variables d'environnement internes de manière conditionnelle en fonction

    de critères que vous pouvez spécifier. Ces variables d'environnement

    peuvent être utilisées par d'autres parties du serveur pour prendre

    des décisions quant aux actions à entreprendre, et pour déterminer

    si les scripts CGI et les pages SSI doivent pouvoir y accéder.</p>

    <p>La directive <directive>SetEnvIf</directive> permet de définir

    des variables d'environnement en fonction des attributs de la

    requête. L'<em>attribut</em> spécifié comme premier argument peut

    se présenter sous l'une des quatre formes suivantes :</p>

    se présenter sous l'une des trois formes suivantes :</p>

<ol>

<li>Un champ d'en-tête de requête HTTP (voir la <a