Serveur Apache HTTP Version 2.4
Serveur Apache HTTP Version 2.4
htpasswd permet de créer et de maintenir les
fichiers textes où sont stockés les noms d'utilisateurs et mots de
passe pour l'authentification de base des utilisateurs HTTP. Si
htpasswd rencontre un problème d'accès à un fichier,
que ce soit pour écrire dans le fichier de sortie, ou pour lire le
fichier d'entrée dans le but de le mettre à jour, il renvoie un code
d'erreur et n'effectue aucune modification.
Il est possible de limiter l'accès aux ressources du serveur HTTP
Apache aux seuls utilisateurs présents dans les fichiers créés par
htpasswd. Ce programme ne sait gérer les noms
d'utilisateurs et mots de passe que s'ils sont stockés dans des
fichiers textes. Il peut cependant chiffrer et afficher les mots de
passe à des fins d'utilisation dans d'autres types de bases de
données. Pour utiliser une base de données DBM, voir le programme
dbmmanage ou htdbm.
htpasswd chiffre les mots de passe en utilisant soit
bcrypt,
une version de MD5 modifiée pour Apache, soit SHA1, soit la routine
crypt() du système. Les fichiers gérés par
htpasswd peuvent contenir deux types de mots de passe ;
certaines entrées peuvent contenir des mots de passe chiffrés en
MD5 ou bcrypt, alors que d'autres entrées du même fichier contiendront des
mots de passe chiffrés avec crypt().
Cette page de manuel ne décrit que les arguments de la ligne de
commande. Pour plus de détails à propos des directives nécessaires à
la configuration de l'authentification des utilisateurs dans
httpd, voir le manuel Apache qui est fourni avec
la distribution ou peut être consulté à http://httpd.apache.org/.
htpasswd
[ -c ]
[ -i ]
[ -m |
-B |
-d |
-s |
-p ]
[ -C cost ]
[ -D ]
[ -v ] fichier-mots-de-passe nom-utilisateur
htpasswd -b
[ -c ]
[ -m |
-B |
-d |
-s |
-p ]
[ -C cost ]
[ -D ]
[ -v ] fichier-mots-de-passe nom-utilisateur
mot-de-passe
htpasswd -n
[ -i ]
[ -m |
-B |
-d |
-s |
-p ]
[ -C cost ] nom-utilisateur
htpasswd -nb
[ -m |
-B |
-d |
-s |
-p ]
[ -C cost ] nom-utilisateur
mot-de-passe
-b-i.-i-c-n.-n-c option.-m-B-C-B (chiffrement bcrypt). Il permet de définir la durée
de traitement pour l'algorytme bcrypt (plus elle est longue,
meilleure sera la sécurité, mais inférieure la rapidité). La valeur
par défaut est 5 et les valeurs autorisées vont de 4 à 31.-dcrypt() pour les mots de
passe. Cette option n'est pas supportée par le
serveur httpd sous Windows ou Netware. Cet
algorithme limite la longueur des mots de passe à 8 caractères ; il
est considéré comme non sur du point de vue des
standards actuels. C'était l'algorithme par défaut jusqu'à la
version 2.2.17.-s-phtpasswd supporte la création des mots de passe en
clair sur toutes les plates-formes, le démon
httpd n'accepte les mots de passe en clair que
sous Windows et Netware.-D-vfichier-mots-de-passe-c, le fichier est créé s'il
n'existe pas, ou réécrit et tronqué s'il existe déjà.nom-utilisateurmot-de-passe-b.htpasswd renvoie 0 ("true") si le nom d'utilisateur
et le mot de passe ont été enregistrés ou mis à jour avec succès
dans le fichier-mots-de-passe. htpasswd
renvoie 1 s'il a rencontré un problème d'accès aux
fichiers, 2 si la ligne de commande comportait une
erreur de syntaxe, 3 si le mot de passe entré
interactivement ne correspondait pas au nom d'utilisateur,
4 si l'opération a été interrompue, 5 si
une valeur était trop longue (nom-utilisateur, nom-fichier,
mot-de-passe, ou l'enregistrement résultant), 6 si le
nom d'utilisateur contenait des caractères illégaux (voir la section
Restrictions), et 7 si le
fichier spécifié n'était pas un fichier de mots de passe
valide.
htpasswd /usr/local/etc/apache/.utilisateurs-htpasswd jsmith
Ajoute ou modifie le mot de passe de l'utilisateur
jsmith. Le mot de passe est demandé à l'opérateur. Le
mot de passe sera chiffré en utilisant l'algorithme MD5
modifié pour Apache. Si le fichier spécifié
n'existe pas, htpasswd renverra un code d'erreur.
htpasswd -c /home/doe/public_html/.htpasswd jane
Crée un nouveau fichier de mots de passe et y enregistre une
entrée pour l'utilisateur jane. Le mot de passe est
demandé à l'opérateur. Si le fichier existe et ne peut être ni lu ni
écrit, il n'est pas modifié et htpasswd affichera un
message et renverra un code d'erreur.
htpasswd -db /usr/web/.htpasswd-tous jones Pwd4Steve
Chiffre le mot de passe spécifié dans la ligne de commande
(Pwd4Steve) en utilisant l'algorithme
crypt(), et le stocke dans le fichier spécifié.
Les fichiers de mots de passe Web comme ceux que gère
htpasswd ne doivent pas être situés dans
l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
être possible d'y accéder à partir d'un navigateur.
En tant qu'exécutable setuid, ce programme n'est pas sûr, et il ne faut par conséquent pas lui attribuer de permissions setuid.
L'utilisation de l'option -b est déconseillée, car
avec elle, les mots de passe apparaissent en clair dans la ligne de
commande.
Notez qu'avec l'algorithme crypt(), seuls les huit
premiers caractères du mot de passe spécifié sont pris en compte. Si
le mot de passe spécifié est plus long, les caractères
supplémentaires sont ignorés.
Le format de chiffrement SHA n'utilise pas d'amorçage aléatoire
(salting) : à un mot de passe donné correspond une seule
représentation chiffrée. Les formats crypt() et MD5
permutent la représentation en la préfixant par une chaîne d'amorce
aléatoire, afin de rendre les attaques de mots de passe à base de
dictionnaires plus difficiles.
Les algorithmes de chiffrement SHA et crypt()
sont considérés comme non surs du point de vue des
standards actuels.
Sur les plates-formes Windows, la taille des mots de passe
chiffrés avec htpasswd est limitée à 255
caractères. Les mots de passe dont la taille est supérieure seront
tronqués.
L'algorithme MD5 utilisé par htpasswd est spécifique
à Apache ; les mots de passe chiffrés en utilisant cet algorithme
seront inutilisables sur d'autres serveurs Web.
La taille des noms d'utilisateurs est limitée à 255
octets et ceux-ci ne doivent pas contenir de caractère
:.