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

Copy
1<?php
2
3/**
4 * OPENSSL_PKCS1_OAEP_PADDING 定数を使用したRSA暗号化・復号化のデモンストレーション
5 *
6 * この関数は、PHPのOpenSSL拡張機能で非対称暗号（RSA）を使用する際の
7 * OAEPパディングモードの適用方法をシステムエンジニアを目指す初心者にも分かりやすく示します。
8 * RSA鍵ペアの生成から、データの暗号化、復号化までの一連の流れを通して、
9 * OPENSSL_PKCS1_OAEP_PADDING 定数の使われ方を理解できます。
10 *
11 * @return void
12 */
13function demonstrateOpenSslOaepPadding(): void
14{
15    echo "PHP OpenSSL OAEP Padding デモンストレーション\n";
16    echo "-------------------------------------------\n\n";
17
18    // 1. RSA鍵ペア（公開鍵と秘密鍵）を生成します。
19    // openssl_pkey_new() を使用して新しい秘密鍵リソースを作成します。
20    // 'private_key_bits' で鍵の長さを2048ビットに設定し、
21    // 'private_key_type' でRSAキータイプを指定します。
22    $config = [
23        "private_key_bits" => 2048,
24        "private_key_type" => OPENSSL_KEYTYPE_RSA,
25    ];
26    $privateKeyResource = openssl_pkey_new($config);
27
28    if ($privateKeyResource === false) {
29        echo "エラー: 秘密鍵の生成に失敗しました。\n";
30        return;
31    }
32
33    // 生成した秘密鍵リソースから秘密鍵の文字列をエクスポートします。
34    // デモンストレーションのため、パスフレーズは設定しません。
35    $privateKey = '';
36    if (!openssl_pkey_export($privateKeyResource, $privateKey)) {
37        echo "エラー: 秘密鍵のエクスポートに失敗しました。\n";
38        return;
39    }
40    echo "RSA秘密鍵を生成しました。\n";
41
42    // 秘密鍵リソースから公開鍵の文字列を抽出します。
43    $details = openssl_pkey_get_details($privateKeyResource);
44    if ($details === false || !isset($details['key'])) {
45        echo "エラー: 公開鍵の抽出に失敗しました。\n";
46        return;
47    }
48    $publicKey = $details['key'];
49    echo "RSA公開鍵を抽出しました。\n";
50
51    // 2. 暗号化する平文の準備
52    $plainText = "Hello, System Engineer Beginner! This is a secret message.";
53    echo "\n元の平文: \"" . $plainText . "\"\n";
54
55    $encryptedText = '';
56    // 3. 公開鍵を使用して平文を暗号化します。
57    // 第4引数に OPENSSL_PKCS1_OAEP_PADDING 定数を指定することで、
58    // セキュアなOAEP（Optimal Asymmetric Encryption Padding）パディングスキームが適用されます。
59    // これにより、RSA暗号のセキュリティが向上します。
60    if (!openssl_public_encrypt($plainText, $encryptedText, $publicKey, OPENSSL_PKCS1_OAEP_PADDING)) {
61        echo "エラー: 公開鍵での暗号化に失敗しました。\n";
62        // 詳細なエラーメッセージの取得 (OpenSSLの診断機能)
63        while ($msg = openssl_error_string()) {
64            echo "OpenSSLエラー: " . $msg . "\n";
65        }
66        return;
67    }
68    echo "公開鍵で暗号化しました (OAEP Padding を使用)。\n";
69    // 暗号文はバイナリデータなので、表示のためにBase64エンコードします。
70    echo "暗号文 (Base64エンコード): " . base64_encode($encryptedText) . "\n";
71
72    $decryptedText = '';
73    // 4. 秘密鍵を使用して暗号文を復号化します。
74    // 暗号化時と同じく、第4引数に OPENSSL_PKCS1_OAEP_PADDING 定数を指定する必要があります。
75    // 同じパディングスキームを指定しないと、正しく復号できません。
76    if (!openssl_private_decrypt($encryptedText, $decryptedText, $privateKey, OPENSSL_PKCS1_OAEP_PADDING)) {
77        echo "エラー: 秘密鍵での復号化に失敗しました。\n";
78        // 詳細なエラーメッセージの取得
79        while ($msg = openssl_error_string()) {
80            echo "OpenSSLエラー: " . $msg . "\n";
81        }
82        return;
83    }
84    echo "秘密鍵で復号化しました (OAEP Padding を使用)。\n";
85    echo "復号化された平文: \"" . $decryptedText . "\"\n\n";
86
87    // 5. 元の平文と復号化された平文が一致するかを確認します。
88    if ($plainText === $decryptedText) {
89        echo "結果: 復号化された平文は元の平文と一致します。RSA暗号化・復号化の成功！\n";
90    } else {
91        echo "結果: 復号化された平文は元の平文と一致しません。RSA暗号化・復号化の失敗！\n";
92    }
93
94    // 鍵リソースを解放し、メモリをクリーンアップします。
95    openssl_pkey_free($privateKeyResource);
96}
97
98// 関数を実行してデモンストレーションを開始します。
99demonstrateOpenSslOaepPadding();
100

