【PHP8.x】OPENSSL_CIPHER_RC2_40定数の使い方

Copy
1<?php
2
3/**
4 * OPENSSL_CIPHER_RC2_40 定数を使用して、RC2_40暗号アルゴリズムの
5 * 初期化ベクトル（IV）の長さを取得し、表示します。
6 *
7 * IV（Initialization Vector）は、同じ平文と鍵を使用しても異なる暗号文を生成するために使われる
8 * ランダムなデータです。openssl_cipher_iv_length 関数は、特定の暗号アルゴリズムに
9 * 必要なIVのバイト数を返します。
10 *
11 * システムエンジニアを目指す初心者の方へ:
12 * このコードは、PHPの定数（OPENSSL_CIPHER_RC2_40）を、
13 * ある機能（openssl_cipher_iv_length）に渡して結果を得る、
14 * というプログラミングの基本的なパターンを示しています。
15 * 定数は、特定の値を名前で参照するためのもので、プログラムの可読性を高めます。
16 */
17function getOpensslRc240CipherIvLength(): void
18{
19    // OPENSSL_CIPHER_RC2_40 は、RC2暗号アルゴリズム（鍵長40ビット）を識別する定数です。
20    // この定数を openssl_cipher_iv_length 関数に渡すことで、
21    // この暗号アルゴリズムに必要なIVの長さを取得できます。
22    $ivLength = openssl_cipher_iv_length(OPENSSL_CIPHER_RC2_40);
23
24    if ($ivLength === false) {
25        // openssl_cipher_iv_length が false を返した場合、エラーが発生したことを意味します。
26        echo "エラー: OPENSSL_CIPHER_RC2_40 のIV長を取得できませんでした。\n";
27    } else {
28        // 取得したIVの長さを表示します。
29        echo "OPENSSL_CIPHER_RC2_40 のIVの長さ: " . $ivLength . " バイト\n";
30    }
31}
32
33// 上記で定義した関数を実行します。
34getOpensslRc240CipherIvLength();

このPHPコードは、特定の暗号アルゴリズムであるRC2（鍵長40ビット）の初期化ベクトル（IV）の長さを取得し、表示するものです。OPENSSL_CIPHER_RC2_40は、この「RC2_40」という暗号アルゴリズムを識別するためにPHPで定義された定数です。定数は、特定の値を名前で参照できるようにするもので、プログラムの可読性を高める役割があります。

コードの中心となるopenssl_cipher_iv_length関数は、引数として暗号アルゴリズムの識別子（ここではOPENSSL_CIPHER_RC2_40定数）を受け取ります。そして、そのアルゴリズムで暗号化を行う際に必要となるIVのバイト数を整数値として戻り値で返します。IV（Initialization Vector）は、同じ平文と鍵を使っても毎回異なる暗号文が生成されるようにするためのランダムなデータです。もしこの関数がIV長を取得できなかった場合は、エラーを示すfalseが戻り値として返されます。

サンプルコードでは、openssl_cipher_iv_length関数にOPENSSL_CIPHER_RC2_40定数を渡し、取得したIV長を変数に格納しています。その後、戻り値がfalseでないかを確認し、エラーがなければその長さを画面に表示します。このコードは、定数を使って関数に情報を渡し、その結果を受け取って処理するという、プログラミングの基本的なパターンを分かりやすく示しています。

