From 90c0a8df9422986fe338bb6ab0036660af7f1f15 Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sat, 19 Aug 2023 14:27:45 +0000 Subject: [PATCH] fr doc XML file update. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1911777 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_dav.xml.fr | 190 +++++++++++++++++++-------------- 1 file changed, 111 insertions(+), 79 deletions(-) diff --git a/docs/manual/mod/mod_dav.xml.fr b/docs/manual/mod/mod_dav.xml.fr index 81ec40cda79..f9a8f257a2f 100644 --- a/docs/manual/mod/mod_dav.xml.fr +++ b/docs/manual/mod/mod_dav.xml.fr @@ -1,7 +1,7 @@ - + @@ -25,7 +25,7 @@ mod_dav -Fonctionnalité de création et gestion de versions de +Fonctionnalité de création et gestion de versions de documents via le web (WebDAV) Extension @@ -33,11 +33,11 @@ href="http://www.webdav.org/">WebDAV) dav_module -

Ce module ajoute à Apache une fonctionnalité Ce module ajoute à Apache une fonctionnalité WebDAV de classes 1 et 2 - ('Web-based Distributed Authoring and Versioning' ou Création et + ('Web-based Distributed Authoring and Versioning' ou Création et gestion de versions de documents via le web). Il s'agit d'une - extension du protocole HTTP qui permet de créer, déplacer, copier et + extension du protocole HTTP qui permet de créer, déplacer, copier et supprimer des ressources ou collections de ressources sur un serveur web distant.

 @@ -47,17 +47,17 @@ href="http://www.webdav.org/">WebDAV)
Activation de WebDAV

Pour activer le module mod_dav, ajoutez la ligne - suivante à un conteneur de votre fichier httpd.conf + suivante à un conteneur de votre fichier httpd.conf :

Dav On -

Ceci active le fournisseur de système de fichier DAV implémenté par - le module mod_dav_fs. Ce dernier doit donc être - compilé dans le serveur ou chargé au démarrage à l'aide de la +

Ceci active le fournisseur de système de fichier DAV implémenté par + le module mod_dav_fs. Ce dernier doit donc être + compilé dans le serveur ou chargé au démarrage à l'aide de la directive LoadModule.

-

En outre, vous devez indiquer où se trouve la base de données des +

En outre, vous devez indiquer où se trouve la base de données des verrous DAV via une directive DavLockDB dans la section globale de votre fichier httpd.conf :

@@ -66,21 +66,21 @@ href="http://www.webdav.org/">WebDAV) DavLockDB "/usr/local/apache2/var/DavLock" -

Le répertoire contenant le fichier de la base de données des - verrous doit avoir des droits en écriture pour l'utilisateur et le - groupe sous lesquels Apache s'exécute et définis respectivement par +

Le répertoire contenant le fichier de la base de données des + verrous doit avoir des droits en écriture pour l'utilisateur et le + groupe sous lesquels Apache s'exécute et définis respectivement par les directives User et Group.

-

Si vous souhaitez limiter l'accès aux répertoires où DAV est - activé, vous pouvez ajouter une clause Si vous souhaitez limiter l'accès aux répertoires où DAV est + activé, vous pouvez ajouter une clause Limit dans la section Location considérée. Pour - définir la quantité maximale de données en octets qu'un client - DAV peut envoyer par requête, vous devez utiliser la directive + module="core" type="section">Location considérée. Pour + définir la quantité maximale de données en octets qu'un client + DAV peut envoyer par requête, vous devez utiliser la directive LimitXMLRequestBody, car La directive LimitRequestBody - "habituelle" n'a aucune incidence sur les requêtes DAV.

+ "habituelle" n'a aucune incidence sur les requêtes DAV.

Exemple complet @@ -103,63 +103,63 @@ DavLockDB "/usr/local/apache2/var/DavLock"
-
Problèmes concernant la sécurité +
Problèmes concernant la sécurité -

Etant donné que les méthodes d'accès DAV permettent à des clients +

Etant donné que les méthodes d'accès DAV permettent à des clients distants de manipuler des fichiers sur le serveur, vous devez vous - assurer que votre serveur est bien sécurisé avant d'activer + assurer que votre serveur est bien sécurisé avant d'activer mod_dav.

-

