
Расширенная криптографическая библиотека для descrypt, md5crypt, bcrypt и других.
libxcrypt — это современная библиотека для одностороннего хеширования паролей. Она
поддерживает широкий спектр как современных, так и исторических методов хеширования:
yescrypt, gost-yescrypt, sm3-yescrypt, scrypt, bcrypt, sha512crypt,
sha256crypt, sm3crypt, md5crypt, SunMD5, sha1crypt, NT, bsdicrypt,
bigcrypt и descrypt.
Она предоставляет традиционные Unix-интерфейсы crypt и crypt_r, а
также набор расширенных интерфейсов, впервые предложенных в Openwall Linux:
crypt_rn, crypt_ra, crypt_gensalt, crypt_gensalt_rn и
crypt_gensalt_ra.
libxcrypt предназначена для использования в login(1), passwd(1) и других
подобных программах; то есть для хеширования небольшого числа паролей во время
интерактивного диалога аутентификации с человеком. Она не
подходит для использования в приложениях массового взлома паролей или в любой
другой ситуации, где скорость важнее осторожного обращения с
конфиденциальными данными. Однако она предназначена быть достаточно быстрой и лёгкой
для использования на серверах, которые должны обрабатывать тысячи попыток входа
в минуту.
В настоящее время libxcrypt поддерживается Бьёрном Эссером (Björn Esser) и Заком Вайнбергом (Zack Weinberg). Многие люди внесли вклад в код, составляющий libxcrypt, часто под эгидой другого проекта. Полный список авторов см. в файлах AUTHORS и THANKS.
libxcrypt в целом распространяется под лицензией GNU Lesser General Public License (версия 2.1 или, по вашему выбору, любая более поздняя версия). Однако многие отдельные файлы могут быть повторно использованы под более разрешительными лицензиями, если они отделены от библиотеки. Полный перечень лицензий см. в файле LICENSING, а условия LGPL — в COPYING.LIB.
В настоящее время libxcrypt поддерживается на Github: канонический URL репозитория — https://github.com/besser82/libxcrypt. Пожалуйста, сообщайте об ошибках по адресу https://github.com/besser82/libxcrypt/issues. Это также подходящее место для предложения новых функций, отправки патчей и т. д. Мы приветствуем любые ваши отзывы, и в конечном итоге они получат ответ, но это проект, которым все нынешние сопровождающие занимаются в свободное время, поэтому, пожалуйста, будьте терпеливы.
Для сборки из релизного tarball требуются стандартное
окружение Unix shell, компилятор C и Perl (версия 5.14 или
позднее). Следуйте общим инструкциям по сборке и установке в
файле INSTALL. Существует несколько специфичных для пакета опций configure;
запустите ./configure --help, чтобы узнать о них подробнее.
Запустите man -l crypt.5, чтобы узнать больше об алгоритмах хеширования, которые
можно включить или отключить с помощью --enable-hashes. Обе эти вещи можно сделать
до сборки программного обеспечения.
Сборка из Git-репозитория дополнительно требует набора Autotools:
autoconf, automake, libtool и pkg-config.
Запустите ./autogen.sh в корне дерева исходного кода, а затем
следуйте инструкциям в INSTALL (который создаётся этой командой).
Наиболее старые версии компонентов Autotools, о которых известно, что они работают: autoconf 2.69, automake 1.14, libtool 2.4.6, pkg-config 0.29. Если вы протестируете более старую версию одного из них и обнаружите, что она работает, пожалуйста, сообщите нам. Мы не требуем намеренно более новых версий; мы просто не можем удобно тестировать более старые версии самостоятельно.
libxcrypt должен собираться любым C-компилятором, совместимым с ISO C1999,
с одним важным исключением: макросы версионирования символов в
crypt-port.h работают только с компиляторами, реализующими определённые расширения GCC и
GNU Binutils (__attribute__((alias)), asm в стиле GCC
и .symver).
Используется несколько возможностей C2011; намерение состоит в том, чтобы не использовать ни одну из них без запасного варианта, но в настоящее время мы это не тестируем. Также используется несколько POSIX- и нестандартных, но широко распространённых Unix API; опять же, намерение состоит в том, чтобы не использовать ни один из них без запасного варианта, но в настоящее время мы это не тестируем. В частности, функции crypt_gensalt могут не всегда иметь возможность получить криптографически стойкие случайные числа из операционной системы; если вы вызываете эти функции с нулевым указателем в аргументе «rbytes», будьте готовы к тому, что они завершатся с ошибкой.
По состоянию на середину 2018 года GCC и LLVM не поддерживают оптимизацию на этапе компоновки
для библиотек, использующих версионирование символов. Если вы собираете libxcrypt
любым из этих компиляторов, не используйте -flto. Подробности см. в ошибке GCC 48200;
для LLVM проблема очень похожа. Поскольку в своей основе это
набор недостающих возможностей компилятора, мы ожидаем, что оптимизация на этапе компоновки
не будет работать и в других C-компиляторах, но мы не
тестировали это самостоятельно.
В системах на базе Linux по умолчанию libxcrypt будет двоично обратно совместим с libcrypt.so.1, поставляемой в составе GNU C Library. Это означает, что все существующие двоичные исполняемые файлы, скомпонованные с libcrypt от glibc, должны работать без изменений с libcrypt.so.1 этой библиотеки. Мы приложили усилия, чтобы обеспечить точно такие же версии символов, какие использовались glibc на различных архитектурах процессоров, и чтобы учесть разнообразие способов, которыми расширения Openwall были внесены в libcrypt от glibc некоторыми дистрибутивами Linux. (Например, предоставляются символьные ссылки совместимости для «libowcrypt» от SUSE.)
Однако обратное неверно: программы, скомпонованные с libxcrypt,
не будут работать с libcrypt от glibc. Кроме того, программы, использующие определённые
устаревшие API, предоставляемые libcrypt от glibc (encrypt, encrypt_r,
setkey, setkey_r и fcrypt), не могут быть скомпилированы с
libxcrypt.
Двоичную обратную совместимость можно отключить, передав
configure ключ --disable-obsolete-api, и в этом случае libxcrypt
установит libcrypt.so.2 вместо libcrypt.so.1. Эта
конфигурация всегда используется во всех операционных системах, кроме
Linux. Мы готовы рассмотреть добавление двоичной обратной
совместимости с существующими libcrypt других операционных систем, но
в настоящее время не планируем выполнять эту работу самостоятельно.