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

   1 <?xml version="1.0"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision : 1042758 -->
   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&eacute;sentation compl&egrave;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 &agrave; votre fichier <code>httpd.conf</code>.</p>
  37
  38     <example>
  39       &lt;Location /infos-serveur&gt;<br />
  40       <indent>
  41         SetHandler server-info<br />
  42       </indent>
  43       &lt;/Location&gt;
  44     </example>
  45
  46     <p>Il est recommand&eacute; d'utiliser <module>mod_access</module> &agrave;
  47     l'int&eacute;rieur de la section <directive type="section"
  48     module="core">Location</directive> afin de restreindre l'acc&egrave;s aux
  49     informations de configuration de votre serveur :</p>
  50
  51     <example>
  52       &lt;Location /infos-serveur&gt;<br />
  53       <indent>
  54         SetHandler server-info<br />
  55         Require host example.com<br />
  56       </indent>
  57       &lt;/Location&gt;
  58     </example>
  59
  60     <p>Une fois cette configuration effectu&eacute;e, les informations du
  61     serveur sont disponibles &agrave; l'adresse
  62     <code>http://votre-serveur.com/infos-serveur</code>.</p>
  63 </summary>
  64
  65 <section id="security"><title>Probl&egrave;mes li&eacute;s &agrave; la s&eacute;curit&eacute;</title>
  66     <p>Une fois <module>mod_info</module> charg&eacute; dans le serveur, sa
  67     fonctionnalit&eacute; de gestionnaire est disponible dans <em>tous</em> les
  68     fichiers de configuration, y compris les fichiers de configuration
  69     des r&eacute;pertoires (par exemple <code>.htaccess</code>). Ceci peut
  70     avoir des r&eacute;percutions en mati&egrave;re de s&eacute;curit&eacute; pour votre site.</p>
  71
  72     <p>En particulier, l'utilisation de ce module peut conduire &agrave; la
  73     divulgation d'informations sensibles &agrave; partir des directives de
  74     configuration d'autres modules Apache comme des chemins syst&egrave;mes,
  75     des couples nom d'utilisateur/mot de passe, des noms de bases de
  76     donn&eacute;es, etc... C'est pourquoi ce module ne doit &ecirc;tre utilis&eacute;
  77     <strong>que</strong> dans un environnement sous contr&ocirc;le et toujours
  78     avec les plus grandes pr&eacute;cautions.</p>
  79
  80     <p>Il est recommand&eacute; d'utiliser <module>mod_authz_host</module> pour
  81     restreindre l'acc&egrave;s aux informations de configuration de votre
  82     serveur.</p>
  83
  84     <example><title>Contr&ocirc;le d'acc&egrave;s</title>
  85       &lt;Location /infos-serveur&gt;<br />
  86       <indent>
  87         SetHandler server-info<br />
  88         Order allow,deny<br />
  89         # Autorisation d'acc&egrave;s depuis le serveur lui-m&ecirc;me<br />
  90         Allow from 127.0.0.1<br />
  91         # Autorisation d'acc&egrave;s depuis une station de travail du r&eacute;seau
  92         # local<br />
  93         Allow from 192.168.1.17<br />
  94       </indent>
  95       &lt;/Location&gt;
  96     </example>
  97 </section>
  98
  99 <section id="queries"><title>Filtrage des informations affich&eacute;es</title>
 100     <p>Par d&eacute;faut, les informations affich&eacute;es comprennent une liste de
 101     tous les modules activ&eacute;s, et pour chaque module, une description des
 102     directives qu'il accepte, les branchements (hooks) qu'il
 103     impl&eacute;mente, ainsi que les directives concern&eacute;es dans la
 104     configuration courante.</p>
 105
 106     <p>Il est possible d'afficher d'autres vues de la configuration en
 107     ajoutant un argument &agrave; la requ&ecirc;te <code>infos-serveur</code>. Par
 108     exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
 109     affichera toutes les directives de configuration.</p>
 110
 111     <dl>
 112         <dt><code>?&lt;module-name&gt;</code></dt>
 113             <dd>Uniquement les informations relatives au module
 114             sp&eacute;cifi&eacute;</dd>
 115         <dt><code>?config</code></dt>
 116             <dd>Uniquement les directives de configuration, non tri&eacute;es
 117             par module</dd>
 118         <dt><code>?hooks</code></dt>
 119             <dd>Uniquement la liste des branchements (hooks)
 120             auxquels le module est attach&eacute;</dd>
 121         <dt><code>?list</code></dt>
 122             <dd>Une simple liste des modules activ&eacute;s</dd>
 123         <dt><code>?server</code></dt>
 124             <dd>Uniquement des informations de base sur le serveur</dd>
 125     </dl>
 126 </section>
 127
 128 <section id="limitations"><title>Limitations connues</title>
 129     <p><module>mod_info</module> tire ses informations de
 130     la configuration interpr&eacute;t&eacute;e, et non du fichier de configuration
 131     original. La mani&egrave;re dont l'arbre de configuration interpr&eacute;t&eacute; est
 132     cr&eacute;&eacute; induit quelques limitations :</p>
 133     <ul>
 134       <li>Les directives qui sont trait&eacute;es imm&eacute;diatement sans &ecirc;tre
 135       enregistr&eacute;es dans l'arbre de configuration interpr&eacute;t&eacute; ne sont pas
 136       prises en compte. Celles-ci comprennent <directive
 137       module="core">ServerRoot</directive>, <directive
 138       module="mod_so">LoadModule</directive> et <directive
 139       module="mod_so">LoadFile</directive>.</li>
 140       <li>Les directives qui contr&ocirc;lent le fichier de configuration
 141       lui-m&ecirc;me, comme <directive module="core">Include</directive>,
 142       <directive module="core">&lt;IfModule&gt;</directive> et
 143       <directive module="core">&lt;IfDefine&gt;</directive> ne sont pas
 144       prises en compte, mais les directives de configuration incluses le
 145       sont.</li>
 146       <li>Les commentaires ne sont pas pris en compte (Ce qui peut &ecirc;tre
 147       consid&eacute;r&eacute; comme une fonctionnalit&eacute;).</li>
 148       <li>Les directives de configuration des fichiers
 149       <code>.htaccess</code> ne sont pas prises en compte (car elles ne
 150       font pas partie de la configuration permanente du serveur).</li>
 151       <li>Les directives de conteneur comme <directive
 152       module="core">&lt;Directory&gt;</directive> sont affich&eacute;es
 153       normalement, mais <module>mod_info</module> est incapable de
 154       d&eacute;terminer le num&eacute;ro de ligne de la balise fermante <directive
 155       module="core">&lt;/Directory&gt;</directive>.</li>
 156       <li>Les directives g&eacute;n&eacute;r&eacute;es par des modules tiers comme
 157       <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas &ecirc;tre
 158       prises en compte.</li>
 159     </ul>
 160 </section>
 161
 162 <directivesynopsis>
 163 <name>AddModuleInfo</name>
 164 <description>Ajoute des donn&eacute;es suppl&eacute;mentaires aux informations de
 165 module affich&eacute;es par le gestionnaire server-info</description>
 166 <syntax>AddModuleInfo <var>nom-module</var> <var>cha&icirc;ne</var></syntax>
 167 <contextlist><context>server config</context><context>virtual host</context>
 168 </contextlist>
 169
 170 <usage>
 171     <p>Cette directive permet d'afficher le contenu de <var>cha&icirc;ne</var>
 172     en tant qu'<strong>Information suppl&eacute;mentaire</strong> interpr&eacute;t&eacute;e
 173     en HTML pour le module <var>nom-module</var>. Exemple :</p>
 174
 175     <example>
 176       AddModuleInfo mod_deflate.c 'Voir &lt;a \<br />
 177       <indent>
 178         href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\<br />
 179         http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'
 180       </indent>
 181     </example>
 182 </usage>
 183
 184 </directivesynopsis>
 185 </modulesynopsis>