htdbm - Manipuler des bases de donn�es DBM de mots de passe

Syntaxe

htdbm [ -TDBTYPE ] [ -i ] [ -c ] [ -m | -B | -d | -s | -p ] [ -C cost ] [ -t ] [ -v ] nom-fichier nom-utilisateur

htdbm -b [ -TDBTYPE ] [ -c ] [ -m | -B | -d | -s | -p ] [ -C cost ] [ -t ] [ -v ] nom-fichier nom-utilisateur mot-de-passe

htdbm -n [ -i ] [ -c ] [ -m | -B | -d | -s | -p ] [ -C cost ] [ -t ] [ -v ] nom-utilisateur

htdbm -nb [ -c ] [ -m | -B | -d | -s | -p ] [ -C cost ] [ -t ] [ -v ] nom-utilisateur mot-de-passe

htdbm -v [ -TDBTYPE ] [ -i ] [ -c ] [ -m | -B | -d | -s | -p ] [ -C cost ] [ -t ] [ -v ] nom-fichier nom-utilisateur

htdbm -vb [ -TDBTYPE ] [ -c ] [ -m | -B | -d | -s | -p ] [ -C cost ] [ -t ] [ -v ] nom-fichier nom-utilisateur mot-de-passe

htdbm -x [ -TDBTYPE ] nom-fichier nom-utilisateur

htdbm -l [ -TDBTYPE ]

Options

-b

Utilise le mode batch ; en d'autres termes, le mot de passe est extrait de la ligne de commande au lieu d'�tre demand� � l'op�rateur. Cette option doit �tre utilis�e avec la plus grande prudence, car le mot de passe est visible en clair dans la ligne de commande. Pour utiliser un script, voir l'option -i.

-i

Lit le mot de passe depuis stdin sans v�rification (� utiliser dans le cadre d'un script).

-c

Cr�e le fichier-mots-de-passe. Si fichier-mots-de-passe existe d�j�, il est r��crit et tronqu�. Cette option ne peut pas �tre combin�e avec l'option -n.

-n

Affiche les r�sultats sur la sortie standard et ne met pas � jour la base de donn�es. Cette option modifie la syntaxe de la ligne de commande, car l'argument fichier-mots-de-passe (en g�n�ral le premier) est omis. Elle ne peut pas �tre combin�e avec l'option -c.

-m

Utilise un chiffrement MD5 pour les mots de passe. Sous Windows et Netware, c'est l'option par d�faut..

-B

Utilise l'algorythme de chiffrement bcrypt pour les mots de passe. C'est un algorythme actuellement consid�r� comme s�r.

-C

Ce drapeau n'est autoris� qu'en conjonction avec le drapeau -B (chiffrement bcrypt). Il permet de d�finir la dur�e de traitement pour l'algorythme de chiffrement bcrypt (plus elle est longue, plus la s�curit� est �lev�e, mais la rapidit� est diminu�e d'autant) ; la valeur par d�faut est 5, les valeurs valides vont de 4 � 31.

-d

Utilise un chiffrement crypt() pour les mots de passe. C'est l'option par d�faut sur toutes les plates-formes, sauf Windows et Netware. Bien que htdbm supporte ce chiffrement sur toutes les plates-formes, il n'est pas support� par le serveur httpd sous Windows et Netware. Cet algorythme est consid�r� comme non s�r selon les standards actuels.

-s

Utilise le chiffrement SHA pour les mots de passe. Facilite la migration vers/depuis les serveurs Netscape qui utilisent le format LDAP Directory Interchange (ldif). Cet algorythme est consid�r� comme non s�r selon les standards actuels.

-p

Utilise des mots de passe au format texte en clair. Bien que htdbm supporte ce format sur toutes les plates-formes, le d�mon httpd n'accepte les mots de passe au format texte en clair que sous Windows et Netware.

-l

Affiche chaque nom d'utilisateur de la base de donn�es accompagn� de son commentaire sur la sortie standard.

-v

V�rifie une association nom d'utilisateur/mot de passe. Le programme affichera un message indiquant si le mot de passe fourni est valide. Si le mot de passe n'est pas valide, le programme s'arr�te et renvoie un code d'erreur 3.

-x

Supprime l'utilisateur. Si le nom d'utilisateur existe dans le fichier DBM sp�cifi�, il sera supprim�.

-t

Interpr�te le dernier param�tre en tant que commentaire. Avec cette option, il est possible d'ajouter une cha�ne suppl�mentaire � la fin de la ligne de commande ; le contenu de cette cha�ne sera stock� dans la base de donn�es dans le champ "Comment" associ� au nom d'utilisateur sp�cifi�.

nom-fichier

Le nom du fichier au format DBM en g�n�ral sans l'extension .db, .pag, ou .dir. Avec l'option -c, le fichier DBM est mis � jour s'il existe ou cr�� dans le cas contraire.

