【PHP8.x】OPENSSL_CIPHER_AES_128_CBC定数の使い方
OPENSSL_CIPHER_AES_128_CBC定数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
OPENSSL_CIPHER_AES_128_CBC定数は、PHPのOpenSSL拡張機能において、データの暗号化および復号化に利用される特定の暗号方式「AES-128-CBC」を指定するための定数です。
この定数が示す「AES」は、Advanced Encryption Standardの略で、現代において最も広く利用されている共通鍵暗号方式の一つです。政府機関や企業など、幅広い分野で機密性の高いデータを保護するための国際標準として採用されています。続く「128」は、暗号化に使用する鍵の長さが128ビットであることを意味しており、鍵長が長いほど解読が困難になり、セキュリティ強度が高まります。
さらに「CBC」は、Cipher Block Chainingの略で、ブロック暗号と呼ばれる種類の暗号化アルゴリズムで用いられる動作モードの一つです。CBCモードでは、前のデータのブロックの暗号化結果が、次のブロックの暗号化処理に影響を与える特性があります。これにより、たとえ元のデータ(平文)の中に同じパターンが繰り返し出現しても、それぞれ異なる暗号文が生成されるため、パターン分析による攻撃に対する耐性が向上し、より高いセキュリティが確保されます。
このOPENSSL_CIPHER_AES_128_CBC定数は、PHPのopenssl_encrypt()やopenssl_decrypt()といった関数を呼び出す際に、具体的にどの暗号方式で処理を行うかを指定するパラメータとして使用されます。開発者はこの定数を用いることで、文字列で直接暗号方式名を指定するよりも、正確かつ安全に暗号アルゴリズムを選択し、データの機密性を確保した堅牢なシステムを構築することができます。
構文(syntax)
1<?php 2 3$encryptionMethod = OPENSSL_CIPHER_AES_128_CBC; 4 5?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません
サンプルコード
PHPでAES-128-ECB暗号化・復号する
1<?php 2 3/** 4 * AES-128-ECB モードを使用したデータの暗号化と復号のサンプル。 5 * 6 * この関数は、指定された平文データをAES-128-ECBモードで暗号化し、 7 * その後復号して元の平文に戻せることを示します。 8 * 9 * システムエンジニアを目指す初心者向けに、暗号化処理の基本的な流れを理解することを目的としています。 10 * ECBモードはブロックごとに独立して処理されるため、IV(初期化ベクトル)は不要であり、 11 * openssl_cipher_iv_length() 関数は 'aes-128-ecb' に対して 0 を返します。 12 * openssl_encrypt/decrypt 関数にIV引数を渡す必要がある場合でも、空文字列を渡すことで正しく動作します。 13 * 14 * セキュリティ上の理由から、ECBモードはパターンが繰り返し出現するため、実際のアプリケーションでの使用は推奨されません。 15 * より安全なモード(例: CBC, GCM)を使用してください。 16 * 17 * @param string $plaintext 暗号化する元の平文データ 18 * @param string $key 暗号化と復号に使用する共通鍵 (AES-128の場合、16バイト長が必須) 19 * @return void 結果を出力します 20 */ 21function encryptDecryptAes128Ecb(string $plaintext, string $key): void 22{ 23 // 使用する暗号アルゴリズム 24 $cipherAlgo = 'aes-128-ecb'; 25 26 // openssl_cipher_iv_length() を使用して、ECBモードのIV長を取得します。 27 // AES-128-ECBの場合、IV長は0です。 28 $ivLength = openssl_cipher_iv_length($cipherAlgo); 29 // ECBモードではIVは不要ですが、openssl_encrypt/decryptの引数に空文字列を渡します。 30 $iv = ''; 31 32 // 鍵の長さをチェック (AES-128の場合、16バイト) 33 if (strlen($key) !== 16) { 34 echo "エラー: 鍵の長さが16バイトではありません。現在の鍵の長さ: " . strlen($key) . " バイト\n"; 35 echo "AES-128には16バイトの鍵が必要です。\n"; 36 return; 37 } 38 39 echo "--- AES-128-ECB 暗号化・復号サンプル ---\n"; 40 echo "元の平文: '" . $plaintext . "'\n"; 41 echo "使用する鍵 (16進数): " . bin2hex($key) . "\n"; 42 echo "使用するアルゴリズム: " . $cipherAlgo . "\n"; 43 echo "IVの長さ: " . $ivLength . " バイト (ECBモードではIVは使用されません)\n\n"; 44 45 // データの暗号化 46 // OPENSSL_RAW_DATA フラグにより、暗号文は生のバイナリ形式で返されます。 47 $encrypted = openssl_encrypt($plaintext, $cipherAlgo, $key, OPENSSL_RAW_DATA, $iv); 48 49 if ($encrypted === false) { 50 echo "エラー: 暗号化に失敗しました。詳細: " . openssl_error_string() . "\n"; 51 return; 52 } 53 54 echo "暗号化されたデータ (Base64エンコード): " . base64_encode($encrypted) . "\n"; 55 56 // データの復号 57 // OPENSSL_RAW_DATA フラグにより、復号されたデータは生のバイナリ形式で返されます。 58 $decrypted = openssl_decrypt($encrypted, $cipherAlgo, $key, OPENSSL_RAW_DATA, $iv); 59 60 if ($decrypted === false) { 61 echo "エラー: 復号に失敗しました。詳細: " . openssl_error_string() . "\n"; 62 return; 63 } 64 65 echo "復号されたデータ: '" . $decrypted . "'\n"; 66 67 // 復号されたデータが元の平文と一致するか確認 68 if ($plaintext === $decrypted) { 69 echo "結果: 暗号化と復号が成功し、データが一致しました。\n"; 70 } else { 71 echo "結果: エラーが発生しました。データが一致しません。\n"; 72 } 73 echo "\n"; 74} 75 76// --- サンプル実行 --- 77 78// 16バイト (128ビット) のランダムな鍵を生成 79$sampleKey = openssl_random_pseudo_bytes(16); 80$samplePlaintext = "Hello, System Engineer! This is a secret message."; 81 82// 正しい鍵長で実行 83encryptDecryptAes128Ecb($samplePlaintext, $sampleKey); 84 85// 鍵が短い場合の例 (エラーになることを示す) 86echo "--- 鍵の長さが不正な場合の例 ---\n"; 87$shortKey = "shortkey"; // 8バイト 88encryptDecryptAes128Ecb($samplePlaintext, $shortKey); 89 90// 鍵が長い場合の例 (エラーになることを示す) 91echo "--- 鍵の長さが不正な場合の例 ---\n"; 92$longKey = openssl_random_pseudo_bytes(24); // 24バイト (192ビット) 93encryptDecryptAes128Ecb($samplePlaintext, $longKey); 94 95?>
このサンプルコードは、PHPのopenssl_encryptとopenssl_decrypt関数を使用して、AES-128-ECBモードでデータを暗号化し、その後復号する基本的な流れを示しています。encryptDecryptAes128Ecb関数は、暗号化する元の平文データを$plaintext引数に、暗号化と復号に使用する共通鍵を$key引数に受け取ります。AES-128では16バイトの鍵長が必須であり、鍵の長さが異なる場合はエラーメッセージが表示されます。この関数はvoid型であり、値を返さず、処理結果を標準出力に出力します。
使用する暗号アルゴリズムはaes-128-ecbで、このモードではIV(初期化ベクトル)は不要ですが、openssl_encryptやopenssl_decrypt関数には空文字列をIVとして渡す必要があります。OPENSSL_RAW_DATAフラグを使用することで、暗号化されたデータや復号されたデータが生のバイナリ形式で扱われます。暗号化と復号が成功すると、元の平文と復号されたデータが一致することが確認され、その結果が示されます。ただし、ECBモードはセキュリティ上の理由から実際のアプリケーションでの使用は推奨されていません。このサンプルは、暗号化処理の基本的な概念を理解するのに役立ちます。
このサンプルコードはAES-128-ECBモードの利用を示しますが、セキュリティ上の弱点があるため、実際のシステムではCBCやGCMなど、より安全なモードを必ず選択してください。リファレンスにあるOPENSSL_CIPHER_AES_128_CBCはその一つです。AES-128の鍵は16バイトが必須であり、不適切な長さの鍵は処理の失敗を招きます。ECBモードではIV(初期化ベクトル)は不要ですが、openssl_encryptやopenssl_decrypt関数には空文字列を渡す必要があります。また、処理の失敗に備え、各関数の戻り値を必ず確認し、openssl_error_string()でエラー詳細を取得するよう心がけましょう。
PHP openssl_encryptでAES-256-CBC暗号化・復号化する
1<?php 2 3/** 4 * 指定された文字列をAES-256-CBC方式で暗号化し、その後復号化する。 5 * システムエンジニアを目指す初心者向けに、openssl_encryptとopenssl_decryptの基本的な使い方を示します。 6 * 7 * @param string $plaintext 暗号化する平文の文字列。 8 * @param string $password 鍵の生成に使用するパスワード。 9 * @return array|false 暗号化されたデータ(Base64エンコード)、IV(Base64エンコード)、復号化された平文、 10 * または処理が失敗した場合はfalse。 11 */ 12function encryptAndDecryptAes256Cbc(string $plaintext, string $password): array|false 13{ 14 // AES-256-CBC 暗号化方式を指定 15 $cipherMethod = 'aes-256-cbc'; 16 17 // 鍵の生成: パスワードからSHA256ハッシュを生成し、鍵として利用します。 18 // openssl_encrypt関数は、暗号化方式に応じて適切な鍵長を内部的に処理します。 19 $key = hash('sha256', $password, true); // trueでバイナリ出力 20 21 // IV(初期化ベクトル)の生成: 暗号化方式に必要なIV長を取得し、ランダムなIVを生成します。 22 // IVは毎回異なる値を使用し、暗号文と一緒に保存または送信する必要があります。 23 $ivLength = openssl_cipher_iv_length($cipherMethod); 24 if ($ivLength === false) { 25 error_log("Failed to get IV length for method: {$cipherMethod}"); 26 return false; 27 } 28 $iv = openssl_random_pseudo_bytes($ivLength); 29 if ($iv === false) { 30 error_log("Failed to generate IV."); 31 return false; 32 } 33 34 // データを暗号化 35 // OPENSSL_RAW_DATA: 暗号化されたデータを生のバイナリ形式で返します。 36 // OPENSSL_ZERO_PAD: データをゼロでパディングします。 37 $encrypted = openssl_encrypt($plaintext, $cipherMethod, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PAD, $iv); 38 if ($encrypted === false) { 39 error_log("Encryption failed."); 40 return false; 41 } 42 43 // 暗号化されたデータとIVは、保存・転送のためにBase64エンコードすることが一般的です。 44 $encodedEncryptedData = base64_encode($encrypted); 45 $encodedIv = base64_encode($iv); 46 47 echo "--- 暗号化 ---" . PHP_EOL; 48 echo "平文: " . $plaintext . PHP_EOL; 49 echo "IV (Base64): " . $encodedIv . PHP_EOL; 50 echo "暗号文 (Base64): " . $encodedEncryptedData . PHP_EOL . PHP_EOL; 51 52 // --- 復号化 --- 53 // 保存・転送された暗号化データとIVをBase64デコードします。 54 $decodedEncryptedData = base64_decode($encodedEncryptedData); 55 $decodedIv = base64_decode($encodedIv); 56 57 // データを復号化 58 $decrypted = openssl_decrypt($decodedEncryptedData, $cipherMethod, $key, OPENSSL_RAW_DATA | OPENSSL_ZERO_PAD, $decodedIv); 59 if ($decrypted === false) { 60 error_log("Decryption failed."); 61 return false; 62 } 63 64 echo "--- 復号化 ---" . PHP_EOL; 65 echo "復号化された平文: " . $decrypted . PHP_EOL . PHP_EOL; 66 67 // 元の平文と復号化された平文が一致するか確認 68 if ($plaintext === $decrypted) { 69 echo "検証: 暗号化と復号化は成功しました。" . PHP_EOL; 70 } else { 71 echo "検証: エラー!暗号化または復号化に失敗しました。" . PHP_EOL; 72 } 73 74 return [ 75 'encrypted_data_base64' => $encodedEncryptedData, 76 'iv_base64' => $encodedIv, 77 'decrypted_plaintext' => $decrypted, 78 ]; 79} 80 81// サンプルとして使用するデータ 82$originalText = "これはPHPのopenssl_encrypt関数を使った秘密のメッセージです。"; 83$userPassword = "MyStrongSecretPassword123!"; 84 85// 関数を実行し、結果を出力 86encryptAndDecryptAes256Cbc($originalText, $userPassword);
このPHPコードは、openssl_encrypt関数とopenssl_decrypt関数を用いて、AES-256-CBC方式で文字列の暗号化と復号化を行う基本的な手順を示しています。
encryptAndDecryptAes256Cbc関数は、暗号化する「平文」と「鍵を生成するためのパスワード」を引数に受け取ります。関数内では、まずパスワードからSHA256ハッシュを生成し、これを暗号化・復号化に使用する「鍵」として利用します。次に、openssl_cipher_iv_lengthで必要な長さを取得し、openssl_random_pseudo_bytesによってランダムな「初期化ベクトル(IV)」を生成します。IVは暗号化のたびに異なる値を使用し、暗号文と一緒に管理する必要があります。
openssl_encrypt関数は、指定された平文を鍵とIVを使って暗号化します。暗号化されたデータとIVは、保存や転送のためにBase64形式にエンコードされます。復号化の際には、Base64デコードした暗号データとIV、そして暗号化時と同じ鍵を使用してopenssl_decrypt関数で元の平文を復元します。
関数の戻り値は、Base64エンコードされた暗号データとIV、復号化された平文を含む連想配列、または処理が失敗した場合はfalseとなります。このサンプルは、機密データを安全に扱うための暗号化処理の基礎を学ぶのに役立ちます。
PHPのOpenSSL拡張機能では、暗号化方式の指定に'aes-256-cbc'のような文字列を用いることが一般的です。リファレンスにあるOPENSSL_CIPHER_AES_128_CBCはAES-128-CBC方式用の定数ですが、サンプルコードはより堅牢なAES-256-CBC方式を文字列で直接指定しています。この方式は内部で256ビットの鍵長を要求しますので、利用する方式に応じて適切な鍵長と鍵の生成方法を理解することが重要です。
パスワードから鍵を生成する際は、セキュリティを高めるため、鍵導出関数(PBKDF2やArgon2など)の使用を強く推奨します。これにより、辞書攻撃などに対する耐性が向上します。
初期化ベクトル(IV)は、毎回異なるランダムな値を生成し、暗号文とセットで保存・転送してください。IVは秘密にする必要はありませんが、改ざんされないように管理する必要があります。
openssl_encryptとopenssl_decrypt関数のOPENSSL_RAW_DATAやOPENSSL_ZERO_PADといったオプションフラグは、暗号化時と復号時で必ず同じ組み合わせを指定してください。異なるフラグを使用すると、復号に失敗します。
暗号化されたデータやIVはバイナリ形式のため、データベース保存やネットワーク転送にはBase64エンコードなどを用いてテキスト形式に変換するのが一般的です。エラー発生時にはerror_logだけでなく、より詳細なエラーハンドリングを実装してください。