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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_info - Serveur Apache HTTP</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  16 <p class="apache">Serveur Apache HTTP Version 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Module Apache mod_info</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../fr/mod/mod_info.html" title="Français">&nbsp;fr&nbsp;</a> |
  26 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  27 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  28 </div>
  29 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Affiche une présentation complète de la configuration du
  30 serveur</td></tr>
  31 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  32 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr>
  33 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table>
  34 <h3>Sommaire</h3>
  35
  36     <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes
  37     suivantes à votre fichier <code>httpd.conf</code>.</p>
  38
  39     <div class="example"><p><code>
  40       &lt;Location /infos-serveur&gt;<br />
  41       <span class="indent">
  42         SetHandler server-info<br />
  43       </span>
  44       &lt;/Location&gt;
  45     </code></p></div>
  46
  47     <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_access.html">mod_access</a></code> à
  48     l'intérieur de la section <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> afin de restreindre l'accès aux
  49     informations de configuration de votre serveur :</p>
  50
  51     <div class="example"><p><code>
  52       &lt;Location /infos-serveur&gt;<br />
  53       <span class="indent">
  54         SetHandler server-info<br />
  55         Require host example.com<br />
  56       </span>
  57       &lt;/Location&gt;
  58     </code></p></div>
  59
  60     <p>Une fois cette configuration effectuée, les informations du
  61     serveur sont disponibles à l'adresse
  62     <code>http://votre-serveur.com/infos-serveur</code>.</p>
  63 </div>
  64 <div id="quickview"><h3 class="directives">Directives</h3>
  65 <ul id="toc">
  66 <li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
  67 </ul>
  68 <h3>Sujets</h3>
  69 <ul id="topics">
  70 <li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li>
  71 <li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li>
  72 <li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</a></li>
  73 </ul></div>
  74 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  75 <div class="section">
  76 <h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2>
  77     <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa
  78     fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
  79     fichiers de configuration, y compris les fichiers de configuration
  80     des répertoires (par exemple <code>.htaccess</code>). Ceci peut
  81     avoir des répercutions en matière de sécurité pour votre site.</p>
  82
  83     <p>En particulier, l'utilisation de ce module peut conduire à la
  84     divulgation d'informations sensibles à partir des directives de
  85     configuration d'autres modules Apache comme des chemins systèmes,
  86     des couples nom d'utilisateur/mot de passe, des noms de bases de
  87     données, etc... C'est pourquoi ce module ne doit être utilisé
  88     <strong>que</strong> dans un environnement sous contrôle et toujours
  89     avec les plus grandes précautions.</p>
  90
  91     <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour
  92     restreindre l'accès aux informations de configuration de votre
  93     serveur.</p>
  94
  95     <div class="example"><h3>Contrôle d'accès</h3><p><code>
  96       &lt;Location /infos-serveur&gt;<br />
  97       <span class="indent">
  98         SetHandler server-info<br />
  99         Order allow,deny<br />
 100         # Autorisation d'accès depuis le serveur lui-même<br />
 101         Allow from 127.0.0.1<br />
 102         # Autorisation d'accès depuis une station de travail du réseau
 103         # local<br />
 104         Allow from 192.168.1.17<br />
 105       </span>
 106       &lt;/Location&gt;
 107     </code></p></div>
 108 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 109 <div class="section">
 110 <h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2>
 111     <p>Par défaut, les informations affichées comprennent une liste de
 112     tous les modules activés, et pour chaque module, une description des
 113     directives qu'il accepte, les branchements (hooks) qu'il
 114     implémente, ainsi que les directives concernées dans la
 115     configuration courante.</p>
 116
 117     <p>Il est possible d'afficher d'autres vues de la configuration en
 118     ajoutant un argument à la requête <code>infos-serveur</code>. Par
 119     exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
 120     affichera toutes les directives de configuration.</p>
 121
 122     <dl>
 123         <dt><code>?&lt;module-name&gt;</code></dt>
 124             <dd>Uniquement les informations relatives au module
 125             spécifié</dd>
 126         <dt><code>?config</code></dt>
 127             <dd>Uniquement les directives de configuration, non triées
 128             par module</dd>
 129         <dt><code>?hooks</code></dt>
 130             <dd>Uniquement la liste des branchements (hooks)
 131             auxquels le module est attaché</dd>
 132         <dt><code>?list</code></dt>
 133             <dd>Une simple liste des modules activés</dd>
 134         <dt><code>?server</code></dt>
 135             <dd>Uniquement des informations de base sur le serveur</dd>
 136     </dl>
 137 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 138 <div class="section">
 139 <h2><a name="limitations" id="limitations">Limitations connues</a></h2>
 140     <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> tire ses informations de
 141     la configuration interprétée, et non du fichier de configuration
 142     original. La manière dont l'arbre de configuration interprété est
 143     créé induit quelques limitations :</p>
 144     <ul>
 145       <li>Les directives qui sont traitées immédiatement sans être
 146       enregistrées dans l'arbre de configuration interprété ne sont pas
 147       prises en compte. Celles-ci comprennent <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> et <code class="directive"><a href="../mod/mod_so.html#loadfile">LoadFile</a></code>.</li>
 148       <li>Les directives qui contrôlent le fichier de configuration
 149       lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>,
 150       <code class="directive"><a href="../mod/core.html#&lt;ifmodule&gt;">&lt;IfModule&gt;</a></code> et
 151       <code class="directive"><a href="../mod/core.html#&lt;ifdefine&gt;">&lt;IfDefine&gt;</a></code> ne sont pas
 152       prises en compte, mais les directives de configuration incluses le
 153       sont.</li>
 154       <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
 155       considéré comme une fonctionnalité).</li>
 156       <li>Les directives de configuration des fichiers
 157       <code>.htaccess</code> ne sont pas prises en compte (car elles ne
 158       font pas partie de la configuration permanente du serveur).</li>
 159       <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#&lt;directory&gt;">&lt;Directory&gt;</a></code> sont affichées
 160       normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de
 161       déterminer le numéro de ligne de la balise fermante <code class="directive"><a href="../mod/core.html#&lt;/directory&gt;">&lt;/Directory&gt;</a></code>.</li>
 162       <li>Les directives générées par des modules tiers comme
 163       <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
 164       prises en compte.</li>
 165     </ul>
 166 </div>
 167 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 168 <div class="directive-section"><h2><a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2>
 169 <table class="directive">
 170 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de
 171 module affichées par le gestionnaire server-info</td></tr>
 172 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddModuleInfo <var>nom-module</var> <var>chaîne</var></code></td></tr>
 173 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 174 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 175 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
 176 </table>
 177     <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
 178     en tant qu'<strong>Information supplémentaire</strong> interprétée
 179     en HTML pour le module <var>nom-module</var>. Exemple :</p>
 180
 181     <div class="example"><p><code>
 182       AddModuleInfo mod_deflate.c 'Voir &lt;a \<br />
 183       <span class="indent">
 184         href="http://www.apache.org/docs/trunk/mod/mod_deflate.html"&gt;\<br />
 185         http://www.apache.org/docs/trunk/mod/mod_deflate.html&lt;/a&gt;'
 186       </span>
 187     </code></p></div>
 188
 189 </div>
 190 </div>
 191 <div class="bottomlang">
 192 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 193 <a href="../fr/mod/mod_info.html" title="Français">&nbsp;fr&nbsp;</a> |
 194 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 195 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 196 </div><div id="footer">
 197 <p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 198 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
 199 </body></html>