Apache Module mod_auth_digest

Available Languages: en | + fr | ko

diff --git a/docs/manual/mod/mod_auth_digest.html.fr b/docs/manual/mod/mod_auth_digest.html.fr new file mode 100644 index 00000000000..c211a0f954f --- /dev/null +++ b/docs/manual/mod/mod_auth_digest.html.fr @@ -0,0 +1,362 @@ + + + +mod_auth_digest - Serveur Apache HTTP + + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.2 > Modules

Module Apache mod_auth_digest

Langues Disponibles: en | + fr | + ko

Description:	User authentication using MD5 @@ -325,6 +326,7 @@ of clients

+ + +

Description:	Authentification utilisateur utilisant les condensés +MD5.
Statut:	Extension
Identificateur de Module:	auth_digest_module
Fichier Source:	mod_auth_digest.c

Sommaire

+ +

Ce module implémente l'authentification HTTP basée sur les + condensés MD5 (RFC2617), et + fournit une alternative à mod_auth_basic plus + sécurisée.

Utilisation de l'authentification à base de +condensés

+ +

L'utilisation de l'authentification à base de condensés MD5 est + très simple. Configurez l'authentification normalement, en utilisant + AuthType Digest et AuthDigestProvider à la place + de AuthType Basic et AuthBasicProvider. Ajoutez + ensuite une directive AuthDigestDomain contenant au + moins la(les) URI(s) racine(s) de la zone à protéger.

+ +

On peut créer les fichiers utilisateur appropriés (au format + texte) à l'aide de l'outil htdigest.

+ +

Exemple :

+ <Location /private/> + + AuthType Digest + AuthName "private area" + AuthDigestDomain /private/ http://mirror.my.dom/private2/ + + AuthDigestProvider file + AuthUserFile /web/auth/.digest_pw + Require valid-user + + </Location> +

+ +

Note