Tout répertoire du serveur où DAV est activé doit être protégé - par une procédure d'authentification. L'utilisation de - l'authentification HTTP de base n'est pas recommandée. Vous devez - utiliser au moins l'authentification HTTP à base de condensés - qu'implémente le module mod_auth_digest. - Pratiquement tous les clients WebDAV supportent cette méthode +

Tout répertoire du serveur où DAV est activé doit être protégé + par une procédure d'authentification. L'utilisation de + l'authentification HTTP de base n'est pas recommandée. Vous devez + utiliser au moins l'authentification HTTP à base de condensés + qu'implémente le module mod_auth_digest. + Pratiquement tous les clients WebDAV supportent cette méthode d'authentification. Vous pouvez aussi utiliser l'authentification de - base sur une connexion où SSL est activé.

+ base sur une connexion où SSL est activé.

Pour que mod_dav puisse manipuler des fichiers, - il doit avoir des permissions en écriture sur les répertoires et les - fichiers qui sont sous son contrôle ; en d'autre termes, c'est - l'utilisateur et le groupe sous lesquels Apache s'exécute et définis + il doit avoir des permissions en écriture sur les répertoires et les + fichiers qui sont sous son contrôle ; en d'autre termes, c'est + l'utilisateur et le groupe sous lesquels Apache s'exécute et définis par les directives User et Group qui doivent avoir - les droits en écriture sur ces fichiers et répertoires. Les fichiers - nouvellement créés appartiendront aussi à ces utilisateur et groupe. - Par conséquent, il est important de contrôler l'accès à ce compte. - Les répertoires DAV sont considérés comme privés du point de vue + les droits en écriture sur ces fichiers et répertoires. Les fichiers + nouvellement créés appartiendront aussi à ces utilisateur et groupe. + Par conséquent, il est important de contrôler l'accès à ce compte. + Les répertoires DAV sont considérés comme privés du point de vue d'Apache, et la modification des fichiers qu'ils contiennent - autrement que par l'intermédiaire d'Apache (par exemple par FTP ou - par des outils du niveau du système de fichiers) ne doit pas être + autrement que par l'intermédiaire d'Apache (par exemple par FTP ou + par des outils du niveau du système de fichiers) ne doit pas être permise.

mod_dav peut faire l'objet de plusieurs sortes - d'attaques par déni de service. La directive LimitXMLRequestBody permet de limiter la - quantité de mémoire consommée pour interpréter des requêtes DAV de + quantité de mémoire consommée pour interpréter des requêtes DAV de grande taille. En outre, la directive DavDepthInfinity permet d'empêcher les - requêtes PROPFIND concernant un répertoire de très - grande taille de consommer de grandes quantités de mémoire. Un autre - type d'attaque par déni de service peut aussi être mené par un + module="mod_dav">DavDepthInfinity permet d'empêcher les + requêtes PROPFIND concernant un répertoire de très + grande taille de consommer de grandes quantités de mémoire. Un autre + type d'attaque par déni de service peut aussi être mené par un client qui remplit simplement tout l'espace disque disponible avec - des fichiers de très grande taille. Etant donné qu'il n'existe aucun - moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez - accorder des accès DAV qu'à des utilisateurs de confiance.

+ des fichiers de très grande taille. Etant donné qu'il n'existe aucun + moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez + accorder des accès DAV qu'à des utilisateurs de confiance.

Configurations complexes -

Les requêtes ayant pour but de manipuler des fichiers dynamiques +

Les requêtes ayant pour but de manipuler des fichiers dynamiques (scripts PHP, scripts CGI, etc...) en utilisant mod_dav sont courantes. Ce traitement n'est pas - évident car une requête - GET va toujours tenter d'exécuter le script, plutôt que - de télécharger son contenu. Pour éviter cet inconvénient, une - méthode possible consiste à faire correspondre deux URLs - différentes au même contenu, l'une d'entre elles servant à lancer le - script, alors que l'autre peut être utilisée pour le télécharger et + évident car une requête + GET va toujours tenter d'exécuter le script, plutôt que + de télécharger son contenu. Pour éviter cet inconvénient, une + méthode possible consiste à faire correspondre deux URLs + différentes au même contenu, l'une d'entre elles servant à lancer le + script, alors que l'autre peut être utilisée pour le télécharger et le manipuler avec DAV.

@@ -172,22 +172,22 @@ ForceType text/plain

