2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision: 1673582 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <modulesynopsis metafile="mod_dav.xml.meta">
28 <description>Fonctionnalité de création et gestion de versions de
29 documents via le web (<a
30 href="http://www.webdav.org/">WebDAV</a>)</description>
31 <status>Extension</status>
32 <sourcefile>mod_dav.c</sourcefile>
33 <identifier>dav_module</identifier>
36 <p>Ce module ajoute à Apache une fonctionnalité <a
37 href="http://www.webdav.org">WebDAV</a> de classes 1 et 2
38 ('Web-based Distributed Authoring and Versioning' ou Création et
39 gestion de versions de documents via le web). Il s'agit d'une
40 extension du protocole HTTP qui permet de créer, déplacer, copier et
41 supprimer des ressources ou collections de ressources sur un serveur
44 <seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso>
45 <seealso><directive module="core">LimitXMLRequestBody</directive></seealso>
46 <seealso><a href="http://www.webdav.org">Ressources WebDAV</a></seealso>
48 <section id="example"><title>Activation de WebDAV</title>
49 <p>Pour activer le module <module>mod_dav</module>, ajoutez la ligne
50 suivante à un conteneur de votre fichier <code>httpd.conf</code>
53 <highlight language="config">Dav On</highlight>
55 <p>Ceci active le fournisseur de système de fichier DAV implémenté par
56 le module <module>mod_dav_fs</module>. Ce dernier doit donc être
57 compilé dans le serveur ou chargé au démarrage à l'aide de la
58 directive <directive module="mod_so">LoadModule</directive>.</p>
60 <p>En outre, vous devez indiquer où se trouve la base de données des
61 verrous DAV via une directive <directive
62 module="mod_dav_fs">DavLockDB</directive> dans la section globale de
63 votre fichier <code>httpd.conf</code> :</p>
65 <highlight language="config">
66 DavLockDB "/usr/local/apache2/var/DavLock"
69 <p>Le répertoire contenant le fichier de la base de données des
70 verrous doit avoir des droits en écriture pour l'utilisateur et le
71 groupe sous lesquels Apache s'exécute et définis respectivement par
72 les directives <directive module="mod_unixd">User</directive> et
73 <directive module="mod_unixd">Group</directive>.</p>
75 <p>Si vous souhaitez limiter l'accès aux répertoires où DAV est
76 activé, vous pouvez ajouter une clause <directive module="core"
77 type="section">Limit</directive> dans la section <directive
78 module="core" type="section">Location</directive> considérée. Pour
79 définir la quantité maximale de données en octets qu'un client
80 DAV peut envoyer par requête, vous devez utiliser la directive
81 <directive module="core">LimitXMLRequestBody</directive>, car La
82 directive <directive module="core">LimitRequestBody</directive>
83 "habituelle" n'a aucune incidence sur les requêtes DAV.</p>
85 <example><title>Exemple complet</title>
86 <highlight language="config">
87 DavLockDB "/usr/local/apache2/var/DavLock"
89 <Directory "/usr/local/apache2/htdocs/foo">
95 AuthUserFile "user.passwd"
97 <LimitExcept GET POST OPTIONS>
106 <section id="security"><title>Problèmes concernant la sécurité</title>
108 <p>Etant donné que les méthodes d'accès DAV permettent à des clients
109 distants de manipuler des fichiers sur le serveur, vous devez vous
110 assurer que votre serveur est bien sécurisé avant d'activer
111 <module>mod_dav</module>.</p>
113 <p>Tout répertoire du serveur où DAV est activé doit être protégé
114 par une procédure d'authentification. L'utilisation de
115 l'authentification HTTP de base n'est pas recommandée. Vous devez
116 utiliser au moins l'authentification HTTP à base de condensés
117 qu'implémente le module <module>mod_auth_digest</module>.
118 Pratiquement tous les clients WebDAV supportent cette méthode
119 d'authentification. Vous pouvez aussi utiliser l'authentification de
120 base sur une connexion où <a href="../ssl/">SSL</a> est activé.</p>
122 <p>Pour que <module>mod_dav</module> puisse manipuler des fichiers,
123 il doit avoir des permissions en écriture sur les répertoires et les
124 fichiers qui sont sous son contrôle ; en d'autre termes, c'est
125 l'utilisateur et le groupe sous lesquels Apache s'exécute et définis
126 par les directives <directive module="mod_unixd">User</directive> et
127 <directive module="mod_unixd">Group</directive> qui doivent avoir
128 les droits en écriture sur ces fichiers et répertoires. Les fichiers
129 nouvellement créés appartiendront aussi à ces utilisateur et groupe.
130 Par conséquent, il est important de contrôler l'accès à ce compte.
131 Les répertoires DAV sont considérés comme privés du point de vue
132 d'Apache, et la modification des fichiers qu'ils contiennent
133 autrement que par l'intermédiaire d'Apache (par exemple par FTP ou
134 par des outils du niveau du système de fichiers) ne doit pas être
137 <p><module>mod_dav</module> peut faire l'objet de plusieurs sortes
138 d'attaques par déni de service. La directive <directive
139 module="core">LimitXMLRequestBody</directive> permet de limiter la
140 quantité de mémoire consommée pour interpréter des requêtes DAV de
141 grande taille. En outre, la directive <directive
142 module="mod_dav">DavDepthInfinity</directive> permet d'empêcher les
143 requêtes <code>PROPFIND</code> concernant un répertoire de très
144 grande taille de consommer de grandes quantités de mémoire. Un autre
145 type d'attaque par déni de service peut aussi être mené par un
146 client qui remplit simplement tout l'espace disque disponible avec
147 des fichiers de très grande taille. Etant donné qu'il n'existe aucun
148 moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez
149 accorder des accès DAV qu'à des utilisateurs de confiance.</p>
152 <section id="complex"><title>Configurations complexes</title>
154 <p>Les requêtes ayant pour but de manipuler des fichiers dynamiques
155 (scripts PHP, scripts CGI, etc...) en utilisant
156 <module>mod_dav</module> sont courantes. Ce traitement n'est pas
157 évident car une requête
158 <code>GET</code> va toujours tenter d'exécuter le script, plutôt que
159 de télécharger son contenu. Pour éviter cet inconvénient, une
160 méthode possible consiste à faire correspondre deux URLs
161 différentes au même contenu, l'une d'entre elles servant à lancer le
162 script, alors que l'autre peut être utilisée pour le télécharger et
163 le manipuler avec DAV.</p>
165 <highlight language="config">
166 Alias "/phparea" "/home/gstein/php_files"
167 Alias "/php-source" "/home/gstein/php_files"
168 <Location "/php-source">
174 <p>Avec cette configuration, on peut utiliser
175 <code>http://example.com/phparea</code> pour afficher le résultat de
176 l'exécution des scripts PHP, et
177 <code>http://example.com/php-source</code> pour les manipuler avec
183 <description>Active les méthodes HTTP WebDAV</description>
184 <syntax>Dav On|Off|<var>nom fournisseur</var></syntax>
185 <default>Dav Off</default>
186 <contextlist><context>directory</context></contextlist>
189 <p>La directive <directive>Dav</directive> active les
190 méthodes HTTP WebDAV pour le conteneur condidéré :</p>
192 <highlight language="config">
193 <Location "/foo">
198 <p>La valeur <code>On</code> est en fait un alias vers le
199 fournisseur par défaut <code>filesystem</code> implémenté par le
200 module <module>mod_dav_fs</module>. Notez que lorsque DAV est activé
201 pour un conteneur, on <em>ne peut pas</em> le désactiver pour ses
202 sous-conteneurs. Pour un exemple de configuration complet,
203 reportez-vous à la <a href="#example">section précédente</a>.</p>
205 <note type="warning">
206 N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si
207 vous passez outre cette recommandation, tout le monde pourra
208 enregistrer des fichiers sur votre système.
214 <name>DavMinTimeout</name>
215 <description>Durée minimale pendant laquelle le serveur maintient un
216 verrou sur une ressource DAV</description>
217 <syntax>DavMinTimeout <var>secondes</var></syntax>
218 <default>DavMinTimeout 0</default>
219 <contextlist><context>server config</context><context>virtual host</context>
220 <context>directory</context></contextlist>
223 <p>Lorsqu'un client demande le verrouillage d'une ressource DAV, il
224 peut aussi spécifier une durée au bout de laquelle le verrou sera
225 automatiquement supprimé par le serveur. Cette valeur ne constitue
226 qu'une requête, et le serveur peut l'ignorer ou informer le client
227 qu'il va utiliser une valeur arbitraire.</p>
229 <p>La directive <directive>DavMinTimeout</directive>
230 spécifie, en secondes, la durée minimale de verrouillage à renvoyer
231 au client. Les Répertoires Web de Microsoft présentent une durée par
232 défaut de 120 secondes ; la directive
233 <directive>DavMinTimeout</directive> permet de définir une valeur
234 supérieure (par exemple 600 secondes), afin de réduire les risques
235 de perte du verrou par le client suite à une surcharge du
238 <example><title>Exemple</title>
239 <highlight language="config">
240 <Location "/MSWord">
249 <name>DavDepthInfinity</name>
250 <description>Autorise les requêtes PROPFIND avec en-tête Depth:
251 Infinity</description>
252 <syntax>DavDepthInfinity on|off</syntax>
253 <default>DavDepthInfinity off</default>
254 <contextlist><context>server config</context><context>virtual host</context>
255 <context>directory</context></contextlist>
258 <p>La directive <directive>DavDepthInfinity</directive>
259 autorise le traitement des requêtes <code>PROPFIND</code>
260 contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête
261 n'est pas autorisé, car il peut favoriser les attaques de type Déni