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: 1673892:1702012 (outdated) -->
   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     <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&eacute; d'utiliser <module>mod_authz_host</module> &agrave;
  45     l'int&eacute;rieur de la section <directive type="section"
  46     module="core">Location</directive> afin de restreindre l'acc&egrave;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&eacute;e, les informations du
  57     serveur sont disponibles &agrave; l'adresse
  58     <code>http://votre-serveur.com/infos-serveur</code>.</p>
  59 </summary>
  60
  61 <section id="security"><title>Probl&egrave;mes li&eacute;s &agrave; la s&eacute;curit&eacute;</title>
  62     <p>Une fois <module>mod_info</module> charg&eacute; dans le serveur, sa
  63     fonctionnalit&eacute; de gestionnaire est disponible dans <em>tous</em> les
  64     fichiers de configuration, y compris les fichiers de configuration
  65     des r&eacute;pertoires (par exemple <code>.htaccess</code>). Ceci peut
  66     avoir des r&eacute;percutions en mati&egrave;re de s&eacute;curit&eacute; pour votre site.</p>
  67
  68     <p>En particulier, l'utilisation de ce module peut conduire &agrave; la
  69     divulgation d'informations sensibles &agrave; partir des directives de
  70     configuration d'autres modules Apache comme des chemins syst&egrave;mes,
  71     des couples nom d'utilisateur/mot de passe, des noms de bases de
  72     donn&eacute;es, etc... C'est pourquoi ce module ne doit &ecirc;tre utilis&eacute;
  73     <strong>que</strong> dans un environnement sous contr&ocirc;le et toujours
  74     avec les plus grandes pr&eacute;cautions.</p>
  75
  76     <p>Il est recommand&eacute; d'utiliser <module>mod_authz_host</module> pour
  77     restreindre l'acc&egrave;s aux informations de configuration de votre
  78     serveur.</p>
  79
  80     <example><title>Contr&ocirc;le d'acc&egrave;s</title>
  81       <highlight language="config">
  82 &lt;Location "/server-info"&gt;
  83     SetHandler server-info
  84     Order allow,deny
  85     # Autorisation d'acc&egrave;s depuis le serveur lui-m&ecirc;me
  86     Allow from 127.0.0.1
  87     # Autorisation d'acc&egrave;s depuis une station de travail du r&eacute;seau
  88 # local
  89     Allow from 192.168.1.17
  90 &lt;/Location&gt;
  91       </highlight>
  92     </example>
  93 </section>
  94
  95 <section id="queries"><title>Filtrage des informations affich&eacute;es</title>
  96     <p>Par d&eacute;faut, les informations affich&eacute;es comprennent une liste de
  97     tous les modules activ&eacute;s, et pour chaque module, une description des
  98     directives qu'il accepte, les branchements (hooks) qu'il
  99     impl&eacute;mente, ainsi que les directives concern&eacute;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 &agrave; la requ&ecirc;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&eacute;cifi&eacute;</dd>
 111         <dt><code>?config</code></dt>
 112             <dd>Uniquement les directives de configuration, non tri&eacute;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&eacute;</dd>
 117         <dt><code>?list</code></dt>
 118             <dd>Une simple liste des modules activ&eacute;s</dd>
 119         <dt><code>?server</code></dt>
 120             <dd>Uniquement des informations de base sur le serveur</dd>
 121     </dl>
 122 </section>
 123
 124 <section id="startup"><title>Affichage de la configuration au d&eacute;marrage</title>
 125     <p>Si la directive de configuration define
 126     <code>-DDUMP_CONFIG</code> est utilis&eacute;e, <module>mod_info</module> va
 127     envoyer la configuration pr&eacute;interpr&eacute;t&eacute;e vers <code>stdout</code> au
 128     cours du d&eacute;marrage du serveur. "Pr&eacute;interpr&eacute;t&eacute;e" signifie que
 129     les directives telles que <directive type="section"
 130     module="core">IfDefine</directive> et <directive type="section"
 131     module="core">IfModule</directive> sont &eacute;valu&eacute;es et les variables
 132     d'environnement remplac&eacute;es par leurs valeurs. Cela ne repr&eacute;sente
 133     cependant pas la configuration d&eacute;finitive. En particulier, les
 134     fusions ou &eacute;crasementsde d&eacute;finitions en cas de directives multiples ne sont pas
 135     repr&eacute;sent&eacute;s.</p>
 136
 137     <p>Le r&eacute;sultat est &eacute;quivalent &agrave; celui de la requ&ecirc;te
 138     <code>?config</code>.</p>
 139
 140 </section>
 141
 142 <section id="limitations"><title>Limitations connues</title>
 143     <p><module>mod_info</module> tire ses informations de
 144     la configuration interpr&eacute;t&eacute;e, et non du fichier de configuration
 145     original. La mani&egrave;re dont l'arbre de configuration interpr&eacute;t&eacute; est
 146     cr&eacute;&eacute; induit quelques limitations :</p>
 147     <ul>
 148       <li>Les directives qui sont trait&eacute;es imm&eacute;diatement sans &ecirc;tre
 149       enregistr&eacute;es dans l'arbre de configuration interpr&eacute;t&eacute; ne sont pas
 150       prises en compte. Celles-ci comprennent <directive
 151       module="core">ServerRoot</directive>, <directive
 152       module="mod_so">LoadModule</directive> et <directive
 153       module="mod_so">LoadFile</directive>.</li>
 154       <li>Les directives qui contr&ocirc;lent le fichier de configuration
 155       lui-m&ecirc;me, comme <directive module="core">Include</directive>,
 156       <directive type="section" module="core">IfModule</directive> et
 157       <directive type="section" module="core">IfDefine</directive> ne
 158       sont pas prises en compte, mais les directives de configuration
 159       incluses le sont.</li>
 160       <li>Les commentaires ne sont pas pris en compte (Ce qui peut &ecirc;tre
 161       consid&eacute;r&eacute; comme une fonctionnalit&eacute;).</li>
 162       <li>Les directives de configuration des fichiers
 163       <code>.htaccess</code> ne sont pas prises en compte (car elles ne
 164       font pas partie de la configuration permanente du serveur).</li>
 165       <li>Les directives de conteneur comme <directive type="section"
 166       module="core">Directory</directive> sont affich&eacute;es
 167       normalement, mais <module>mod_info</module> est incapable de
 168       d&eacute;terminer le num&eacute;ro de ligne de la balise fermante
 169       <directive type="section" module="core"
 170       name="Directory">/Directory</directive>.</li>
 171       <li>Les directives g&eacute;n&eacute;r&eacute;es par des modules tiers comme
 172       <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas &ecirc;tre
 173       prises en compte.</li>
 174     </ul>
 175 </section>
 176
 177 <directivesynopsis>
 178 <name>AddModuleInfo</name>
 179 <description>Ajoute des donn&eacute;es suppl&eacute;mentaires aux informations de
 180 module affich&eacute;es par le gestionnaire server-info</description>
 181 <syntax>AddModuleInfo <var>nom-module</var> <var>cha&icirc;ne</var></syntax>
 182 <contextlist><context>server config</context><context>virtual host</context>
 183 </contextlist>
 184
 185 <usage>
 186     <p>Cette directive permet d'afficher le contenu de <var>cha&icirc;ne</var>
 187     en tant qu'<strong>Information suppl&eacute;mentaire</strong> interpr&eacute;t&eacute;e
 188     en HTML pour le module <var>nom-module</var>. Exemple :</p>
 189
 190     <highlight language="config">
 191 AddModuleInfo mod_deflate.c 'See &lt;a \
 192     href="http://httpd.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\
 193     http://httpd.apache.org/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'
 194     </highlight>
 195 </usage>
 196
 197 </directivesynopsis>
 198 </modulesynopsis>