221N/A<?xml version="1.0"?>

221N/A<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

221N/A<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>

221N/A

221N/A

221N/A<modulesynopsis metafile="mod_info.xml.meta">

221N/A

221N/A<name>mod_info</name>

221N/A<description>Affiche une pr&eacute;sentation compl&egrave;te de la configuration du

221N/Aserveur</description>

221N/A<status>Extension</status>

221N/A<sourcefile>mod_info.c</sourcefile>

221N/A<identifier>info_module</identifier>

221N/A

221N/A<summary>

221N/A <p>Pour activer <module>mod_info</module>, ajoutez les lignes

221N/A suivantes &agrave; votre fichier <code>httpd.conf</code>.</p>

221N/A

221N/A <highlight language="config">

221N/A&lt;Location /server-info&gt;

221N/A SetHandler server-info

221N/A&lt;/Location&gt;

221N/A </highlight>

221N/A

221N/A <p>Il est recommand&eacute; d'utiliser <module>mod_access</module> &agrave;

221N/A l'int&eacute;rieur de la section <directive type="section"

221N/A module="core">Location</directive> afin de restreindre l'acc&egrave;s aux

221N/A informations de configuration de votre serveur :</p>

221N/A

<highlight language="config">

&lt;Location /server-info&gt;

SetHandler server-info

Require host example.com

&lt;/Location&gt;

</highlight>

<p>Une fois cette configuration effectu&eacute;e, les informations du

serveur sont disponibles &agrave; l'adresse

<code>http://votre-serveur.com/infos-serveur</code>.</p>

</summary>

<section id="security"><title>Probl&egrave;mes li&eacute;s &agrave; la s&eacute;curit&eacute;</title>

<p>Une fois <module>mod_info</module> charg&eacute; dans le serveur, sa

fonctionnalit&eacute; de gestionnaire est disponible dans <em>tous</em> les

fichiers de configuration, y compris les fichiers de configuration

des r&eacute;pertoires (par exemple <code>.htaccess</code>). Ceci peut

avoir des r&eacute;percutions en mati&egrave;re de s&eacute;curit&eacute; pour votre site.</p>

<p>En particulier, l'utilisation de ce module peut conduire &agrave; la

divulgation d'informations sensibles &agrave; partir des directives de

configuration d'autres modules Apache comme des chemins syst&egrave;mes,

des couples nom d'utilisateur/mot de passe, des noms de bases de

donn&eacute;es, etc... C'est pourquoi ce module ne doit &ecirc;tre utilis&eacute;

<strong>que</strong> dans un environnement sous contr&ocirc;le et toujours

avec les plus grandes pr&eacute;cautions.</p>

<p>Il est recommand&eacute; d'utiliser <module>mod_authz_host</module> pour

restreindre l'acc&egrave;s aux informations de configuration de votre

serveur.</p>

<example><title>Contr&ocirc;le d'acc&egrave;s</title>

<highlight language="config">

&lt;Location /server-info&gt;

SetHandler server-info

Order allow,deny

# Autorisation d'acc&egrave;s depuis le serveur lui-m&ecirc;me

Allow from 127.0.0.1

# Autorisation d'acc&egrave;s depuis une station de travail du r&eacute;seau

# local

Allow from 192.168.1.17

&lt;/Location&gt;

</highlight>

</example>

</section>

<section id="queries"><title>Filtrage des informations affich&eacute;es</title>

<p>Par d&eacute;faut, les informations affich&eacute;es comprennent une liste de

tous les modules activ&eacute;s, et pour chaque module, une description des

directives qu'il accepte, les branchements (hooks) qu'il

impl&eacute;mente, ainsi que les directives concern&eacute;es dans la

configuration courante.</p>

<p>Il est possible d'afficher d'autres vues de la configuration en

ajoutant un argument &agrave; la requ&ecirc;te <code>infos-serveur</code>. Par

exemple, <code>http://votre-serveur.com/infos-serveur?config</code>

affichera toutes les directives de configuration.</p>

<dl>

<dt><code>?&lt;module-name&gt;</code></dt>

<dd>Uniquement les informations relatives au module

sp&eacute;cifi&eacute;</dd>

<dt><code>?config</code></dt>

<dd>Uniquement les directives de configuration, non tri&eacute;es

par module</dd>

<dt><code>?hooks</code></dt>

<dd>Uniquement la liste des branchements (hooks)

