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