Copy
1<?php
2
3/**
4 * AES-256-CBC 暗号方式を使用して文字列を安全に暗号化・復号化する関数。
5 * システムエンジニアを目指す初心者向けに、基本的な暗号化の流れを示します。
6 *
7 * @param string $data 暗号化・復号化する元の文字列（平文）。
8 * @param string $key  暗号化に使用する秘密鍵。AES-256-CBC では32バイト（256ビット）の鍵が必要です。
9 *                     openssl_random_pseudo_bytes() など、安全な方法で生成し、厳重に管理してください。
10 * @return array|false 成功した場合は ['encrypted' => string, 'decrypted' => string] を返し、
11 *                     失敗した場合は false を返します。
12 */
13function encryptDecryptAes256Cbc(string $data, string $key): array|false
14{
15    // 使用する暗号方式を定義 (キーワードに合わせ 'aes-256-cbc' を使用)
16    $cipherAlgo = 'aes-256-cbc';
17
18    // IV (Initialization Vector) の長さを取得
19    // IVは暗号化のたびにユニークであるべきですが、秘密にする必要はありません。
20    // 暗号文と一緒に送信され、復号化の際に使用されます。
21    $ivLength = openssl_cipher_iv_length($cipherAlgo);
22    if ($ivLength === false) {
23        error_log("Error: Failed to get IV length for cipher method: {$cipherAlgo}");
24        return false;
25    }
26
27    // IV (Initialization Vector) を生成
28    // openssl_random_pseudo_bytes() で安全なランダムなバイト列を生成します。
29    $iv = openssl_random_pseudo_bytes($ivLength);
30    if ($iv === false) {
31        error_log("Error: Failed to generate IV.");
32        return false;
33    }
34
35    // 鍵の長さを確認（AES-256-CBC の場合は32バイト）
36    // 鍵の長さが正しくないと、暗号化・復号化が失敗するか、セキュリティが低下します。
37    if (mb_strlen($key, '8bit') !== 32) {
38        error_log("Error: Key must be 32 bytes for AES-256-CBC. Current key length is " . mb_strlen($key, '8bit') . " bytes.");
39        return false;
40    }
41
42    // データの暗号化
43    // OPENSSL_RAW_DATA: 暗号文を生データ形式で返します。
44    // openssl_encrypt の戻り値はバイナリデータなので、そのままでは表示や転送に不向きです。
45    $encryptedRaw = openssl_encrypt($data, $cipherAlgo, $key, OPENSSL_RAW_DATA, $iv);
46    if ($encryptedRaw === false) {
47        error_log("Error: Encryption failed: " . openssl_error_string());
48        return false;
49    }
50
51    // 暗号化されたデータ (IV + 暗号文) を Base64 エンコードして保存・転送可能な形式にする
52    // IVは暗号文の先頭に付与し、まとめてBase64エンコードします。
53    // 復号化の際に、このBase64データからIVと暗号文を分離します。
54    $encryptedBase64 = base64_encode($iv . $encryptedRaw);
55
56    // --- ここから復号化の処理 ---
57
58    // Base64エンコードされたデータからIVと暗号文を分離
59    $decodedData = base64_decode($encryptedBase64);
60    if ($decodedData === false) {
61        error_log("Error: Failed to base64 decode encrypted data.");
62        return false;
63    }
64    
65    $ivFromEncrypted = substr($decodedData, 0, $ivLength);
66    $encryptedDataFromEncoded = substr($decodedData, $ivLength);
67
68    // データの復号化
69    // 暗号化時と同じ鍵、IV、暗号方式を使用します。
70    $decrypted = openssl_decrypt($encryptedDataFromEncoded, $cipherAlgo, $key, OPENSSL_RAW_DATA, $ivFromEncrypted);
71    if ($decrypted === false) {
72        error_log("Error: Decryption failed: " . openssl_error_string());
73        return false;
74    }
75
76    return [
77        'encrypted' => $encryptedBase64, // IVと暗号文を含むBase64エンコードされた文字列
78        'decrypted' => $decrypted
79    ];
80}
81
82// --- サンプル使用例 ---
83
84// 1. 暗号化する平文データ (Plaintext)
85$plainText = "システムエンジニアを目指す初心者向けの機密情報です。";
86
87// 2. 秘密鍵 (Secret Key) の生成
88// 非常に重要: 鍵は安全な方法で生成し、漏洩しないように厳重に管理してください。
89// ここでは openssl_random_pseudo_bytes() を使用して、32バイトのランダムな鍵を生成しています。
90// この鍵が漏洩すると、暗号化されたデータが解読されてしまいます。
91$secretKey = openssl_random_pseudo_bytes(32); // AES-256-CBC の場合、32バイト (256ビット)
92
93// 3. 暗号化・復号化の実行
94$result = encryptDecryptAes256Cbc($plainText, $secretKey);
95
96if ($result !== false) {
97    echo "--- PHP openssl_encrypt を使用した AES-256-CBC 暗号化・復号化の例 ---" . PHP_EOL;
98    echo "元のデータ (平文): " . $plainText . PHP_EOL;
99    echo "暗号化されたデータ (Base64エンコード): " . $result['encrypted'] . PHP_EOL;
100    echo "復号化されたデータ: " . $result['decrypted'] . PHP_EOL;
101
102    // 元のデータと復号化されたデータが一致するか検証
103    if ($plainText === $result['decrypted']) {
104        echo "✅ 検証結果: 復号化されたデータは元のデータと完全に一致しました。" . PHP_EOL;
105    } else {
106        echo "❌ 検証結果: 復号化に失敗したか、データが改ざんされました。" . PHP_EOL;
107    }
108} else {
109    echo "エラー: 暗号化または復号化処理中に問題が発生しました。" . PHP_EOL;
110}

このPHPサンプルコードは、openssl_encrypt関数を使用して文字列をAES-256-CBC暗号方式で安全に暗号化し、その後復号化する一連の流れをシステムエンジニアを目指す初心者向けに示しています。

encryptDecryptAes256Cbc関数は、暗号化・復号化したい元の文字列である平文（$data）と、暗号化の鍵となる秘密鍵（$key）を引数として受け取ります。関数内部では、まずopenssl_random_pseudo_bytes関数を用いて、毎回異なる安全なIV（初期化ベクトル）を生成します。次に、openssl_encrypt関数を使い、元のデータ、指定された暗号方式（aes-256-cbc）、秘密鍵、そしてOPENSSL_RAW_DATA定数を指定してデータを暗号化します。OPENSSL_RAW_DATAは、暗号文を生データ形式で取得するための定数です。生成されたIVと暗号化されたデータは連結され、Base64エンコードされて外部に安全に転送・保存できるようになります。

復号化の際には、Base64エンコードされたデータからIVと暗号文を分離し、openssl_decrypt関数で同じ秘密鍵、IV、暗号方式を使って元の平文に復元します。この関数は、処理が成功した場合は暗号化されたBase64文字列と復号化された平文を含む連想配列を返し、失敗した場合はfalseを返します。この一連の処理は、PHPで機密情報を安全に扱うための基本的な暗号化技術の理解に役立ちます。