granicus.if.org Git - apache/blob - docs/manual/mod/mod_info.xml.fr

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1774505 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_info.xml.meta">
  26
  27 <name>mod_info</name>
  28 <description>Affiche une présentation complète de la configuration du
  29 serveur</description>
  30 <status>Extension</status>
  31 <sourcefile>mod_info.c</sourcefile>
  32 <identifier>info_module</identifier>
  33
  34 <summary>
  35     <p>Pour activer <module>mod_info</module>, ajoutez les lignes
  36     suivantes à votre fichier <code>httpd.conf</code>.</p>
  37
  38     <highlight language="config">
  39 &lt;Location "/server-info"&gt;
  40     SetHandler server-info
  41 &lt;/Location&gt;
  42     </highlight>
  43
  44     <p>Il est recommandé d'utiliser <module>mod_authz_host</module> à
  45     l'intérieur de la section <directive type="section"
  46     module="core">Location</directive> afin de restreindre l'accès aux
  47     informations de configuration de votre serveur :</p>
  48
  49     <highlight language="config">
  50 &lt;Location "/server-info"&gt;
  51     SetHandler server-info
  52     Require host example.com
  53 &lt;/Location&gt;
  54     </highlight>
  55
  56     <p>Une fois cette configuration effectuée, les informations du
  57     serveur sont disponibles à l'adresse
  58     <code>http://votre-serveur.com/infos-serveur</code>.</p>
  59 </summary>
  60
  61 <section id="security"><title>Problèmes liés à la sécurité</title>
  62     <p>Une fois <module>mod_info</module> chargé dans le serveur, sa
  63     fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
  64     fichiers de configuration, y compris les fichiers de configuration
  65     des répertoires (par exemple <code>.htaccess</code>). Ceci peut
  66     avoir des répercutions en matière de sécurité pour votre site.</p>
  67
  68     <p>En particulier, l'utilisation de ce module peut conduire à la
  69     divulgation d'informations sensibles à partir des directives de
  70     configuration d'autres modules Apache comme des chemins systèmes,
  71     des couples nom d'utilisateur/mot de passe, des noms de bases de
  72     données, etc... C'est pourquoi ce module ne doit être utilisé
  73     <strong>que</strong> dans un environnement sous contrôle et toujours
  74     avec les plus grandes précautions.</p>
  75
  76     <p>Il est recommandé d'utiliser <module>mod_authz_host</module> pour
  77     restreindre l'accès aux informations de configuration de votre
  78     serveur.</p>
  79
  80     <example><title>Contrôle d'accès</title>
  81       <highlight language="config">
  82 &lt;Location "/server-info"&gt;
  83     SetHandler server-info
  84     # Autorisation d'accès depuis le serveur lui-même
  85     Require ip 127.0.0.1
  86
  87     # Autorisation d'accès depuis une station de travail du réseau
  88 # local
  89     Require ip 192.168.1.17
  90 &lt;/Location&gt;
  91       </highlight>
  92     </example>
  93 </section>
  94
  95 <section id="queries"><title>Filtrage des informations affichées</title>
  96     <p>Par défaut, les informations affichées comprennent une liste de
  97     tous les modules activés, et pour chaque module, une description des
  98     directives qu'il accepte, les branchements (hooks) qu'il
  99     implémente, ainsi que les directives concernées dans la
 100     configuration courante.</p>
 101
 102     <p>Il est possible d'afficher d'autres vues de la configuration en
 103     ajoutant un argument à la requête <code>infos-serveur</code>. Par
 104     exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
 105     affichera toutes les directives de configuration.</p>
 106
 107     <dl>
 108         <dt><code>?&lt;module-name&gt;</code></dt>
 109             <dd>Uniquement les informations relatives au module
 110             spécifié</dd>
 111         <dt><code>?config</code></dt>
 112             <dd>Uniquement les directives de configuration, non triées
 113             par module</dd>
 114         <dt><code>?hooks</code></dt>
 115             <dd>Uniquement la liste des branchements (hooks)
 116             auxquels le module est attaché</dd>
 117         <dt><code>?list</code></dt>
 118             <dd>Une simple liste des modules activés</dd>
 119         <dt><code>?server</code></dt>
 120             <dd>Uniquement des informations de base sur le serveur</dd>
 121         <dt><code>?providers</code></dt>
 122             <dd>Liste des fournisseurs disponbles pour votre serveur</dd>
 123     </dl>
 124 </section>
 125
 126 <section id="startup"><title>Affichage de la configuration au démarrage</title>
 127     <p>Si la directive de configuration define
 128     <code>-DDUMP_CONFIG</code> est utilisée, <module>mod_info</module> va
 129     envoyer la configuration préinterprétée vers <code>stdout</code> au
 130     cours du démarrage du serveur.</p>
 131
 132     <highlight language="sh">
 133     httpd -DDUMP_CONFIG -k start
 134     </highlight>
 135
 136     <p>"Préinterprétée" signifie que
 137     les directives telles que <directive type="section"
 138     module="core">IfDefine</directive> et <directive type="section"
 139     module="core">IfModule</directive> sont évaluées et les variables
 140     d'environnement remplacées par leurs valeurs. Cela ne représente
 141     cependant pas la configuration définitive. En particulier, les
 142     fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
 143     représentés.</p>
 144
 145     <p>Le résultat est équivalent à celui de la requête
 146     <code>?config</code>.</p>
 147
 148 </section>
 149
 150 <section id="limitations"><title>Limitations connues</title>
 151     <p><module>mod_info</module> tire ses informations de
 152     la configuration interprétée, et non du fichier de configuration
 153     original. La manière dont l'arbre de configuration interprété est
 154     créé induit quelques limitations :</p>
 155     <ul>
 156       <li>Les directives qui sont traitées immédiatement sans être
 157       enregistrées dans l'arbre de configuration interprété ne sont pas
 158       prises en compte. Celles-ci comprennent <directive
 159       module="core">ServerRoot</directive>, <directive
 160       module="mod_so">LoadModule</directive> et <directive
 161       module="mod_so">LoadFile</directive>.</li>
 162       <li>Les directives qui contrôlent le fichier de configuration
 163       lui-même, comme <directive module="core">Include</directive>,
 164       <directive type="section" module="core">IfModule</directive> et
 165       <directive type="section" module="core">IfDefine</directive> ne
 166       sont pas prises en compte, mais les directives de configuration
 167       incluses le sont.</li>
 168       <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
 169       considéré comme une fonctionnalité).</li>
 170       <li>Les directives de configuration des fichiers
 171       <code>.htaccess</code> ne sont pas prises en compte (car elles ne
 172       font pas partie de la configuration permanente du serveur).</li>
 173       <li>Les directives de conteneur comme <directive type="section"
 174       module="core">Directory</directive> sont affichées
 175       normalement, mais <module>mod_info</module> est incapable de
 176       déterminer le numéro de ligne de la balise fermante
 177       <directive type="section" module="core"
 178       name="Directory">/Directory</directive>.</li>
 179       <li>Les directives générées par des modules tiers comme
 180       <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
 181       prises en compte.</li>
 182     </ul>
 183 </section>
 184
 185 <directivesynopsis>
 186 <name>AddModuleInfo</name>
 187 <description>Ajoute des données supplémentaires aux informations de
 188 module affichées par le gestionnaire server-info</description>
 189 <syntax>AddModuleInfo <var>nom-module</var> <var>chaîne</var></syntax>
 190 <contextlist><context>server config</context><context>virtual host</context>
 191 </contextlist>
 192
 193 <usage>
 194     <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
 195     en tant qu'<strong>Information supplémentaire</strong> interprétée
 196     en HTML pour le module <var>nom-module</var>. Exemple :</p>
 197
 198     <highlight language="config">
 199 AddModuleInfo mod_deflate.c 'See &lt;a \
 200     href="http://httpd.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\
 201     http://httpd.apache.org/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'
 202     </highlight>
 203 </usage>
 204
 205 </directivesynopsis>
 206 </modulesynopsis>