nom-utilisateur

Le nom d'utilisateur � cr�er ou mettre � jour dans le fichier-mots-de-passe. Si nom-utilisateur n'existe pas dans ce fichier, une entr�e est ajout�e. S'il existe, son mot de passe est modifi�.

mot-de-passe

Le mot de passe en clair destin� � �tre chiffr� et stock� dans le fichier DBM. Ne s'utilise qu'avec l'option -b.

-TDBTYPE

Type de fichier DBM (SDBM, GDBM, DB, ou "default").

Bugs

Vous devez garder � l'esprit qu'il existe de nombreux formats de fichiers DBM diff�rents, et que selon toute vraisemblance, des biblioth�ques pour plus d'un format sont pr�sentes sur votre syst�me. Les trois exemples de base sont SDBM, NDBM, le projet GNU GDBM, et Berkeley/Sleepycat DB 2/3/4. Malheureusement, toutes ces biblioth�ques utilisent des formats de fichiers diff�rents, et vous devez vous assurer que le format de fichier utilis� par nom-fichier correspond au format attendu par htdbm. Actuellement, htdbm n'a aucun moyen de savoir � quel type de fichier DBM il a � faire. S'il est utilis� avec un format inappropri�, il ne renverra rien, ou pourra cr�er un fichier DBM diff�rent avec un nom diff�rent, ou au pire, va corrompre le fichier DBM si vous avez tent� de le modifier.

Vous pouvez utiliser le programme file fourni par la plupart des syst�mes Unix pour d�terminer le format d'un fichier DBM.

Valeur renvoy�e

htdbm renvoie 0 ("true") si les nom d'utilisateur et mot de passe ont �t� cr��s ou mis � jour avec succ�s dans le fichier DBM. htdbm 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 a �t� fourni interactivement et s'il est invalide pour l'entr�e consid�r�e, 4 si l'op�ration a �t� interrompue, 5 si une valeur est trop longue (nom utilisateur, nom fichier, mot de passe, ou l'enregistrement apr�s son �laboration), 6 si le nom d'utilisateur contient des caract�res ill�gaux (voir la section Restrictions), et 7 si le fichier n'est pas un fichier de mots de passe DBM valide.

Exemples

Ajoute ou modifie le mot de passe de l'utilisateur jsmith. Le mot de passe est demand� � l'op�rateur. Sous Windows, le mot de passe sera chiffr� en utilisant l'algorithme MD5 Apache modifi� ; dans les autres cas, c'est la routine crypt() du syst�me qui sera utilis�e. Si le fichier n'existe pas, htdbm s'arr�tera et renverra une erreur.

Cr�e un nouveau fichier 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 pas �tre lu, ou ne peut pas �tre �crit, il ne sera pas modifi� et htdbm affichera un message et renverra un code d'erreur.

Chiffre le mot de passe entr� avec la ligne de commande (Pwd4Steve) � l'aide de l'algorithme MD5, et l'enregistre dans le fichier sp�cifi�.

Consid�rations � propos de s�curit�

Les fichiers de mots de passe Web tels que ceux que g�re htdbm ne doivent pas �tre stock�s dans l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas �tre possible d'y acc�der � l'aide d'un navigateur.

L'utilisation de l'option -b est d�conseill�e, car lorsqu'il est utilis�, le mot de passe appara�t en clair dans la ligne de commande.

Notez que lorsque vous utilisez l'algorythme crypt(), seuls les 8 premiers caract�res du mot de passe sont pris en compte. Si le mot de passe fourni est plus long, les caract�res suppl�mentaires seront ignor�s sans avertissement.

L'algorythme SHA ne permet pas de sp�cifier une valeur d'initialisation pour la g�n�ration de nombres al�atoires (salting) : un mot de passe donn� ne poss�de ainsi qu'une r�pr�sentation chiffr�e. Les algorythmes crypt() et MD5 permettent quant � eux des repr�sentations chiffr�es multiples en acceptant comme param�tre une cha�ne d'initialisation (salt), rendant les attaques � base de dictionnaires contre les mots de passe plus difficiles.

Les algorythmes SHA et crypt() sont consid�r�s comme non s�rs selon les standards actuels.

Restrictions

Sur la plate-forme Windows, les mots de passe chiffr�s avec htdbm ont une taille limit�e � 255 caract�res. Si le mot de passe fourni est plus long, il sera tronqu� � 255 caract�res.

L'algorithme MD5 utilis� par htdbm est sp�cifique � Apache ; les mots de passe chiffr�s en utilisant cet algorithme seront inutilisables sur d'autres serveurs Web.

Les noms d'utilisateurs ont une taille limit�e � 255 octets et ne doivent pas contenir de caract�re :.