
Bibliothèque crypt étendue pour descrypt, md5crypt, bcrypt et autres
libxcrypt est une bibliothèque moderne pour le hachage à sens unique des mots de passe. Elle prend en charge une grande variété de méthodes de hachage modernes et historiques : yescrypt, gost-yescrypt, sm3-yescrypt, scrypt, bcrypt, sha512crypt, sha256crypt, sm3crypt, md5crypt, SunMD5, sha1crypt, NT, bsdicrypt, bigcrypt et descrypt.
Elle fournit les interfaces Unix traditionnelles crypt et crypt_r, ainsi qu'un ensemble d'interfaces étendues introduites par Openwall Linux, crypt_rn, crypt_ra, crypt_gensalt, crypt_gensalt_rn et crypt_gensalt_ra.
libxcrypt est destinée à être utilisée par login(1), passwd(1) et d'autres programmes similaires ; c'est-à-dire pour hacher un petit nombre de mots de passe lors d'un dialogue d'authentification interactif avec un humain. Elle ne convient pas aux applications de cassage de mots de passe en masse, ni à toute autre situation où la vitesse importe plus qu'un traitement soigneux de données sensibles. Cependant, elle est conçue pour être suffisamment rapide et légère pour être utilisée sur des serveurs qui doivent traiter des milliers de tentatives de connexion par minute.
libxcrypt est actuellement maintenue par Björn Esser et Zack Weinberg. De nombreuses personnes ont contribué au code constituant libxcrypt, souvent sous l'égide d'un autre projet. Veuillez consulter les fichiers AUTHORS et THANKS pour la liste complète des crédits.
libxcrypt dans son ensemble est distribué sous la licence GNU Lesser General Public License (version 2.1, ou à votre choix, toute version ultérieure). Cependant, de nombreux fichiers individuels peuvent être réutilisés sous des licences plus permissives s'ils sont séparés de la bibliothèque. Veuillez consulter le fichier LICENSING pour un inventaire complet des licences, et COPYING.LIB pour les termes de la LGPL.
libxcrypt est actuellement maintenue sur Github : l'URL du dépôt canonique est https://github.com/besser82/libxcrypt. Veuillez signaler les bogues à l'adresse https://github.com/besser82/libxcrypt/issues. C'est également l'endroit approprié pour suggérer de nouvelles fonctionnalités, proposer des correctifs, etc. Tous vos retours sont les bienvenus et finiront par recevoir une réponse, mais il s'agit d'un projet sur temps libre pour tous les mainteneurs actuels, alors veuillez être patients.
Pour compiler à partir d'une archive tarball, les outils requis sont un environnement shell Unix standard, un compilateur C et Perl (version 5.14 ou ultérieure). Suivez les instructions génériques de compilation et d'installation du fichier INSTALL. Plusieurs options de configuration spécifiques aux paquets sont disponibles ; exécutez ./configure --help pour plus de détails sur ces options.
Exécutez man -l crypt.5 pour plus de détails sur les algorithmes de hachage qui peuvent être activés ou désactivés via --enable-hashes. Vous pouvez effectuer ces deux actions avant de compiler le logiciel.
La compilation à partir d'une copie de travail Git nécessite en plus la suite Autotools : autoconf, automake, libtool et pkg-config. Exécutez ./autogen.sh à la racine de l'arborescence des sources, puis suivez les instructions du fichier INSTALL (qui est créé par cette commande).
Les plus anciennes versions des composants Autotools connues pour fonctionner sont : autoconf 2.69, automake 1.14, libtool 2.4.6, pkg-config 0.29. Si vous testez avec une version plus ancienne de l'un de ces composants et constatez qu'elle fonctionne, merci de nous le faire savoir. Nous n'exigeons pas délibérément des versions plus récentes ; nous ne pouvons simplement pas tester commodément les versions plus anciennes nous-mêmes.
libxcrypt devrait pouvoir être compilé avec n'importe quel compilateur C conforme à la norme ISO C1999, à une exception critique près : les macros de versionnement de symboles dans crypt-port.h ne fonctionnent qu'avec les compilateurs qui implémentent certaines extensions GCC et GNU Binutils (__attribute__((alias)), l'asm de style GCC et .symver).
Quelques fonctionnalités de C2011 sont utilisées ; l'intention n'est pas d'en utiliser une seule sans solution de repli, mais nous ne testons pas cela actuellement. Quelques API Unix POSIX et non standard mais largement répandues sont également utilisées ; là encore, l'intention n'est pas d'en utiliser une seule sans solution de repli, mais nous ne testons pas cela actuellement. En particulier, les fonctions crypt_gensalt peuvent ne pas toujours être en mesure de récupérer des nombres aléatoires cryptographiquement sûrs auprès du système d'exploitation ; si vous appelez ces fonctions avec un pointeur nul pour l'argument « rbytes », préparez-vous à ce qu'elles échouent.
Depuis mi-2018, GCC et LLVM ne prennent pas en charge l'optimisation à l'édition de liens des bibliothèques qui utilisent le versionnement de symboles. Si vous compilez libxcrypt avec l'un de ces compilateurs, n'utilisez pas -flto. Voir le bogue GCC 48200 pour les détails ; le problème est très similaire avec LLVM. Comme il s'agit, à la racine, d'un ensemble de fonctionnalités manquantes dans les compilateurs, nous nous attendons à ce que l'optimisation à l'édition de liens ne fonctionne pas non plus avec d'autres compilateurs C, mais nous ne l'avons pas testé nous-mêmes.
Sur les systèmes basés sur Linux, par défaut libxcrypt sera rétrocompatible au niveau binaire avec la libcrypt.so.1 fournie avec la bibliothèque C GNU. Cela signifie que tous les exécutables binaires existants liés à la libcrypt de glibc devraient fonctionner sans modification avec la libcrypt.so.1 de cette bibliothèque. Nous nous sommes efforcés de fournir exactement les mêmes versions de symboles que celles utilisées par glibc sur les différentes architectures de processeurs, et de tenir compte des diverses manières dont les extensions Openwall ont été intégrées à la libcrypt de glibc par certaines distributions Linux. (Par exemple, des liens symboliques de compatibilité pour la « libowcrypt » de SUSE sont fournis.)