PHP 8のOPENSSL_PKCS1_OAEP_PADDINGは、PHPのOpenSSL拡張機能で非対称暗号、特にRSA暗号化・復号化を行う際に使用される整数型の定数です。この定数は、データを暗号化する前に特定の形式でパディング（詰め物）を行う「OAEP（Optimal Asymmetric Encryption Padding）」スキームを指定するために利用されます。OAEPパディングは、RSA暗号のセキュリティを大幅に向上させ、既知の攻撃から保護する重要な役割を担います。

この定数自体は引数を取りませんが、openssl_public_encrypt()関数で平文を公開鍵で暗号化する際や、openssl_private_decrypt()関数で暗号文を秘密鍵で復号化する際の第4引数に指定することで、OAEPパディングモードを適用します。暗号化時と復号化時でこの定数を指定し、同じパディングスキームを用いることが、正しくデータの送受信を行う上で不可欠です。内部的にはOpenSSLライブラリに渡されるオプションとして機能し、その戻り値は整数値となります。システムエンジニアを目指す方にとって、セキュアな暗号通信を実装する上で、この定数の役割を理解することは非常に重要です。

Copy
1<?php
2
3/**
4 * OPENSSL_PKCS1_OAEP_PADDING を使用した公開鍵暗号化と復号化のデモンストレーション
5 *
6 * この関数は、システムエンジニアを目指す初心者の方にも理解しやすいように、
7 * PHPのOpenSSL拡張機能における OPENSSL_PKCS1_OAEP_PADDING 定数の使い方を示します。
8 *
9 * OPENSSL_PKCS1_OAEP_PADDING は、公開鍵暗号（特にRSA）において、データを暗号化する前に適用される
10 * 「パディング」（詰め物）の方式の一つです。
11 * OAEP (Optimal Asymmetric Encryption Padding) は、データの安全性を高め、
12 * 攻撃者が暗号文から元の情報を推測するのを防ぐために推奨される、より高度な方式です。
13 *
14 * 注意: "openssl_zero_padding" という名前の定数はPHPのOpenSSL拡張には存在しません。
15 * パディングなしやシンプルなパディングが必要な場合は他の定数（例: OPENSSL_NO_PADDING）を
16 * 検討することもありますが、RSA暗号では通常、OAEPのような安全なパディングが強く推奨されます。
17 */
18function demonstrateOaepPaddingUsage(): void
19{
20    echo "--- OPENSSL_PKCS1_OAEP_PADDING のデモンストレーション開始 ---\n\n";
21
22    // 1. 公開鍵と秘密鍵のペアを生成する
23    // 本番環境では、より安全な方法で鍵を生成・管理する必要があります。
24    // ここではデモンストレーション用に2048ビットのRSA鍵を生成します。
25    $config = [
26        "digest_alg" => "sha512",
27        "private_key_bits" => 2048,
28        "private_key_type" => OPENSSL_KEYTYPE_RSA,
29    ];
30    $privateKeyResource = openssl_pkey_new($config);
31
32    if ($privateKeyResource === false) {
33        echo "エラー: 鍵ペアの生成に失敗しました。\n";
34        echo "OpenSSLエラー: " . openssl_error_string() . "\n";
35        return;
36    }
37
38    // 秘密鍵を文字列としてエクスポートします
39    openssl_pkey_export($privateKeyResource, $privateKeyString);
40
41    // 公開鍵の詳細を取得し、公開鍵部分を抽出します
42    $publicKeyDetails = openssl_pkey_get_details($privateKeyResource);
43    $publicKeyString = $publicKeyDetails["key"];
44
45    echo "鍵ペアが正常に生成されました。\n";
46    // 通常、鍵情報は出力しませんが、生成されたことを示すためにメッセージを出力します。
47    // echo "秘密鍵:\n" . $privateKeyString . "\n";
48    // echo "公開鍵:\n" . $publicKeyString . "\n";
49    echo "\n";
50
51    // 2. 暗号化する元のデータ（平文）を準備します
52    $originalData = "こんにちは、システムエンジニアの卵たち！このメッセージはOAEPパディングを使って秘密にされます。";
53    echo "元のデータ: " . $originalData . "\n\n";
54
55    // 3. 公開鍵と OPENSSL_PKCS1_OAEP_PADDING を使用してデータを暗号化します
56    $encryptedData = '';
57    $encryptionSuccess = openssl_public_encrypt(
58        $originalData,
59        $encryptedData,
60        $publicKeyString,
61        OPENSSL_PKCS1_OAEP_PADDING // ここで OAEP パディング方式を指定します
62    );
63
64    if ($encryptionSuccess === false) {
65        echo "エラー: データの暗号化に失敗しました。\n";
66        echo "OpenSSLエラー: " . openssl_error_string() . "\n";
67        openssl_pkey_free($privateKeyResource);
68        return;
69    }
70
71    echo "データが公開鍵で暗号化されました (OAEPパディング使用)。\n";
72    echo "暗号化されたデータの長さ: " . strlen($encryptedData) . " バイト\n";
73    echo "暗号化されたデータ (Base64エンコード):\n" . base64_encode($encryptedData) . "\n\n";
74
75    // 4. 秘密鍵と OPENSSL_PKCS1_OAEP_PADDING を使用して暗号化されたデータを復号化します
76    $decryptedData = '';
77    $decryptionSuccess = openssl_private_decrypt(
78        $encryptedData,
79        $decryptedData,
80        $privateKeyString,
81        OPENSSL_PKCS1_OAEP_PADDING // 暗号化時と同じパディング方式を指定することが重要です
82    );
83
84    if ($decryptionSuccess === false) {
85        echo "エラー: データの復号化に失敗しました。\n";
86        echo "OpenSSLエラー: " . openssl_error_string() . "\n";
87        openssl_pkey_free($privateKeyResource);
88        return;
89    }
90
91    echo "データが秘密鍵で復号化されました (OAEPパディング使用)。\n";
92    echo "復号化されたデータ: " . $decryptedData . "\n\n";
93
94    // 5. 元のデータと復号化されたデータを比較して、処理が正しかったことを確認します
95    if ($originalData === $decryptedData) {
96        echo "検証結果: 成功！ 元のデータと復号化されたデータは完全に一致します。\n";
97    } else {
98        echo "検証結果: 失敗！ 元のデータと復号化されたデータが一致しません。\n";
99    }
100
101    // 鍵リソースを解放し、メモリリークを防ぎます
102    openssl_pkey_free($privateKeyResource);
103    echo "\n--- デモンストレーション終了 ---\n";
104}
105
106// 関数を実行して、OPENSSL_PKCS1_OAEP_PADDING の動作を確認します
107demonstrateOaepPaddingUsage();

PHP 8のOpenSSL拡張機能に含まれるOPENSSL_PKCS1_OAEP_PADDINGは、公開鍵暗号（特にRSA）において、データを暗号化する前に適用される「パディング」（詰め物）の方式を指定するための定数です。この定数自体に引数はなく、その値は整数型（int）です。OAEP (Optimal Asymmetric Encryption Padding) は、データの安全性を高め、暗号文から元の情報を推測する攻撃を防ぐために推奨される、より高度なパディング方式の一つです。

サンプルコードでは、この定数を使用して、生成した公開鍵でメッセージを暗号化し、対応する秘密鍵で復号化する一連の流れを示しています。暗号化と復号化の両操作において、同じパディング方式であるOPENSSL_PKCS1_OAEP_PADDINGを指定することが非常に重要であり、これにより元のデータと復号されたデータが完全に一致することを確認できます。

なお、「openssl_zero_padding」という名前の定数はPHPのOpenSSL拡張には存在しません。RSA暗号では、セキュリティを確保するため、OAEPのような安全性の高いパディング方式の利用が強く推奨されています。この定数を理解することは、安全なデータ通信や保存を必要とするシステムを構築する上で役立ちます。