PHP
パスワードハッシュ関数

前書き

構文

• string password_hash ( string $password , integer $algo [, array $options ] )
• boolean password_verify ( string $password , string $hash )
• boolean password_needs_rehash ( string $hash , integer $algo [, array $options ] )
• array password_get_info ( string $hash )

備考

既存のパスワードハッシュをより強力なアルゴリズムにアップグレードできるかどうかを判断する

PASSWORD_DEFAULTメソッドを使用してシステムにパスワードをハッシュする最適なアルゴリズムを選択させる場合、強度がデフォルトで増加するため、ユーザーのログイン時に古いパスワードを再ハッシュしたい場合があります

<?php
// first determine if a supplied password is valid
if (password_verify($plaintextPassword, $hashedPassword)) {

    // now determine if the existing hash was created with an algorithm that is
    // no longer the default
    if (password_needs_rehash($hashedPassword, PASSWORD_DEFAULT)) {

        // create a new hash with the new default
        $newHashedPassword = password_hash($plaintextPassword, PASSWORD_DEFAULT);

        // and then save it to your data store
        //$db->update(...);
    }
}
?>

システムでpassword_ *関数が利用できない場合（以下の注釈にリンクされている互換性パックを使用することはできません）、アルゴリズムを決定して、次のような方法で元のハッシュを作成することができます。

<?php
if (substr($hashedPassword, 0, 4) == '$2y$' && strlen($hashedPassword) == 60) {
    echo 'Algorithm is Bcrypt';
    // the "cost" determines how strong this version of Bcrypt is
    preg_match('/\$2y\$(\d+)\$/', $hashedPassword, $matches);
    $cost = $matches[1];
    echo 'Bcrypt cost is '.$cost;
}
?>

パスワードハッシュの作成

password_hash()を使用して、現在の業界ベストプラクティスの標準ハッシュまたはキー派生を使用して、パスワードハッシュを作成します。書面では、標準はbcryptです。つまり、 PASSWORD_DEFAULTにはPASSWORD_DEFAULTと同じ値が含まれPASSWORD_BCRYPTます。

$options = [
    'cost' => 12,
];

$hashedPassword = password_hash($plaintextPassword, PASSWORD_DEFAULT, $options);

3番目のパラメータは必須ではありません 。

'cost'値は、運用サーバーのハードウェアに基づいて選択する必要があります。パスワードを増やすと、パスワードを生成するコストが高くなります。高価な人はそれを生成するためにそれを分解しようとする誰もがかかるように長い時間を生成することです。理想的には、コストは可能な限り高くする必要がありますが、実際にはすべてを遅くしないように設定する必要があります。 0.1秒から0.4秒の間のどこかに問題はありません。疑義がある場合は、デフォルト値を使用してください。

// this is a simple implementation of a bcrypt hash otherwise compatible
// with `password_hash()`
// not guaranteed to maintain the same cryptographic strength of the full `password_hash()`
// implementation

// if `CRYPT_BLOWFISH` is 1, that means bcrypt (which uses blowfish) is available
// on your system
if (CRYPT_BLOWFISH == 1) {
    $salt = mcrypt_create_iv(16, MCRYPT_DEV_URANDOM);
    $salt = base64_encode($salt);
    // crypt uses a modified base64 variant
    $source = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
    $dest = './ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
    $salt = strtr(rtrim($salt, '='), $source, $dest);
    $salt = substr($salt, 0, 22);
    // `crypt()` determines which hashing algorithm to use by the form of the salt string
    // that is passed in
    $hashedPassword = crypt($plaintextPassword, '$2y$10$'.$salt.'$');
}

パスワードハッシュ用の塩

暗号アルゴリズムの信頼性にもかかわらず、まだレインボーテーブルに対する脆弱性が存在します。それが塩を使うことが推奨される理由です。

saltとは、ハッシングの前にパスワードに付加されてソース文字列を一意にするものです。 2つの同一のパスワードが与えられた場合、結果として得られるハッシュは、その塩が一意であるためユニークなものになります。

ランダムな塩は、パスワードセキュリティの最も重要な部分の1つです。これは、既知のパスワードハッシュのルックアップテーブルであっても、ランダムな塩が使用されているため、攻撃者はデータベースのパスワードハッシュとユーザーのパスワードハッシュを一致させることができないことを意味します。あなたはいつも無作為かつ暗号的に安全な塩を使用するべきです。 続きを読む

password_hash() bcryptアルゴリズムを使用すると、結果のハッシュと一緒にプレーンテキストソルトが保存されます。つまり、ハッシュを異なるシステムやプラットフォームで転送して元のパスワードと照合することができます。

 $options = [
        'salt' => $salt, //see example below
 ];

ハッシュに対してパスワードを確認する

password_verify()は、既知のハッシュに対するパスワードの有効性を検証するために提供される組み込み関数password_verify() PHP 5.5以降）。

<?php
if (password_verify($plaintextPassword, $hashedPassword)) {
    echo 'Valid Password';
}
else {
    echo 'Invalid Password.';
}
?>

サポートされているすべてのハッシュアルゴリズムは、ハッシュ自体で使用されたハッシュを識別する情報を格納するため、平文パスワードをエンコードするために使用するアルゴリズムを指定する必要はありません。

あなたのシステムでpassword_ *関数が利用できない場合（以下の注釈にリンクされている互換性パックを使用することはできません）、 crypt()関数を使ってパスワード検証を実装することができます。 タイミング攻撃を避けるために、特定の予防策を講じなければならないことに注意してください。

<?php
// not guaranteed to maintain the same cryptographic strength of the full `password_hash()`
// implementation
if (CRYPT_BLOWFISH == 1) {
    // `crypt()` discards all characters beyond the salt length, so we can pass in
    // the full hashed password
    $hashedCheck = crypt($plaintextPassword, $hashedPassword);

    // this a basic constant-time comparison based on the full implementation used
    // in `password_hash()`
    $status = 0;
    for ($i=0; $i<strlen($hashedCheck); $i++) {
        $status |= (ord($hashedCheck[$i]) ^ ord($hashedPassword[$i]));
    }

    if ($status === 0) {
        echo 'Valid Password';
    }
    else {
        echo 'Invalid Password';
    }
}
?>