● PHANTOM
🇼🇳 IN
✕
<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_auth_digest

Langues Disponibles:  en  |  fr  |  ko 

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 en ne transmettant plus le mot de passe en clair. Cependant, cela ne suffit pas pour améliorer la sécurité de maniÚre significative par rapport à l'authentification basique. En outre, le stockage du mot de passe sur le serveur est encore moins sûr dans le cas d'une authentification à base de condensé que dans le cas d'une authentification basique. C'est pourquoi l'utilisation de l'authentification basique associée à un chiffrement de la connexion via mod_ssl constitue une bien meilleure alternative.

Support Apache!

Sujets

Directives

Traitement des bugs

Voir aussi

top

Utilisation de l'authentification à base de condensés

Pour utiliser l'authentification à base de condensés MD5, vous devez simplement remplacer AuthType Basic et AuthBasicProvider respectivement par AuthType Digest et AuthDigestProvider lorsque vous configurez l'authentification, puis ajouter 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Ă© a Ă©tĂ© conçue pour amĂ©liorer la sĂ©curitĂ© par rapport Ă  l'authentification basique, mais il s'avĂšre que ce but n'a pas Ă©tĂ© atteint. Un attaquant de type "man-in-the-middle" peut facilement forcer le navigateur Ă  revenir Ă  une authentification basique. MĂȘme une oreille indiscrĂšte passive peut retrouver le mot de passe par force brute avec les moyens modernes, car l'algorithme de hashage utilisĂ© par l'authentification Ă  base de condensĂ© est trop rapide. Autre problĂšme, le stockage des mots de passe sur le serveur n'est pas sĂ»r. Le contenu d'un fichier htdigest volĂ© peut ĂȘtre utilisĂ© directement pour l'authentification Ă  base de condensĂ©. Il est donc fortement recommandĂ© d'utiliser mod_ssl pour chiffrer la connexion.

mod_auth_digest ne fonctionne correctement que sur les plates-formes oĂč APR supporte la mĂ©moire partagĂ©e.

top

Directive AuthDigestAlgorithm

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
Surcharges autorisées: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é.
top

Directive AuthDigestDomain

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
Surcharges autorisées: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.

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

top

Directive AuthDigestNonceLifetime

Description:Durée de validité du nombre à valeur unique du serveur (nonce)
Syntaxe:AuthDigestNonceLifetime secondes
Défaut:AuthDigestNonceLifetime 300
Contexte:répertoire, .htaccess
Surcharges autorisées: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.

top

Directive AuthDigestProvider

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
Surcharges autorisées: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, mod_authn_dbd et mod_authn_socache pour la liste des fournisseurs disponibles.

top

Directive AuthDigestQop

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
Surcharges autorisées: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é.
top

Directive AuthDigestShmemSize

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 globale
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 suffixer 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

Langues Disponibles:  en  |  fr  |  ko 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our mailing lists.