auxquels le module est attach&eacute;</dd>

<dt><code>?list</code></dt>

<dd>Une simple liste des modules activ&eacute;s</dd>

<dt><code>?server</code></dt>

<dd>Uniquement des informations de base sur le serveur</dd>

</dl>

</section>

<section id="startup"><title>Affichage de la configuration au d&eacute;marrage</title>

<p>Si la directive de configuration define

<code>-DDUMP_CONFIG</code> est utilis&eacute;e, <module>mod_info</module> va

envoyer la configuration pr&eacute;interpr&eacute;t&eacute;e vers <code>stdout</code> au

cours du d&eacute;marrage du serveur. "Pr&eacute;interpr&eacute;t&eacute;e" signifie que

les directives telles que <directive type="section"

module="core">IfDefine</directive> et <directive type="section"

module="core">IfModule</directive> sont &eacute;valu&eacute;es et les variables

d'environnement remplac&eacute;es par leurs valeurs. Cela ne repr&eacute;sente

cependant pas la configuration d&eacute;finitive. En particulier, les

fusions ou &eacute;crasementsde d&eacute;finitions en cas de directives multiples ne sont pas

repr&eacute;sent&eacute;s.</p>

<p>Le r&eacute;sultat est &eacute;quivalent &agrave; celui de la requ&ecirc;te

<code>?config</code>.</p>

</section>

<section id="limitations"><title>Limitations connues</title>

<p><module>mod_info</module> tire ses informations de

la configuration interpr&eacute;t&eacute;e, et non du fichier de configuration

original. La mani&egrave;re dont l'arbre de configuration interpr&eacute;t&eacute; est

cr&eacute;&eacute; induit quelques limitations :</p>

<ul>

<li>Les directives qui sont trait&eacute;es imm&eacute;diatement sans &ecirc;tre

enregistr&eacute;es dans l'arbre de configuration interpr&eacute;t&eacute; ne sont pas

prises en compte. Celles-ci comprennent <directive

module="core">ServerRoot</directive>, <directive

module="mod_so">LoadModule</directive> et <directive

module="mod_so">LoadFile</directive>.</li>

<li>Les directives qui contr&ocirc;lent le fichier de configuration

lui-m&ecirc;me, comme <directive module="core">Include</directive>,

<directive module="core">&lt;IfModule&gt;</directive> et

<directive module="core">&lt;IfDefine&gt;</directive> ne sont pas

prises en compte, mais les directives de configuration incluses le

sont.</li>

<li>Les commentaires ne sont pas pris en compte (Ce qui peut &ecirc;tre

consid&eacute;r&eacute; comme une fonctionnalit&eacute;).</li>

<li>Les directives de configuration des fichiers

<code>.htaccess</code> ne sont pas prises en compte (car elles ne

font pas partie de la configuration permanente du serveur).</li>

<li>Les directives de conteneur comme <directive

module="core">&lt;Directory&gt;</directive> sont affich&eacute;es

normalement, mais <module>mod_info</module> est incapable de

d&eacute;terminer le num&eacute;ro de ligne de la balise fermante <directive

module="core">&lt;/Directory&gt;</directive>.</li>

<li>Les directives g&eacute;n&eacute;r&eacute;es par des modules tiers comme

<a href="http://perl.apache.org">mod_perl</a> peuvent ne pas &ecirc;tre

prises en compte.</li>

</ul>

</section>

<directivesynopsis>

<name>AddModuleInfo</name>

<description>Ajoute des donn&eacute;es suppl&eacute;mentaires aux informations de

module affich&eacute;es par le gestionnaire server-info</description>

<syntax>AddModuleInfo <var>nom-module</var> <var>cha&icirc;ne</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

</contextlist>

<usage>

<p>Cette directive permet d'afficher le contenu de <var>cha&icirc;ne</var>

en tant qu'<strong>Information suppl&eacute;mentaire</strong> interpr&eacute;t&eacute;e

en HTML pour le module <var>nom-module</var>. Exemple :</p>

<highlight language="config">

AddModuleInfo mod_deflate.c 'See &lt;a \

href="http://httpd.apache.org/docs/&httpd.docs;/mod/mod_deflate.html"&gt;\

http://httpd.apache.org/docs/&httpd.docs;/mod/mod_deflate.html&lt;/a&gt;'

</highlight>

</usage>

</directivesynopsis>

</modulesynopsis>