Avec cette configuration, on peut utiliser - http://example.com/phparea pour afficher le résultat de - l'exécution des scripts PHP, et + http://example.com/phparea pour afficher le résultat de + l'exécution des scripts PHP, et http://example.com/php-source pour les manipuler avec DAV.

Dav -Active les méthodes HTTP WebDAV +Active les méthodes HTTP WebDAV Dav On|Off|nom fournisseur Dav Off directory

La directive Dav active les - méthodes HTTP WebDAV pour le conteneur condidéré :

+ méthodes HTTP WebDAV pour le conteneur condidéré :

<Location "/foo"> @@ -196,23 +196,55 @@ ForceType text/plain

La valeur On est en fait un alias vers le - fournisseur par défaut filesystem implémenté par le - module mod_dav_fs. Notez que lorsque DAV est activé - pour un conteneur, on ne peut pas le désactiver pour ses + fournisseur par défaut filesystem implémenté par le + module mod_dav_fs. Notez que lorsque DAV est activé + pour un conteneur, on ne peut pas le désactiver pour ses sous-conteneurs. Pour un exemple de configuration complet, - reportez-vous à la section précédente.

+ reportez-vous à la section précédente.

- N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si + N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si vous passez outre cette recommandation, tout le monde pourra - enregistrer des fichiers sur votre système. + enregistrer des fichiers sur votre système. + +DavBasePath +Définir le chemin de la racine du répertoire +DavBasePath root-path +DavBasePath /repos/ +directory +Disponible à partir de la version 2.5.1 du serveur HTTP Apache + + +

Si le répertoire DAV est défini en utilisant une correspondance + d'expression rationnelle (comme LocationMatch), mod_dav ne sera pas + en mesure de déterminer de lui-même la racine du répertoire à partir du chemin + seul. En conséquence, des fournisseurs tiers (par exemple le module mod_dav_svn + de Subversion) pourront échouer à traiter des requêtes sans disposer de la + valeur correcte de la racine du répertoire.

+ +

Pour permettre aux fournisseurs de travailler correctement en présence + d'une telle configuration, vous devez utiliser + DavBasePath.

+ + +<LocationMatch "^/repos/"> + Dav svn + DavBasePath /repos + SVNParentPath /var/svn +</LocationMatch> + + + + DavMinTimeout -Durée minimale pendant laquelle le serveur maintient un +Durée minimale pendant laquelle le serveur maintient un verrou sur une ressource DAV DavMinTimeout secondes DavMinTimeout 0 @@ -221,19 +253,19 @@ verrou sur une ressource DAV

Lorsqu'un client demande le verrouillage d'une ressource DAV, il - peut aussi spécifier une durée au bout de laquelle le verrou sera - automatiquement supprimé par le serveur. Cette valeur ne constitue - qu'une requête, et le serveur peut l'ignorer ou informer le client + peut aussi spécifier une durée au bout de laquelle le verrou sera + automatiquement supprimé par le serveur. Cette valeur ne constitue + qu'une requête, et le serveur peut l'ignorer ou informer le client qu'il va utiliser une valeur arbitraire.

La directive DavMinTimeout - spécifie, en secondes, la durée minimale de verrouillage à renvoyer - au client. Les Répertoires Web de Microsoft présentent une durée par - défaut de 120 secondes ; la directive - DavMinTimeout permet de définir une valeur - supérieure (par exemple 600 secondes), afin de réduire les risques - de perte du verrou par le client suite à une surcharge du - réseau.

+ spécifie, en secondes, la durée minimale de verrouillage à renvoyer + au client. Les Répertoires Web de Microsoft présentent une durée par + défaut de 120 secondes ; la directive + DavMinTimeout permet de définir une valeur + supérieure (par exemple 600 secondes), afin de réduire les risques + de perte du verrou par le client suite à une surcharge du + réseau.

Exemple @@ -247,7 +279,7 @@ verrou sur une ressource DAV DavDepthInfinity -Autorise les requêtes PROPFIND avec en-tête Depth: +Autorise les requêtes PROPFIND avec en-tête Depth: Infinity DavDepthInfinity on|off DavDepthInfinity off @@ -256,9 +288,9 @@ Infinity

La directive DavDepthInfinity - autorise le traitement des requêtes PROPFIND - contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête - n'est pas autorisé, car il peut favoriser les attaques de type Déni + autorise le traitement des requêtes PROPFIND + contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête + n'est pas autorisé, car il peut favoriser les attaques de type Déni de service.

 -- 2.47.2