【PHP8.x】openssl_dh_compute_key()関数の使い方

Copy
1<?php
2
3/**
4 * パスワードベースの鍵導出関数PBKDF2 (Password-Based Key Derivation Function 2) を使用して、
5 * 指定されたパスワードからセキュアな鍵を導出する関数。
6 *
7 * この関数は openssl_pbkdf2 を利用し、パスワード、ソルト、鍵の長さ、イテレーション回数、
8 * およびハッシュアルゴリズムを基に、暗号化などの用途に使用できる鍵を生成します。
9 * ブルートフォース攻撃や辞書攻撃に対する耐性を高めるために、高いイテレーション回数を推奨します。
10 *
11 * @param string $password 元のユーザーパスワード。
12 * @param int $keyLength 導出する鍵の長さ（バイト単位）。例: AES-256の場合は32バイト。
13 * @param int $iterations 鍵導出のイテレーション回数。セキュリティとパフォーマンスのバランスを考慮して設定します。
14 *                        現代の推奨値は100,000回以上です。
15 * @param string $digestAlgo 使用するハッシュアルゴリズム。例: 'sha256', 'sha512'。
16 * @return string|false 導出された鍵のバイナリ文字列、またはエラーが発生した場合は false。
17 */
18function deriveKeyFromPassword(
19    string $password,
20    int $keyLength = 32, // 鍵のデフォルト長: 32バイト (256ビット)
21    int $iterations = 100000, // デフォルトのイテレーション回数
22    string $digestAlgo = 'sha512' // デフォルトのハッシュアルゴリズム
23): string|false {
24    // セキュアなランダムなソルトを生成します。
25    // パスワードごとに異なるソルトを使用することが非常に重要です。
26    // ソルトは鍵導出時に使用され、生成された鍵とともに安全に保存する必要があります。
27    $salt = openssl_random_pseudo_bytes(16); // 16バイト (128ビット) のソルトを生成
28
29    if ($salt === false) {
30        // ソルトの生成に失敗した場合はエラーメッセージを出力し、処理を中止します。
31        error_log("エラー: openssl_random_pseudo_bytes() によるセキュアなソルトの生成に失敗しました。");
32        return false;
33    }
34
35    // openssl_pbkdf2関数を使用して鍵を導出します。
36    // 引数: パスワード、ソルト、鍵の長さ、イテレーション回数、ハッシュアルゴリズム。
37    $derivedKey = openssl_pbkdf2($password, $salt, $keyLength, $iterations, $digestAlgo);
38
39    if ($derivedKey === false) {
40        // 鍵の導出に失敗した場合はエラーメッセージを出力し、処理を中止します。
41        error_log("エラー: openssl_pbkdf2() による鍵の導出に失敗しました。");
42        return false;
43    }
44
45    // 導出された鍵はバイナリ形式です。
46    // 本番環境では、この鍵を直接保存するのではなく、暗号化などの目的で使用します。
47    // また、使用したソルトも鍵を再導出するために必要なので、安全に保存する必要があります。
48    return $derivedKey;
49}
50
51// --- サンプルコードの使用例 ---
52
53// ユーザーから入力されたパスワードと想定される文字列
54$userPassword = 'MySuperSecurePassword123!';
55
56echo "=== パスワードから暗号鍵を導出する例 ===\n\n";
57
58// パスワードから鍵を導出
59// デフォルトの鍵長(32バイト)、イテレーション回数(100000回)、ハッシュアルゴリズム(sha512)を使用
60$key = deriveKeyFromPassword($userPassword);
61
62if ($key !== false) {
63    echo "✔ 鍵の導出に成功しました。\n";
64    echo "  導出された鍵 (HEX表現): " . bin2hex($key) . "\n";
65    echo "  鍵の長さ: " . strlen($key) . " バイト\n";
66    echo "  (注意: セキュリティ上、導出された鍵とソルトは安全に管理してください。)\n";
67} else {
68    echo "✖ 鍵の導出に失敗しました。\n";
69}
70
71echo "\n--- 異なる設定での例 ---\n\n";
72
73$anotherPassword = 'AnotherSecretPassword!';
74$customKeyLength = 16;       // 16バイト (AES-128用)
75$customIterations = 200000;  // イテレーション回数を増やす
76$customDigestAlgo = 'sha256'; // SHA-256を使用
77
78$anotherKey = deriveKeyFromPassword(
79    $anotherPassword,
80    $customKeyLength,
81    $customIterations,
82    $customDigestAlgo
83);
84
85if ($anotherKey !== false) {
86    echo "✔ 鍵の導出に成功しました。\n";
87    echo "  導出された鍵 (HEX表現): " . bin2hex($anotherKey) . "\n";
88    echo "  鍵の長さ: " . strlen($anotherKey) . " バイト\n";
89    echo "  使用されたイテレーション回数: " . $customIterations . "\n";
90    echo "  使用されたハッシュアルゴリズム: " . $customDigestAlgo . "\n";
91} else {
92    echo "✖ 鍵の導出に失敗しました。\n";
93}
94
95?>

このサンプルコードは、PHPのopenssl_pbkdf2関数を用いて、パスワードからセキュアな暗号鍵を導出する方法を説明しています。openssl_pbkdf2は、パスワードベースの鍵導出関数PBKDF2（Password-Based Key Derivation Function 2）を実装しており、ブルートフォース攻撃や辞書攻撃に対する耐性を高めるために利用されます。

サンプルコード内のderiveKeyFromPassword関数は、元のユーザーパスワード、導出したい鍵の長さ、鍵導出処理のイテレーション回数、そして使用するハッシュアルゴリズムを引数として受け取ります。この関数はまず、openssl_random_pseudo_bytes関数を使用してセキュアでランダムなソルトを生成します。パスワードごとに異なるソルトを使用することは、セキュリティ上非常に重要です。

その後、生成したソルトと引数で受け取った情報をもとにopenssl_pbkdf2関数を呼び出し、実際の鍵導出を行います。イテレーション回数は、鍵導出処理の計算量を増やすことで、攻撃者がパスワードを推測するのにかかる時間を大幅に増加させます。現代では100,000回以上のイテレーションが推奨されています。

openssl_pbkdf2関数の戻り値は、導出された鍵のバイナリ文字列です。鍵の導出に失敗した場合はfalseが返されます。導出された鍵は、暗号化などの用途に利用され、ソルトと合わせて安全に管理する必要があります。このコードは、堅牢なセキュリティを必要とするアプリケーションでパスワードから鍵を生成する際の基本となります。