Serveur Apache HTTP Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

# Module Apache mod_authn_file

Description: | Authentification utilisateur à l'aide de fichiers texte
Statut: | Base
Identificateur de Module: | authn_file_module
Fichier Source: | mod_authn_file.c
Compatibilité: | Disponible depuis les versions 2.1 et supérieures d'Apache

### Sommaire

Ce module permet aux frontaux d'authentification comme `mod_auth_digest` et `mod_auth_basic` d'authentifier les utilisateurs en les recherchant dans des fichiers de mots de passe au format texte. `mod_authn_dbm` fournit une fonctionnalité similaire.

Lorsqu'on utilise `mod_auth_basic` ou `mod_auth_digest`, ce module peut être invoqué en affectant la valeur `file` à la directive `AuthBasicProvider` ou `AuthDigestProvider`.

### Directives

### Traitement des bugs

- Journal des modifications de httpd
- Problèmes connus
- Signaler un bug

### Voir aussi

- `AuthBasicProvider`
- `AuthDigestProvider`
- `htpasswd`
- `htdigest`
- Formats de mots de passe

## Directive AuthUserFile

Description: | Définit le nom d'un fichier texte pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe
Syntaxe: | `AuthUserFile chemin-fichier`
Contexte: | répertoire, .htaccess
AllowOverride: | AuthConfig
Statut: | Base
Module: | mod_authn_file

La directive `AuthUserFile` permet de définir le nom d'un fichier texte pour l'authentification contenant la liste des utilisateurs et de leurs mots de passe. chemin-fichier est le chemin vers le fichier des utilisateurs. S'il n'est pas absolu, il est considéré comme relatif au répertoire défini par la directive `ServerRoot`.

Chaque ligne du fichier des utilisateurs se compose du nom de l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le même identifiant utilisateur est référencé plusieurs fois, `mod_authn_file` utilisera la première occurrence pour vérifier le mot de passe.

Le format du mot de passe chiffré dépend du frontal d'authentification utilisé (par exemple `mod_auth_basic` ou `mod_auth_digest`). Voir la documentation sur les Formats de mots de passe pour plus de détails.

Pour `mod_auth_basic`, utilisez le programme `htpasswd` fourni avec la distribution binaire, mais que vous trouverez aussi dans le répertoire `src/support` de l'arborescence des sources. Voir sa page de manuel pour plus de détails. En bref :

On crée un fichier de mots de passe `nom-fichier` avec `nom-utilisateur` comme identifiant initial. Le mot de passe correspondant sera alors demandé :

`htpasswd -c nom-fichier nom-utilisateur`

Pour ajouter ou modifier `nom-utilisateur2` dans le fichier de mots de passe `nom-fichier` :

`htpasswd nom-fichier nom-utilisateur2`

Noter qu'une recherche dans de grands fichiers texte peut être très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM avec la directive `AuthDBMUserFile`.

Pour `mod_auth_digest`, vous devez utiliser le programme `htdigest`. Notez que vous ne pouvez pas mélanger des données utilisateur pour l'Authentification HTTP à base de condensé et des données pour l'Authentification de Base dans le même fichier.

### Sécurité

Assurez-vous que le fichier `AuthUserFile` soit bien stocké en dehors de l'arborescence des documents du serveur web. Ne placez pas ce fichier dans le répertoire qu'il protège. Dans le cas contraire, les clients seraient en mesure de télécharger le fichier des mots de passe.