L'authentification à base de condensés MD5 est plus sécurisée que + l'authentification Basic, mais ne fonctionne qu'avec les navigateurs + qui la supportent. En septembre 2004, les principaux navigateurs + supportant l'authentification à base de condensés MD5 incluaient Amaya, Konqueror, MS Internet Explorer + pour Mac OS X et Windows (bien que la version Windows échoue lorsque + la requête comporte une chaîne d'arguments -- voir plus loin "Travailler avec MS Internet Explorer" pour + contourner ce problème), Mozilla, + Netscape 7, Opera, et Safari. lynx ne supporte + pas l'authentification à base de condensés MD5. + Comme l'authentification à base de condensés MD5 est moins répandue + que l'authentification Basic, vous ne devez l'utiliser que dans des + environnements où tous les utilisateurs disposeront d'un navigateur + la supportant.

Travailler avec MS Internet Explorer

L'implémentation de l'authentification à base de condensé dans + les versions anciennes d'Internet Explorer pour Windows (5 et 6) + posait problème, car les requêtes de type GET + comportant une chaîne d'arguments ne respectaient pas les RFC. Il y + a plusieurs manières de contourner ce problème.

+ +

+ La première méthode consiste à utiliser des requêtes de type + POST plutôt que GET pour transmettre les + données à votre programme. Cette méthode constitue l'approche la + plus simple dans le cas où votre application peut fonctionner avec + cette limitation. +

+ +

Depuis la version 2.0.51, Apache propose aussi de contourner le + problème à l'aide de la variable d'environnement + AuthDigestEnableQueryStringHack. Si + AuthDigestEnableQueryStringHack est définie pour la + requête, Apache va prendre des mesures pour contourner la bogue MSIE + et en particulier va exclure la chaîne d'arguments de la comparaison + des condensés. L'utilisation de cette méthode peut se traduire par + ceci :

+ +

Utilisation de l'authentification à base de condensé + avec MSIE :

+ BrowserMatch "MSIE" AuthDigestEnableQueryStringHack=On +

+ +

Cette correction n'est pas nécessaire avec MSIE 7, bien que son + activation ne pose pas de problème de compatibilité ou de surcharge + significative.

+ +

Voir la directive BrowserMatch pour plus de détails + à propos de la définition conditionnelle des variables + d'environnement.

AuthDigestAlgorithm Directive

+ + + + + + + + +

Description:	Sélectionne l'algorithme utilisé pour calculer les +condensés du défit et de sa réponse
Syntaxe:	`AuthDigestAlgorithm MD5\|MD5-sess`
Défaut:	`AuthDigestAlgorithm MD5`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Extension
Module:	mod_auth_digest

La directive AuthDigestAlgorithm permet de + sélectionner l'algorithme utilisé pour calculer les condensés du + défit et de sa réponse.

+ +

+ MD5-sess n'est pas encore correctement implémenté. +

+ + +

AuthDigestDomain Directive

+ + + + + + + +

Description:	Les URIs qui se trouvent dans le même espace de protection +concernant l'authentification à base de condensés
Syntaxe:	`AuthDigestDomain URI [URI] ...`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Extension
Module:	mod_auth_digest

La directive AuthDigestDomain vous permet + de spécifier un ou plusieurs URIs se trouvant dans le même + espace de protection (c'est à dire utilisant le même utilisateur/mot + de passe et se trouvant dans le même domaine). Les URIs spécifiés + sont des préfixes ; le client doit savoir que tous les URIs situés + sous ces préfixes seront protégés par le même utilisateur/mot de + passe. Les URIs peuvent être soit des URIs absolus (c'est à dire + avec protocole, nom serveur, port, etc...), soit des URIs + relatifs.

+ +

Cette directive doit toujours être présente et contenir au moins + le(s) URI(s) racine(s) pour cet espace. Dans le cas contraire, le + client va envoyer un en-tête d'autorisation avec chaque + requête à destination de ce serveur. Outre une augmentation de + la taille de la requête, les performances vont s'en trouver + affectées si la directive AuthDigestNcCheck est définie à + On.

+ +

Les URIs spécifiés peuvent aussi référencer différents serveurs, + auquel cas les clients (pour ceux qui sont à même de le comprendre) vont + partager l'utilisateur/mot de passe entre plusieurs serveurs sans le + demander à l'utilisateur à chaque fois.

+ +

AuthDigestNcCheck Directive

+ + + + + + + +

Description:	Active ou désactive la vérification du nombre d'envois du +nombre à valeur unique (nonce) par le serveur
Syntaxe:	`AuthDigestNcCheck On\|Off`
Défaut:	`AuthDigestNcCheck Off`
Contexte:	configuration du serveur
Statut:	Extension
Module:	mod_auth_digest

+ Non encore implémenté. +

+ + +

Description:	Détermine la manière dont le nombre à valeur unique du +serveur (nonce) est généré
Syntaxe:	`AuthDigestNonceFormat format`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Extension
Module:	mod_auth_digest

Description:

Détermine la manière dont le nombre à valeur unique du +serveur (nonce) est généré

Syntaxe:

AuthDigestNonceFormat format

Contexte:

répertoire, .htaccess

Annuler:

AuthConfig

Statut:

Extension

Module:

mod_auth_digest

AuthDigestNonceLifetime Directive

+ + + + + + + + +

Description:	Durée de validité du nombre à valeur unique du +serveur (nonce)
Syntaxe:	`AuthDigestNonceLifetime secondes`
Défaut:	`AuthDigestNonceLifetime 300`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Extension
Module:	mod_auth_digest

La directive AuthDigestNonceLifetime + permet de contrôler la durée de validité du nombre à valeur unique + du serveur (nonce). Lorsque le client contacte le serveur en + utilisant un nonce dont la validité a expiré, le serveur renvoie un + code d'erreur 401 avec stale=true. Si + secondes est supérieur à 0, il spécifie la durée de + validité du nonce ; il est en général déconseillé d'affecter à cet + argument une valeur inférieure à 10 secondes. Si + secondes est inférieur à 0, le nonce n'expire jamais. + +

+ +

AuthDigestProvider Directive

+ + + + + + + + +

Description:	Définit le(s) fournisseurs(s) d'authentification pour la +zone du site web concernée
Syntaxe:	`AuthDigestProvider nom fournisseur +[nom fournisseur] ...`
Défaut:	`AuthDigestProvider file`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Extension
Module:	mod_auth_digest

La directive AuthDigestProvider permet de + définir quel fournisseur d'authentification sera utilisé pour + authentifier les utilisateurs pour la zone du site web concernée. + Assurez-vous que le module implémentant le fournisseur + d'authentification choisi soit bien présent dans le serveur. Le + fournisseur par défaut file est implémenté par le + module mod_authn_file.

+ +

Voir mod_authn_dbm, + mod_authn_file, et mod_authn_dbd + pour la liste des fournisseurs disponibles.

+ +

AuthDigestQop Directive

+ + + + + + + + +

Description:	Détermine le niveau de protection fourni par +l'authentification à base de condensé
Syntaxe:	`AuthDigestQop none\|auth\|auth-int [auth\|auth-int]`
Défaut:	`AuthDigestQop auth`
Contexte:	répertoire, .htaccess
Annuler:	AuthConfig
Statut:	Extension
Module:	mod_auth_digest

La directive AuthDigestQop permet de + définir le niveau de protection fourni. auth + ne fournit que l'authentification (nom utilisateur/mot de passe) ; + auth-int fournit l'authentification plus un contrôle + d'intégrité (un condensé MD5 de l'entité est aussi calculé et + vérifié) ; avec none, le module va utiliser l'ancien + algorithme de condensés RFC-2069 (qui n'effectue pas de contrôle + d'intégrité). On peut spécifier à la fois auth et + auth-int, auquel cas c'est le navigateur qui va choisir + lequel des deux utiliser. none ne doit être utilisé que + dans le cas où le navigateur ne serait pas à même (pour une raison + ou pour une autre) de relever le défit qu'il recevrait si un autre + niveau de protection était défini.

