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