
Erweiterte Kryptobibliothek für descrypt, md5crypt, bcrypt und andere
libxcrypt ist eine moderne Bibliothek für das Einweg-Hashing von Passwörtern. Sie
unterstützt eine breite Vielfalt sowohl moderner als auch historischer Hash-Verfahren:
yescrypt, gost-yescrypt, sm3-yescrypt, scrypt, bcrypt, sha512crypt,
sha256crypt, sm3crypt, md5crypt, SunMD5, sha1crypt, NT, bsdicrypt,
bigcrypt und descrypt.
Sie stellt die traditionellen Unix-Schnittstellen crypt und crypt_r bereit,
sowie eine Reihe erweiterter Schnittstellen, die von Openwall Linux eingeführt wurden:
crypt_rn, crypt_ra, crypt_gensalt, crypt_gensalt_rn und
crypt_gensalt_ra.
libxcrypt ist für die Verwendung durch login(1), passwd(1) und andere
ähnliche Programme gedacht; das heißt, um eine kleine Anzahl von Passwörtern während
eines interaktiven Authentifizierungsdialogs mit einem Menschen zu hashen. Es ist nicht
für den Einsatz in Massen-Passwortknack-Anwendungen geeignet, oder in jeder
anderen Situation, in der Geschwindigkeit wichtiger ist als der sorgfältige Umgang mit
sensiblen Daten. Es ist jedoch dafür gedacht, schnell und leichtgewichtig
genug für den Einsatz auf Servern zu sein, die Tausende von Anmeldeversuchen
pro Minute bewältigen müssen.
libxcrypt wird derzeit von Björn Esser und Zack Weinberg gepflegt. Viele Menschen haben zum Code von libxcrypt beigetragen, oft unter der Schirmherrschaft eines anderen Projekts. Eine vollständige Liste der Danksagungen finden Sie in den Dateien AUTHORS und THANKS.
libxcrypt als Ganzes ist unter der GNU Lesser General Public License (Version 2.1 oder, nach Ihrer Wahl, jeder späteren Version) lizenziert. Viele einzelne Dateien können jedoch unter freizügigeren Lizenzen wiederverwendet werden, wenn sie von der Bibliothek getrennt werden. Eine umfassende Übersicht der Lizenzen finden Sie in der Datei LICENSING, und die Bedingungen der LGPL in COPYING.LIB.
libxcrypt wird derzeit auf Github gepflegt: die kanonische Repository- URL ist https://github.com/besser82/libxcrypt. Bitte reichen Sie Fehlerberichte unter https://github.com/besser82/libxcrypt/issues ein. Dies ist auch der geeignete Ort, um neue Funktionen vorzuschlagen, Patches anzubieten usw. Ihr gesamtes Feedback ist willkommen und wird schließlich eine Antwort erhalten, aber dies ist ein Freizeitprojekt für alle derzeitigen Betreuer, haben Sie also bitte Geduld.
Um aus einem Tarball-Release zu bauen, werden als Werkzeuge eine standardmäßige
Unix-Shell-Umgebung, ein C-Compiler und Perl (Version 5.14 oder
später) benötigt. Befolgen Sie die allgemeinen Build- und Installationsanweisungen in der
Datei INSTALL. Es gibt mehrere paketspezifische Konfigurationsoptionen;
führen Sie ./configure --help aus, um weitere Details zu diesen Optionen zu erhalten.
Führen Sie man -l crypt.5 aus, um weitere Details zu den Hash-Algorithmen zu erhalten, die
durch --enable-hashes aktiviert oder deaktiviert werden können. Sie können beides
tun, bevor Sie die Software bauen.
Das Bauen aus einem Git-Checkout erfordert zusätzlich die
Autotools-Suite: autoconf, automake, libtool und pkg-config.
Führen Sie ./autogen.sh im obersten Verzeichnis des Quellbaums aus und
befolgen Sie dann die Anweisungen in INSTALL (die durch diesen Befehl
erstellt wird).
Die ältesten Versionen der Autotools-Komponenten, von denen bekannt ist, dass sie funktionieren, sind: autoconf 2.69, automake 1.14, libtool 2.4.6, pkg-config 0.29. Wenn Sie mit einer älteren Version einer dieser Komponenten testen und feststellen, dass sie funktioniert, lassen Sie es uns bitte wissen. Wir verlangen nicht absichtlich neuere Versionen; wir können ältere Versionen lediglich nicht bequem selbst testen.
libxcrypt sollte mit jedem ISO C1999-konformen C-Compiler baubar sein,
mit einer entscheidenden Ausnahme: Die Symbolversionierungs-Makros in
crypt-port.h funktionieren nur mit Compilern, die bestimmte GCC- und
GNU-Binutils-Erweiterungen implementieren (__attribute__((alias)), GCC-artiges asm
und .symver).
Einige C2011-Features werden verwendet; die Absicht ist, keines davon ohne einen Fallback zu verwenden, aber wir testen dies derzeit nicht. Einige POSIX- und nicht standardisierte, aber weit verbreitete Unix-APIs werden ebenfalls verwendet; auch hier ist die Absicht, keine davon ohne einen Fallback zu verwenden, aber wir testen dies derzeit nicht. Insbesondere können die crypt_gensalt-Funktionen möglicherweise nicht immer kryptografisch einwandfreie Zufallszahlen vom Betriebssystem abrufen; wenn Sie diese Funktionen mit einem Nullzeiger für das Argument „rbytes“ aufrufen, seien Sie darauf vorbereitet, dass sie fehlschlagen.
Seit Mitte 2018 unterstützen GCC und LLVM keine Link-Time-Optimierung von
Bibliotheken, die Symbolversionierung verwenden. Wenn Sie libxcrypt mit
einem dieser Compiler bauen, verwenden Sie nicht -flto. Siehe GCC-Bug 48200
für Details; das Problem ist bei LLVM sehr ähnlich. Da dies im
Kern eine Reihe fehlender Compiler-Features ist, erwarten wir, dass Link-Time-
Optimierung auch in anderen C-Compilern nicht funktionieren wird, aber wir haben
es nicht selbst getestet.
Auf Linux-basierten Systemen ist libxcrypt standardmäßig binär abwärtskompatibel mit der libcrypt.so.1, die als Teil der GNU C Library ausgeliefert wird. Das bedeutet, dass alle vorhandenen binären ausführbaren Dateien, die gegen die libcrypt von glibc gelinkt sind, unverändert mit der libcrypt.so.1 dieser Bibliothek funktionieren sollten. Wir haben uns bemüht, genau dieselben Symbol- versionen bereitzustellen, die von glibc auf verschiedenen CPU-Architekturen verwendet wurden, und die Vielfalt der Arten zu berücksichtigen, in denen die Openwall-Erweiterungen von einigen Linux-Distributionen in die libcrypt von glibc eingepatcht wurden. (Zum Beispiel werden Kompatibilitäts-Symlinks für SUSE's „libowcrypt“ bereitgestellt.)
Das Umgekehrte gilt jedoch nicht: Programme, die gegen libxcrypt gelinkt sind,
funktionieren nicht mit der libcrypt von glibc. Außerdem können Programme, die bestimmte
von der libcrypt von glibc bereitgestellte Legacy-APIs verwenden (encrypt, encrypt_r,
setkey, setkey_r und fcrypt), nicht gegen
libxcrypt kompiliert werden.