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 Version 2.5</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" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  12 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body>
  17 <div id="page-header">
  18 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  19 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  20 <img alt="" src="../images/feather.gif" /></div>
  21 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  22 <div id="path">
  23 <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.5</a> &gt; <a href="./">Modules</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Module Apache mod_info</h1>
  26 <div class="toplang">
  27 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../fr/mod/mod_info.html" title="Français">&nbsp;fr&nbsp;</a> |
  29 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  30 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  31 </div>
  32 <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
  33 serveur</td></tr>
  34 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  35 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>info_module</td></tr>
  36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table>
  37 <h3>Sommaire</h3>
  38
  39     <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes
  40     suivantes à votre fichier <code>httpd.conf</code>.</p>
  41
  42     <pre class="prettyprint lang-config">&lt;Location /server-info&gt;
  43     SetHandler server-info
  44 &lt;/Location&gt;</pre>
  45
  46
  47     <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</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     <pre class="prettyprint lang-config">&lt;Location /server-info&gt;
  52     SetHandler server-info
  53     Require host example.com
  54 &lt;/Location&gt;</pre>
  55
  56
  57     <p>Une fois cette configuration effectuée, les informations du
  58     serveur sont disponibles à l'adresse
  59     <code>http://votre-serveur.com/infos-serveur</code>.</p>
  60 </div>
  61 <div id="quickview"><h3 class="directives">Directives</h3>
  62 <ul id="toc">
  63 <li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li>
  64 </ul>
  65 <h3>Sujets</h3>
  66 <ul id="topics">
  67 <li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li>
  68 <li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li>
  69 <li><img alt="" src="../images/down.gif" /> <a href="#startup">Affichage de la configuration au démarrage</a></li>
  70 <li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</a></li>
  71 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  72 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  73 <div class="section">
  74 <h2><a name="security" id="security">Problèmes liés à la sécurité</a></h2>
  75     <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa
  76     fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
  77     fichiers de configuration, y compris les fichiers de configuration
  78     des répertoires (par exemple <code>.htaccess</code>). Ceci peut
  79     avoir des répercutions en matière de sécurité pour votre site.</p>
  80
  81     <p>En particulier, l'utilisation de ce module peut conduire à la
  82     divulgation d'informations sensibles à partir des directives de
  83     configuration d'autres modules Apache comme des chemins systèmes,
  84     des couples nom d'utilisateur/mot de passe, des noms de bases de
  85     données, etc... C'est pourquoi ce module ne doit être utilisé
  86     <strong>que</strong> dans un environnement sous contrôle et toujours
  87     avec les plus grandes précautions.</p>
  88
  89     <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour
  90     restreindre l'accès aux informations de configuration de votre
  91     serveur.</p>
  92
  93     <div class="example"><h3>Contrôle d'accès</h3><pre class="prettyprint lang-config">&lt;Location /server-info&gt;
  94     SetHandler server-info
  95     Order allow,deny
  96     # Autorisation d'accès depuis le serveur lui-même
  97     Allow from 127.0.0.1
  98     # Autorisation d'accès depuis une station de travail du réseau
  99 # local
 100     Allow from 192.168.1.17
 101 &lt;/Location&gt;</pre>
 102 </div>
 103 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 104 <div class="section">
 105 <h2><a name="queries" id="queries">Filtrage des informations affichées</a></h2>
 106     <p>Par défaut, les informations affichées comprennent une liste de
 107     tous les modules activés, et pour chaque module, une description des
 108     directives qu'il accepte, les branchements (hooks) qu'il
 109     implémente, ainsi que les directives concernées dans la
 110     configuration courante.</p>
 111
 112     <p>Il est possible d'afficher d'autres vues de la configuration en
 113     ajoutant un argument à la requête <code>infos-serveur</code>. Par
 114     exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
 115     affichera toutes les directives de configuration.</p>
 116
 117     <dl>
 118         <dt><code>?&lt;module-name&gt;</code></dt>
 119             <dd>Uniquement les informations relatives au module
 120             spécifié</dd>
 121         <dt><code>?config</code></dt>
 122             <dd>Uniquement les directives de configuration, non triées
 123             par module</dd>
 124         <dt><code>?hooks</code></dt>
 125             <dd>Uniquement la liste des branchements (hooks)
 126             auxquels le module est attaché</dd>
 127         <dt><code>?list</code></dt>
 128             <dd>Une simple liste des modules activés</dd>
 129         <dt><code>?server</code></dt>
 130             <dd>Uniquement des informations de base sur le serveur</dd>
 131     </dl>
 132 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 133 <div class="section">
 134 <h2><a name="startup" id="startup">Affichage de la configuration au démarrage</a></h2>
 135     <p>Si la directive de configuration define
 136     <code>-DDUMP_CONFIG</code> est utilisée, <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> va
 137     envoyer la configuration préinterprétée vers <code>stdout</code> au
 138     cours du démarrage du serveur. "Préinterprétée" signifie que
 139     les directives telles que <code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> 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 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 149 <div class="section">
 150 <h2><a name="limitations" id="limitations">Limitations connues</a></h2>
 151     <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> 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 <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>
 159       <li>Les directives qui contrôlent le fichier de configuration
 160       lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>,
 161       <code class="directive"><a href="../mod/core.html#ifmodule">&lt;IfModule&gt;</a></code> et
 162       <code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> ne
 163       sont pas prises en compte, mais les directives de configuration
 164       incluses le sont.</li>
 165       <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
 166       considéré comme une fonctionnalité).</li>
 167       <li>Les directives de configuration des fichiers
 168       <code>.htaccess</code> ne sont pas prises en compte (car elles ne
 169       font pas partie de la configuration permanente du serveur).</li>
 170       <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> sont affichées
 171       normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de
 172       déterminer le numéro de ligne de la balise fermante
 173       <code class="directive"><a href="../mod/core.html#directory">&lt;/Directory&gt;</a></code>.</li>
 174       <li>Les directives générées par des modules tiers comme
 175       <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
 176       prises en compte.</li>
 177     </ul>
 178 </div>
 179 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 180 <div class="directive-section"><h2><a name="addmoduleinfo" id="addmoduleinfo">Directive</a> <a name="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a></h2>
 181 <table class="directive">
 182 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de
 183 module affichées par le gestionnaire server-info</td></tr>
 184 <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>
 185 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 186 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 187 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_info</td></tr>
 188 </table>
 189     <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
 190     en tant qu'<strong>Information supplémentaire</strong> interprétée
 191     en HTML pour le module <var>nom-module</var>. Exemple :</p>
 192
 193     <pre class="prettyprint lang-config">AddModuleInfo mod_deflate.c 'See &lt;a \
 194     href="http://httpd.apache.org/docs/trunk/mod/mod_deflate.html"&gt;\
 195     http://httpd.apache.org/docs/trunk/mod/mod_deflate.html&lt;/a&gt;'</pre>
 196
 197
 198 </div>
 199 </div>
 200 <div class="bottomlang">
 201 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 202 <a href="../fr/mod/mod_info.html" title="Français">&nbsp;fr&nbsp;</a> |
 203 <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 204 <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 205 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 206 <script type="text/javascript"><!--//--><![CDATA[//><!--
 207 var comments_shortname = 'httpd';
 208 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_info.html';
 209 (function(w, d) {
 210     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 211         d.write('<div id="comments_thread"><\/div>');
 212         var s = d.createElement('script');
 213         s.type = 'text/javascript';
 214         s.async = true;
 215         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 216         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 217     }
 218     else {
 219         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 220     }
 221 })(window, document);
 222 //--><!]]></script></div><div id="footer">
 223 <p class="apache">Copyright 2015 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 224 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 225 if (typeof(prettyPrint) !== 'undefined') {
 226     prettyPrint();
 227 }
 228 //--><!]]></script>
 229 </body></html>