mod_info.xml.fr revision b1e8a4a1a94094f54da1200b4559b709b07ab00d
0066eddda7203f6345b56f77d146a759298dc635gryzor<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
0066eddda7203f6345b56f77d146a759298dc635gryzor<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis<!-- English Revision : 1343935 -->
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>
e2f05529a1835546e17527f56074c023e6a47366lgentis<Location /server-info>
e2f05529a1835546e17527f56074c023e6a47366lgentis SetHandler server-info
e2f05529a1835546e17527f56074c023e6a47366lgentis</Location>
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
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>
e2f05529a1835546e17527f56074c023e6a47366lgentis<Location /server-info>
e2f05529a1835546e17527f56074c023e6a47366lgentis SetHandler server-info
e2f05529a1835546e17527f56074c023e6a47366lgentis</Location>
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
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>
e2f05529a1835546e17527f56074c023e6a47366lgentis<Location /server-info>
e2f05529a1835546e17527f56074c023e6a47366lgentis SetHandler server-info
e2f05529a1835546e17527f56074c023e6a47366lgentis Order allow,deny
e2f05529a1835546e17527f56074c023e6a47366lgentis # Autorisation d'accès depuis le serveur lui-même
e2f05529a1835546e17527f56074c023e6a47366lgentis Allow from 127.0.0.1
e2f05529a1835546e17527f56074c023e6a47366lgentis # Autorisation d'accès depuis une station de travail du réseau
e2f05529a1835546e17527f56074c023e6a47366lgentis Allow from 192.168.1.17
e2f05529a1835546e17527f56074c023e6a47366lgentis</Location>
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
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>
8194a1b0db760af7e588c1bad92a1d933d39886elgentis<section id="startup"><title>Affichage de la configuration au démarrage</title>
8194a1b0db760af7e588c1bad92a1d933d39886elgentis <p>Si la directive de configuration define
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis <code>-DDUMP_CONFIG</code> est utilisée, <module>mod_info</module> va
8194a1b0db760af7e588c1bad92a1d933d39886elgentis envoyer la configuration préinterprétée vers <code>stdout</code> au
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis cours du démarrage du serveur. "Préinterprétée" signifie que
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis module="core">IfDefine</directive> et <directive type="section"
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis module="core">IfModule</directive> sont évaluées et les variables
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis d'environnement remplacées par leurs valeurs. Cela ne représente
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis cependant pas la configuration définitive. En particulier, les
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis fusions ou écrasementsde définitions en cas de directives multiples ne sont pas
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis représentés.</p>
b1e8a4a1a94094f54da1200b4559b709b07ab00dlgentis <p>Le résultat est équivalent à celui de la requête
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 <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>
e2f05529a1835546e17527f56074c023e6a47366lgentisAddModuleInfo mod_deflate.c 'See <a \
e2f05529a1835546e17527f56074c023e6a47366lgentis href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html">\
e2f05529a1835546e17527f56074c023e6a47366lgentis http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html</a>'
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
0066eddda7203f6345b56f77d146a759298dc635gryzor</directivesynopsis>
0066eddda7203f6345b56f77d146a759298dc635gryzor</modulesynopsis>