+ +

+ auth-int n'est pas encore implémenté. +

+ +

AuthDigestShmemSize Directive

+ + + + + + + +

Description:	La quantité de mémoire partagée à allouer afin de conserver +les informations à propos des clients
Syntaxe:	`AuthDigestShmemSize taille`
Défaut:	`AuthDigestShmemSize 1000`
Contexte:	configuration du serveur
Statut:	Extension
Module:	mod_auth_digest

La directive AuthDigestShmemSize permet de + définir la quantité de mémoire partagée à allouer au démarrage du + serveur afin de conserver les informations à propos des clients. + Notez que le segment de mémoire partagée ne peut pas être défini à + une taille inférieure à l'espace nécessaire pour conserver les + informations à propos d'un client. Cette valeur dépend de + votre système. Si vous voulez en déterminer la valeur exacte, vous + pouvez simplement définir AuthDigestShmemSize + à 0 et consulter le message d'erreur que renverra le + serveur lorsqu'on essaiera de le démarrer.

+ +

L'argument size s'exprime par défaut en octets, mais + vous pouvez faire suivre le nombre par un K ou un + M pour spécifier respectivement des KiloOctets ou des + MégaOctets. Par exemple, les directives qui suivent sont toutes + équivalentes :

+ +

+ AuthDigestShmemSize 1048576 + AuthDigestShmemSize 1024K + AuthDigestShmemSize 1M +

+ +

Apache Module mod_auth_digest

Module Apache mod_auth_digest

Sommaire

Directives

Sujets

Voir aussi

Utilisation de l'authentification à base de +condensés

Exemple :

Note

Travailler avec MS Internet Explorer

Utilisation de l'authentification à base de condensé + avec MSIE :

AuthDigestAlgorithm Directive

AuthDigestDomain Directive

AuthDigestNcCheck Directive

AuthDigestNonceFormat Directive

AuthDigestNonceLifetime Directive

AuthDigestProvider Directive

AuthDigestQop Directive

AuthDigestShmemSize Directive