crypt
(PHP 4, PHP 5, PHP 7)
crypt — 文字列の一方向のハッシュ化を行う
説明
string crypt
( string $str
[, string $salt
] )
salt
パラメータは必須ではありませんが、これを省略すると
crypt() が作るハッシュが弱いものになってしまいます。
PHP 5.6 以降は、このパラメータを省略した場合に E_NOTICE が発生するようになりました。
十分に強いソルトを指定して、セキュリティを確保しましょう。
password_hash() は、強力なハッシュを使い、協力なソルトを生成して、それを複数回自動的に適用します。
password_hash() は crypt() のシンプルなラッパーであり、既存のパスワードハッシュと互換性があります。
password_hash() を使うことを推奨します。
複数のハッシュ方式をサポートしているオペレーティングシステムもあります。
実際、標準の DES ベースのアルゴリズムを MD5 ベースのものに置き換えることもあります。
ハッシュ方式は、salt 引数によって決まります。
PHP 5.3 より前のバージョンでは、PHP のインストール時に、
システムの crypt() 関数から使用できるアルゴリズムを判別します。
salt を省略した場合は、標準の 2 文字 (DES) の salt を自動生成します。
あるいは、MD5 crypt() が使えれば 12 文字 (MD5) の salt を自動生成します。
PHP の定数 CRYPT_SALT_LENGTH
には、
ハッシュで使用できる salt の最大長が格納されています。
標準の DES ベースの場合、crypt()
は出力の最初の 2 文字を salt として使用します。また、
str
の最初の 8 文字しか使用しません。
つまり、最初の 8 文字が同じである長い文字列は、
同じ salt を使う限り同じ結果となります。
crypt() が複数のハッシュ方式をサポートしているシステムでは、
その方式が使用可能かどうかによって次の定数群が
0 か 1 に設定されます。
-
CRYPT_STD_DES
- 標準の DES ベースのハッシュで、
アルファベット "./0-9A-Za-z" からなる 2 文字の salt を使用するもの。
salt として無効な文字を使うと crypt() は失敗します。
-
CRYPT_EXT_DES
- 拡張した DES ベースのハッシュ。"salt" は 9 文字で、
アンダースコアの後に 4 バイトの反復回数と 4 バイトの salt が続きます。
これらが表示可能な文字にエンコードされます。一文字あたり 6 ビットで、
下位の文字から順に並びます。
0 から 63 までの値は "./0-9A-Za-z" とエンコードされます。
salt に無効な文字を使うと crypt() は失敗します。
-
CRYPT_MD5
- $1$ ではじまる 12 文字の salt を使用する MD5 ハッシュ。
-
CRYPT_BLOWFISH
- Blowfish ハッシュ。salt の形式は、
"$2a$" か "$2x$" あるいは "$2y$"、2 桁のコストパラメータ、"$"、そして文字 "./0-9A-Za-z"
からなる 22 文字となります。
この範囲外の文字を salt に使うと、crypt() は長さゼロの文字列を返します。
2 桁のコストパラメータは反復回数の 2 を底とする対数で、
これは Blowfish ベースのハッシュアルゴリズムで使います。
この値は 04 から 31 までの範囲でなければならず、
それ以外の値の場合は crypt() は失敗します。
5.3.7 までのバージョンの PHP では、salt のプレフィックスとして "$2a$"
だけしか使えませんでした。PHP 5.3.7 で新たなプレフィックスが導入され、
Blowfish の実装にあったセキュリティ上の弱点に対応しました。
セキュリティ修正の対応の詳細については
» この文書 を参照ください。
簡単にまとめると、PHP 5.3.7 以降しか使わないのなら
"$2a$" ではなく "$2y$" を使うべきだということです。
-
CRYPT_SHA256
- SHA-256 ハッシュに
$5$ で始まる 16 文字の salt を組み合わせたもの。salt 文字列が
'rounds=<N>$' で始まる場合は、数値 N がハッシュループの実行回数を表します。
これは Blowfish のコストパラメータのようなものです。
rounds のデフォルトは 5000 で、1000 から 999,999,999 までの値を指定できます。
この範囲外の N を指定すると、近い方の境界値に切り詰められます。
-
CRYPT_SHA512
- SHA-512 ハッシュに
$6$ で始まる 16 文字の salt を組み合わせたもの。salt 文字列が
'rounds=<N>$' で始まる場合は、数値 N がハッシュループの実行回数を表します。
これは Blowfish のコストパラメータのようなものです。
rounds のデフォルトは 5000 で、1000 から 999,999,999 までの値を指定できます。
この範囲外の N を指定すると、近い方の境界値に切り詰められます。
注意:
PHP 5.3.0 以降、PHP 自身にもそれぞれの実装が含まれるようになりました。
システム側でそのアルゴリズムがサポートされていない場合にこの実装を使用します。
パラメータ
-
str
-
ハッシュしたい文字列。
警告
CRYPT_BLOWFISH
を使うと、
str
が最大 72 文字までに切り詰められます。
-
salt
-
ハッシュのもととなる salt 文字列。省略した場合の挙動は
アルゴリズムの実装によって決まるので、予期せぬ結果となることがあり得ます。
返り値
ハッシュした文字列を返します。
失敗した場合は、salt とは異なることが保証されている 13 文字未満の文字列を返します。
警告
パスワードを検証するときの文字列比較関数は、
タイミング攻撃に対して脆弱ではないものでなければいけません。
これをもちいて、crypt() の出力と既知のハッシュとを比較します。
PHP 5.6 以降には、このために使える hash_equals() 関数が追加されました。
例
例1 crypt() の例
<?php
$hashed_password = crypt('mypassword'); // saltを自動的に生成させます
/* 異なったハッシュアルゴリズムが使用された際の問題を避けるために
crypt()の結果全体をパスワード比較用のsaltとして渡す必要があります。
(上記のように標準DESに基づくパスワードハッシュは2文字のsaltを使用します
が、MD5に基づくハッシュは12文字のsaltを使用します) */
if (hash_equals($hashed_password, crypt($user_input, $hashed_password))) {
echo "Password verified!";
}
?>
例2 crypt() を htpasswd で使用する例
<?php
// パスワードを設定します
$password = 'mypassword';
// ハッシュを取得します。salt は自動生成させます
$hash = crypt($password);
?>
例3 異なるハッシュ形式を用いた crypt() の例
<?php
/* これらの salt はあくまでも一例として示したものであり、実際のコードにそのまま使ってはいけません。
別の、適切な形式の salt を生成して各パスワードに使いましょう。
*/
if (CRYPT_STD_DES == 1) {
echo 'Standard DES: ' . crypt('rasmuslerdorf', 'rl') . "\n";
}
if (CRYPT_EXT_DES == 1) {
echo 'Extended DES: ' . crypt('rasmuslerdorf', '_J9..rasm') . "\n";
}
if (CRYPT_MD5 == 1) {
echo 'MD5: ' . crypt('rasmuslerdorf', '$1$rasmusle$') . "\n";
}
if (CRYPT_BLOWFISH == 1) {
echo 'Blowfish: ' . crypt('rasmuslerdorf', '$2a$07$usesomesillystringforsalt$') . "\n";
}
if (CRYPT_SHA256 == 1) {
echo 'SHA-256: ' . crypt('rasmuslerdorf', '$5$rounds=5000$usesomesillystringforsalt$') . "\n";
}
if (CRYPT_SHA512 == 1) {
echo 'SHA-512: ' . crypt('rasmuslerdorf', '$6$rounds=5000$usesomesillystringforsalt$') . "\n";
}
?>
Standard DES: rl.3StKT.4T8M
Extended DES: _J9..rasmBYk8r9AiWNc
MD5: $1$rasmusle$rISCgZzpwk3UhDidwXvin0
Blowfish: $2a$07$usesomesillystringfore2uDLvp1Ii2e./U9C8sBjqp8I90dH6hi
SHA-256: $5$rounds=5000$usesomesillystri$KqJWpanXZHKq2BOB43TSaYhEWsQ1Lr5QNyPCDH/Tp.6
SHA-512: $6$rounds=5000$usesomesillystri$D4IrlXatmP7rx3P3InaxBeoomnAihCKRVQP22JZ6EY47Wc6BkroIuUUBOov1i.S5KPgErtP/EN5mcO.ChWQW21
注意
注意:
復号するための関数はありません。
crypt() が使用しているのは単方向アルゴリズムだからです。