
descrypt、md5crypt、bcrypt などのための拡張 crypt ライブラリ
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 シェル環境、
C コンパイラ、および Perl (バージョン 5.14 以降) です。ファイル INSTALL
にある一般的なビルドおよびインストール手順に従ってください。パッケージ固有の
configure オプションがいくつかあります。これらのオプションの詳細については
./configure --help を実行してください。
--enable-hashes で有効化または無効化できるハッシュアルゴリズムの詳細に
ついては man -l crypt.5 を実行してください。これらの作業はどちらも
ソフトウェアをビルドする前に行えます。
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 は、ISO C1999 準拠の C コンパイラであればどれでもビルドできる
はずですが、重大な例外が 1 つあります。crypt-port.h 内のシンボル
バージョニングマクロは、特定の GCC および GNU Binutils 拡張
(__attribute__((alias))、GCC 形式の asm、.symver)を実装した
コンパイラでしか動作しません。
C2011 の機能がいくつか使用されています。フォールバックなしでこれらを 使う意図はありませんが、現時点ではこれをテストしていません。また、 いくつかの POSIX および非標準ながら広く普及している Unix API も使用 されています。これについても同様に、フォールバックなしで使う意図は ありませんが、現時点ではテストしていません。特に、crypt_gensalt 系の 関数は、オペレーティングシステムから暗号学的に安全な乱数を常に取得 できるとは限りません。「rbytes」引数にヌルポインタを渡してこれらの 関数を呼び出す場合は、失敗する可能性を想定してください。
2018 年半ばの時点で、GCC と LLVM はシンボルバージョニングを使用する
ライブラリのリンク時最適化をサポートしていません。これらのコンパイラの
いずれかで libxcrypt をビルドする場合は、-flto を使用しないでください。
詳細は GCC bug 48200 を参照してください。LLVM でも問題は非常に
よく似ています。これは根本的にはコンパイラの機能不足によるものなので、
他の C コンパイラでもリンク時最適化は動作しないと予想していますが、
私たち自身ではテストしていません。
Linux ベースのシステムでは、デフォルトで libxcrypt は GNU C Library の 一部として提供される libcrypt.so.1 とバイナリ後方互換になります。つまり、 glibc の libcrypt に対してリンクされた既存のバイナリ実行ファイルはすべて、 このライブラリの libcrypt.so.1 で変更なしに動作するはずです。私たちは、 さまざまな CPU アーキテクチャ上で glibc が使用していたものとまったく同じ シンボルバージョンを提供し、一部の Linux ディストリビューションによって Openwall 拡張が glibc の libcrypt にパッチとして組み込まれた多様な方法に 対応するよう、苦労してきました。(たとえば、SUSE の「libowcrypt」用の 互換シンボリックリンクが提供されています。)
しかし、その逆は成り立ちません。libxcrypt に対してリンクされたプログラムは、
glibc の libcrypt では動作しません。また、glibc の libcrypt が提供する
特定のレガシー API(encrypt、encrypt_r、setkey、setkey_r、fcrypt)
を使用するプログラムは、libxcrypt に対してコンパイルすることはできません。
バイナリ後方互換性は、configure に --disable-obsolete-api スイッチを
指定することで無効にできます。この場合、libxcrypt は libcrypt.so.1 の
代わりに libcrypt.so.2 をインストールします。この構成は、Linux 以外の
すべてのオペレーティングシステムで常に使用されます。他のオペレーティング
システムの既存の libcrypt に対するバイナリ後方互換性の追加を検討する用意は
ありますが、現時点ではその作業を私たち自身で行う予定はありません。
個々のハッシュ関数は、configure に --enable-hashes スイッチを指定する
ことで有効または無効にできます。デフォルトでは、サポートされているすべての
ハッシュが有効になります。従来の「des」ハッシュアルゴリズムを無効にすると、
--disable-obsolete-api が暗黙的に指定されます。後方互換性の制約がない
セキュリティを重視する環境では、--enable-hashes=strong の使用を推奨します。
これは、新しくハッシュ化されるパスワードに対して安全であるのに十分な強度を
持つハッシュ関数のみを有効にします。
SunMD5ハッシュアルゴリズムの元の実装にはバグがあり、libxcryptは(Open)Solaris上で生成されたハッシュとの完全な互換性を保つためにこのバグを模倣しています。このアルゴリズムに関する唯一現存するドキュメントによれば、そのハッシュは$md5[,rounds=%u]$<salt>$<checksum>という形式であるべきで、ソルトダイジェストのステップには裸の文字列$md5[,rounds=%u]$<salt>のみを含めることになっていました。しかし、本番環境で遭遇するハッシュのほとんどは$md5[,rounds=%u]$<salt>$$<checksum>という形式です(二重の$$に注意)。残念ながら、これは単なる見た目の違いではありません。この形式のハッシュはソルトダイジェストのステップでソルトの後の最初の$を取り込むため、結果として得られるチェックサムが異なります。ドキュメントは、これが本番実装のパーサー内のバグに起因することを示唆しています。このバグにより、実装は$で終わる設定文字列を渡されると$$形式のハッシュを返します。意図された元の形式とチェックサムを返すのは、$の後に少なくとも1文字ある場合のみです。例えば$md5[,rounds=%u]$<salt>$xのように。
NTアルゴリズムは、その元の実装では、アルゴリズムがソルトを一切使用しないため、gensalt関数を備えていませんでした。libxcryptはNTアルゴリズム用に、単に$3$を返すだけの偽のgensalt関数を同梱しています。
glibcのlibcryptは、オプションでMozillaのNSSライブラリによる暗号プリミティブmd5crypt、sha256crypt、sha512cryptの実装を使用するように設定できました。このオプションはlibxcryptでは利用できません。現時点でそれが望ましいオプションであるとは考えていないためです。このオプションの明示された根拠は、FIPS認証を受けたライブラリからすべての暗号プリミティブを調達することでしたが、FIPS認証が意味を持つためにはlibxcrypt自体の全体を対象とする必要があると考えています。さらに、最強のハッシュ方式であるyescryptとbcryptは、NSSでは利用できない暗号プリミティブを使用しているため、認証は、願わくば最も使用されるであろうコードパスのいかなる部分も対象としないことになります。