mod_info.xml.fr revision 0066eddda7203f6345b56f77d146a759298dc635
0066eddda7203f6345b56f77d146a759298dc635gryzor<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
0066eddda7203f6345b56f77d146a759298dc635gryzor<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
0066eddda7203f6345b56f77d146a759298dc635gryzor<!-- English Revision : 804977 -->
0066eddda7203f6345b56f77d146a759298dc635gryzor<!-- French translation : Lucien GENTIS -->
0066eddda7203f6345b56f77d146a759298dc635gryzor<!-- Reviewed by : Vincent Deffontaines -->
0066eddda7203f6345b56f77d146a759298dc635gryzor Licensed to the Apache Software Foundation (ASF) under one or more
0066eddda7203f6345b56f77d146a759298dc635gryzor contributor license agreements. See the NOTICE file distributed with
0066eddda7203f6345b56f77d146a759298dc635gryzor this work for additional information regarding copyright ownership.
0066eddda7203f6345b56f77d146a759298dc635gryzor The ASF licenses this file to You under the Apache License, Version 2.0
0066eddda7203f6345b56f77d146a759298dc635gryzor (the "License"); you may not use this file except in compliance with
0066eddda7203f6345b56f77d146a759298dc635gryzor the License. You may obtain a copy of the License at
0066eddda7203f6345b56f77d146a759298dc635gryzor Unless required by applicable law or agreed to in writing, software
0066eddda7203f6345b56f77d146a759298dc635gryzor distributed under the License is distributed on an "AS IS" BASIS,
0066eddda7203f6345b56f77d146a759298dc635gryzor WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0066eddda7203f6345b56f77d146a759298dc635gryzor See the License for the specific language governing permissions and
0066eddda7203f6345b56f77d146a759298dc635gryzor limitations under the License.
0066eddda7203f6345b56f77d146a759298dc635gryzor<description>Affiche une présentation complète de la configuration du
0066eddda7203f6345b56f77d146a759298dc635gryzorserveur</description>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Pour activer <module>mod_info</module>, ajoutez les lignes
0066eddda7203f6345b56f77d146a759298dc635gryzor suivantes à votre fichier <code>httpd.conf</code>.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <Location /infos-serveur><br />
0066eddda7203f6345b56f77d146a759298dc635gryzor SetHandler server-info<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor </Location>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Il est recommandé d'utiliser <module>mod_access</module> à
0066eddda7203f6345b56f77d146a759298dc635gryzor l'intérieur de la section <directive type="section"
0066eddda7203f6345b56f77d146a759298dc635gryzor module="core">Location</directive> afin de restreindre l'accès aux
0066eddda7203f6345b56f77d146a759298dc635gryzor informations de configuration de votre serveur :</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <Location /infos-serveur><br />
0066eddda7203f6345b56f77d146a759298dc635gryzor SetHandler server-info<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor Order deny,allow<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor Deny from all<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor </Location>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Une fois cette configuration effectuée, les informations du
0066eddda7203f6345b56f77d146a759298dc635gryzor serveur sont disponibles à l'adresse
0066eddda7203f6345b56f77d146a759298dc635gryzor <code>http://votre-serveur.com/infos-serveur</code>.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor<section id="security"><title>Problèmes liés à la sécurité</title>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Une fois <module>mod_info</module> chargé dans le serveur, sa
0066eddda7203f6345b56f77d146a759298dc635gryzor fonctionnalité de gestionnaire est disponible dans <em>tous</em> les
0066eddda7203f6345b56f77d146a759298dc635gryzor fichiers de configuration, y compris les fichiers de configuration
0066eddda7203f6345b56f77d146a759298dc635gryzor des répertoires (par exemple <code>.htaccess</code>). Ceci peut
0066eddda7203f6345b56f77d146a759298dc635gryzor avoir des répercutions en matière de sécurité pour votre site.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>En particulier, l'utilisation de ce module peut conduire à la
0066eddda7203f6345b56f77d146a759298dc635gryzor divulgation d'informations sensibles à partir des directives de
0066eddda7203f6345b56f77d146a759298dc635gryzor configuration d'autres modules Apache comme des chemins systèmes,
0066eddda7203f6345b56f77d146a759298dc635gryzor des couples nom d'utilisateur/mot de passe, des noms de bases de
0066eddda7203f6345b56f77d146a759298dc635gryzor données, etc... C'est pourquoi ce module ne doit être utilisé
0066eddda7203f6345b56f77d146a759298dc635gryzor <strong>que</strong> dans un environnement sous contrôle et toujours
0066eddda7203f6345b56f77d146a759298dc635gryzor avec les plus grandes précautions.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Il est recommandé d'utiliser <module>mod_authz_host</module> pour
0066eddda7203f6345b56f77d146a759298dc635gryzor restreindre l'accès aux informations de configuration de votre
0066eddda7203f6345b56f77d146a759298dc635gryzor serveur.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <example><title>Contrôle d'accès</title>
0066eddda7203f6345b56f77d146a759298dc635gryzor <Location /infos-serveur><br />
0066eddda7203f6345b56f77d146a759298dc635gryzor SetHandler server-info<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor Order allow,deny<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor # Autorisation d'accès depuis le serveur lui-même<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor Allow from 127.0.0.1<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor # Autorisation d'accès depuis une station de travail du réseau
0066eddda7203f6345b56f77d146a759298dc635gryzor # local<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor Allow from 192.168.1.17<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor </Location>
0066eddda7203f6345b56f77d146a759298dc635gryzor<section id="queries"><title>Filtrage des informations affichées</title>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Par défaut, les informations affichées comprennent une liste de
0066eddda7203f6345b56f77d146a759298dc635gryzor tous les modules activés, et pour chaque module, une description des
0066eddda7203f6345b56f77d146a759298dc635gryzor directives qu'il accepte, les branchements (hooks) qu'il
0066eddda7203f6345b56f77d146a759298dc635gryzor implémente, ainsi que les directives concernées dans la
0066eddda7203f6345b56f77d146a759298dc635gryzor configuration courante.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Il est possible d'afficher d'autres vues de la configuration en
0066eddda7203f6345b56f77d146a759298dc635gryzor ajoutant un argument à la requête <code>infos-serveur</code>. Par
0066eddda7203f6345b56f77d146a759298dc635gryzor exemple, <code>http://votre-serveur.com/infos-serveur?config</code>
0066eddda7203f6345b56f77d146a759298dc635gryzor affichera toutes les directives de configuration.</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <dd>Uniquement les informations relatives au module
0066eddda7203f6345b56f77d146a759298dc635gryzor spécifié</dd>
0066eddda7203f6345b56f77d146a759298dc635gryzor <dd>Uniquement les directives de configuration, non triées
0066eddda7203f6345b56f77d146a759298dc635gryzor par module</dd>
0066eddda7203f6345b56f77d146a759298dc635gryzor <dd>Uniquement la liste des branchements (hooks)
0066eddda7203f6345b56f77d146a759298dc635gryzor auxquels le module est attaché</dd>
0066eddda7203f6345b56f77d146a759298dc635gryzor <dd>Uniquement des informations de base sur le serveur</dd>
0066eddda7203f6345b56f77d146a759298dc635gryzor<section id="limitations"><title>Limitations connues</title>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p><module>mod_info</module> tire ses informations de
0066eddda7203f6345b56f77d146a759298dc635gryzor la configuration interprétée, et non du fichier de configuration
0066eddda7203f6345b56f77d146a759298dc635gryzor original. La manière dont l'arbre de configuration interprété est
0066eddda7203f6345b56f77d146a759298dc635gryzor créé induit quelques limitations :</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>Les directives qui sont traitées immédiatement sans être
0066eddda7203f6345b56f77d146a759298dc635gryzor enregistrées dans l'arbre de configuration interprété ne sont pas
0066eddda7203f6345b56f77d146a759298dc635gryzor prises en compte. Celles-ci comprennent <directive
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>Les directives qui contrôlent le fichier de configuration
0066eddda7203f6345b56f77d146a759298dc635gryzor lui-même, comme <directive module="core">Include</directive>,
0066eddda7203f6345b56f77d146a759298dc635gryzor <directive module="core"><IfModule></directive> et
0066eddda7203f6345b56f77d146a759298dc635gryzor <directive module="core"><IfDefine></directive> ne sont pas
0066eddda7203f6345b56f77d146a759298dc635gryzor prises en compte, mais les directives de configuration incluses le
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>Les commentaires ne sont pas pris en compte (Ce qui peut être
0066eddda7203f6345b56f77d146a759298dc635gryzor considéré comme une fonctionnalité).</li>
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>Les directives de configuration des fichiers
0066eddda7203f6345b56f77d146a759298dc635gryzor <code>.htaccess</code> ne sont pas prises en compte (car elles ne
0066eddda7203f6345b56f77d146a759298dc635gryzor font pas partie de la configuration permanente du serveur).</li>
0066eddda7203f6345b56f77d146a759298dc635gryzor module="core"><Directory></directive> sont affichées
0066eddda7203f6345b56f77d146a759298dc635gryzor normalement, mais <module>mod_info</module> est incapable de
0066eddda7203f6345b56f77d146a759298dc635gryzor déterminer le numéro de ligne de la balise fermante <directive
0066eddda7203f6345b56f77d146a759298dc635gryzor <li>Les directives générées par des modules tiers comme
0066eddda7203f6345b56f77d146a759298dc635gryzor <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être
0066eddda7203f6345b56f77d146a759298dc635gryzor prises en compte.</li>
0066eddda7203f6345b56f77d146a759298dc635gryzor<directivesynopsis>
0066eddda7203f6345b56f77d146a759298dc635gryzor<description>Ajoute des données supplémentaires aux informations de
0066eddda7203f6345b56f77d146a759298dc635gryzormodule affichées par le gestionnaire server-info</description>
0066eddda7203f6345b56f77d146a759298dc635gryzor<syntax>AddModuleInfo <var>nom-module</var> <var>chaîne</var></syntax>
0066eddda7203f6345b56f77d146a759298dc635gryzor<contextlist><context>server config</context><context>virtual host</context>
0066eddda7203f6345b56f77d146a759298dc635gryzor</contextlist>
0066eddda7203f6345b56f77d146a759298dc635gryzor<compatibility>Disponible depuis la version 1.3 d'Apache</compatibility>
0066eddda7203f6345b56f77d146a759298dc635gryzor <p>Cette directive permet d'afficher le contenu de <var>chaîne</var>
0066eddda7203f6345b56f77d146a759298dc635gryzor en tant qu'<strong>Information supplémentaire</strong> interprétée
0066eddda7203f6345b56f77d146a759298dc635gryzor en HTML pour le module <var>nom-module</var>. Exemple :</p>
0066eddda7203f6345b56f77d146a759298dc635gryzor href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html">\<br />
0066eddda7203f6345b56f77d146a759298dc635gryzor http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html</a>'
0066eddda7203f6345b56f77d146a759298dc635gryzor</directivesynopsis>
0066eddda7203f6345b56f77d146a759298dc635gryzor</modulesynopsis>