Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

openssl_public_decrypt関数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

openssl_public_decrypt関数は、公開鍵暗号方式において、公開鍵を使用して暗号化されたデータを復号する関数です。この関数は、主にデジタル署名の検証処理で利用されます。デジタル署名では、送信者が秘密鍵でメッセージのハッシュ値に署名し、その署名されたデータを公開鍵を用いて復号することで、メッセージが確かに送信者によって署名されたものであること、およびメッセージが改ざんされていないことを検証します。

この関数は、以下の引数を受け取ります。第一引数には、復号する暗号化されたデータ(文字列)を指定します。第二引数には、復号されたデータが格納される変数(参照渡し)を指定します。第三引数には、使用する公開鍵を指定します。これは、OpenSSLキーリソースまたはPEM形式の公開鍵文字列である必要があります。第四引数には、パディング方式を指定し、通常はOPENSSL_PKCS1_PADDINGを使用します。

復号処理が成功した場合、この関数はtrueを返し、復号されたデータは第二引数に渡された変数に格納されます。復号に失敗した場合はfalseを返します。この関数は、一般的なデータの暗号化・復号とは異なり、公開鍵で暗号化されたデータを公開鍵で復号するという特殊な用途を持つため、利用する際はその目的を正しく理解することが重要です。これにより、データの完全性の確認や送信元の認証を行うセキュリティシステムを構築できます。

構文(syntax)

1<?php
2// 暗号化された文字列データ
3$encryptedData = '...';
4
5// 復号化されたデータが格納される変数(参照渡しのため事前に初期化)
6$decryptedData = '';
7
8// 公開鍵のPEM形式文字列、またはOpenSSLAsymmetricKeyリソース
9// 通常はファイルから読み込むか、直接文字列として定義します
10$publicKey = "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----";
11
12// 公開鍵を使用してデータを復号化する
13// 成功した場合はtrue、失敗した場合はfalseを返します
14$success = openssl_public_decrypt($encryptedData, $decryptedData, $publicKey, OPENSSL_PKCS1_PADDING);

引数(parameters)

string $data, string &$decrypted_data, mixed $public_key, int $padding = OPENSSL_PKCS1_PADDING

  • string $data: 復号化するデータを指定する文字列
  • string &$decrypted_data: 復号化された結果が格納される文字列への参照
  • mixed $public_key: 復号化に使用する公開鍵(PEM形式の文字列、またはOpenSSL X.509証明書リソース)
  • int $padding = OPENSSL_PKCS1_PADDING: データのパディング方法を指定する整数(デフォルトはPKCS#1 v1.5)

戻り値(return)

bool

openssl_public_decrypt 関数は、公開鍵で暗号化されたデータを復号できた場合に true を返します。復号に失敗した場合は false を返します。

サンプルコード

PHP OpenSSLで公開鍵暗号化と復号をする

1<?php
2
3declare(strict_types=1);
4
5/**
6 * RSA公開鍵暗号方式によるデータの暗号化と復号のサンプルです。
7 * `openssl_public_encrypt` 関数による公開鍵での暗号化と、
8 * その復号に対応する `openssl_private_decrypt` 関数の使用方法を示します。
9 *
10 * この関数は、システムのセキュリティを理解するための基本的な概念を
11 * システムエンジニアを目指す初心者にも分かりやすく伝えることを目的としています。
12 *
13 * @param string $dataToEncrypt 暗号化する平文データ。
14 * @return array|false 成功時は暗号化されたデータ、復号されたデータ、公開鍵、秘密鍵を含む配列。失敗時はfalse。
15 */
16function encryptDecryptWithRsa(string $dataToEncrypt): array|false
17{
18    // 1. RSA鍵ペアを生成する
19    // `openssl_pkey_new` を使用して、新しいRSA鍵ペア(公開鍵と秘密鍵)を生成します。
20    // `private_key_bits` で鍵の長さをビット単位で指定します(例: 2048ビット)。
21    // `private_key_type` で鍵のタイプをRSAに指定します。
22    $privateKeyResource = openssl_pkey_new([
23        'private_key_bits' => 2048,
24        'private_key_type' => OPENSSL_KEYTYPE_RSA,
25    ]);
26
27    if ($privateKeyResource === false) {
28        // 鍵生成に失敗した場合、エラーログに出力して処理を終了します。
29        error_log('Failed to generate RSA key pair: ' . openssl_error_string());
30        return false;
31    }
32
33    // 秘密鍵をPEM形式の文字列としてエクスポートします。
34    // これにより、後で復号処理に使用できるようになります。
35    $privateKey = '';
36    openssl_pkey_export($privateKeyResource, $privateKey);
37
38    // 公開鍵の詳細情報からPEM形式の公開鍵文字列を取得します。
39    // この公開鍵は、データを暗号化するために使用されます。
40    $publicKeyDetails = openssl_pkey_get_details($privateKeyResource);
41    if ($publicKeyDetails === false || !isset($publicKeyDetails['key'])) {
42        error_log('Failed to get public key details.');
43        openssl_pkey_free($privateKeyResource); // リソースを解放
44        return false;
45    }
46    $publicKey = $publicKeyDetails['key'];
47
48    echo "--- RSA鍵ペアの生成に成功しました ---\n";
49    echo "公開鍵:\n" . $publicKey . "\n";
50    echo "秘密鍵:\n" . $privateKey . "\n";
51    echo "暗号化対象のデータ: " . $dataToEncrypt . "\n\n";
52
53    // 2. 公開鍵でデータを暗号化する (`openssl_public_encrypt`)
54    // 指定された公開鍵とデフォルトのパディング (`OPENSSL_PKCS1_PADDING`) を使用して、
55    // 平文データ `$dataToEncrypt` を暗号化します。
56    // 暗号化されたデータは `$encryptedData` に格納されます。
57    // 公開鍵で暗号化されたデータは、対応する秘密鍵でのみ復号可能です。
58    $encryptedData = '';
59    if (!openssl_public_encrypt($dataToEncrypt, $encryptedData, $publicKey)) {
60        error_log('公開鍵での暗号化に失敗しました: ' . openssl_error_string());
61        openssl_pkey_free($privateKeyResource);
62        return false;
63    }
64    echo "--- 公開鍵で暗号化 (`openssl_public_encrypt`) ---\n";
65    echo "暗号化されたデータ (Base64エンコード):\n" . base64_encode($encryptedData) . "\n\n";
66
67    // 3. 秘密鍵で暗号化されたデータを復号する (`openssl_private_decrypt`)
68    // `openssl_public_encrypt` で暗号化されたデータは、
69    // 対応する秘密鍵と `openssl_private_decrypt` を使用して復号します。
70    // 復号されたデータは `$decryptedData` に格納されます。
71    $decryptedData = '';
72    if (!openssl_private_decrypt($encryptedData, $decryptedData, $privateKey)) {
73        error_log('秘密鍵での復号に失敗しました: ' . openssl_error_string());
74        openssl_pkey_free($privateKeyResource);
75        return false;
76    }
77    echo "--- 秘密鍵で復号 (`openssl_private_decrypt`) ---\n";
78    echo "復号されたデータ: " . $decryptedData . "\n";
79    // 元のデータと復号されたデータが一致するかを確認します。
80    echo "元のデータとの一致: " . ($dataToEncrypt === $decryptedData ? '成功' : '失敗') . "\n\n";
81
82    // 使用した鍵リソースを解放します。
83    // これはメモリリークを防ぐために重要です。
84    openssl_pkey_free($privateKeyResource);
85
86    return [
87        'original_data' => $dataToEncrypt,
88        'encrypted_data' => $encryptedData,
89        'decrypted_data' => $decryptedData,
90        'public_key' => $publicKey,
91        'private_key' => $privateKey,
92    ];
93}
94
95// サンプルコードの実行部分
96// 機密性の高いメッセージを想定して、暗号化と復号のプロセスを試行します。
97$message = "これはPHP OpenSSLを使った機密メッセージです。外部に漏らしたくない情報です。";
98$result = encryptDecryptWithRsa($message);
99
100if ($result === false) {
101    echo "エラーが発生しました。詳細についてはログを確認してください。\n";
102}
103
104?>

このPHPサンプルコードは、RSA公開鍵暗号方式によるデータの暗号化と復号の基本的な流れを示しています。具体的には、openssl_public_encrypt関数による公開鍵での暗号化と、対応するopenssl_private_decrypt関数による秘密鍵での復号を解説します。

まず、openssl_pkey_new関数を用いて、新しい公開鍵と秘密鍵のペアを生成します。その後、openssl_public_encrypt関数を使用して、元の平文データ($dataToEncrypt)を公開鍵で暗号化します。この関数は、暗号化に成功するとブール値trueを返し、暗号化されたデータは引数$encryptedDataに参照渡しで格納されます。引数$publicKeyには、暗号化に用いる公開鍵をPEM形式の文字列などで指定します。これにより、公開鍵を持つ誰もがデータを暗号化できます。

暗号化されたデータは、openssl_private_decrypt関数と、対応する秘密鍵を用いることで復号され、元の平文($decryptedData)に戻されます。この一連のプロセスは、データの機密性を確保するための基本的なセキュリティ手法です。

なお、本リファレンス情報で指定されたopenssl_public_decrypt関数は、通常、秘密鍵で暗号化されたデータ(例えばデジタル署名)を公開鍵で復号し、その正当性を検証する際に使用されます。このサンプルコードでは、データ保護を目的とした公開鍵による暗号化と秘密鍵による復号のシナリオが主に示されています。

このサンプルコードは、公開鍵でデータを暗号化し、その秘密鍵で復号する基本的な流れを示しています。セキュリティ上、生成された秘密鍵は厳重に管理し、絶対に外部へ漏洩させないでください。処理の失敗時には、openssl_error_string()で詳細なエラー情報を確認し、適切にエラーハンドリングを行うことが非常に重要です。また、使用した鍵リソースは、メモリリークを防ぐためにopenssl_pkey_free関数で必ず解放してください。なお、リファレンスのopenssl_public_decryptは、秘密鍵で暗号化された情報を公開鍵で復号する際に用いる関数で、サンプルコードとは逆の暗号化・復号ペアに対応します。

PHP openssl_public_decryptで公開鍵復号する

1<?php
2
3/**
4 * openssl_public_decrypt の使用例を示す関数です。
5 * この関数は、プライベートキーで暗号化されたデータをパブリックキーで復号します。
6 * 主にデジタル署名の検証など、認証目的で使用されます。
7 * (データの機密性確保のためには通常、パブリックキーで暗号化し、プライベートキーで復号します。)
8 *
9 * PHP 8 で動作します。
10 *
11 * @param string $originalData 復号する元のデータ
12 * @return bool 復号が成功し、元のデータと一致すれば true、それ以外は false
13 */
14function demonstrateOpensslPublicDecrypt(string $originalData): bool
15{
16    // 1. RSAキーペアを生成します (2048ビット)
17    $config = [
18        "digest_alg"       => "sha512",
19        "private_key_bits" => 2048,
20        "private_key_type" => OPENSSL_KEYTYPE_RSA,
21    ];
22    $res = openssl_pkey_new($config);
23
24    if ($res === false) {
25        echo "キーペアの生成に失敗しました。" . PHP_EOL;
26        return false;
27    }
28
29    // プライベートキーをエクスポートします
30    openssl_pkey_export($res, $privateKey);
31
32    // パブリックキーの詳細を取得し、パブリックキー本体を取り出します
33    $publicKeyDetails = openssl_pkey_get_details($res);
34    $publicKey = $publicKeyDetails['key'];
35
36    echo "--- キーペア生成 ---" . PHP_EOL;
37    echo "プライベートキー (抜粋):\n" . substr($privateKey, 0, 100) . "...\n" . PHP_EOL;
38    echo "パブリックキー (抜粋):\n" . substr($publicKey, 0, 100) . "...\n" . PHP_EOL;
39    echo "元のデータ: " . $originalData . PHP_EOL . PHP_EOL;
40
41    // 2. プライベートキーでデータを暗号化します
42    // これにより、パブリックキーで復号できる「署名」データが作成されます。
43    $privateEncryptedData = '';
44    // 暗号化と復号で同じパディングモードを使用します
45    if (!openssl_private_encrypt($originalData, $privateEncryptedData, $privateKey, OPENSSL_PKCS1_PADDING)) {
46        echo "プライベートキーによる暗号化に失敗しました。" . PHP_EOL;
47        openssl_pkey_free($res);
48        return false;
49    }
50
51    echo "プライベートキーで暗号化されたデータ (Base64エンコード):\n" . base64_encode($privateEncryptedData) . PHP_EOL . PHP_EOL;
52
53    // 3. パブリックキーでデータを復号します
54    $decryptedData = '';
55    // openssl_public_decrypt はプライベートキーで暗号化されたデータをパブリックキーで復号します
56    if (!openssl_public_decrypt($privateEncryptedData, $decryptedData, $publicKey, OPENSSL_PKCS1_PADDING)) {
57        echo "パブリックキーによる復号に失敗しました。" . PHP_EOL;
58        openssl_pkey_free($res);
59        return false;
60    }
61
62    echo "パブリックキーで復号されたデータ: " . $decryptedData . PHP_EOL . PHP_EOL;
63
64    // キーリソースを解放します
65    openssl_pkey_free($res);
66
67    // 4. 元のデータと復号されたデータを比較して検証します
68    if ($originalData === $decryptedData) {
69        echo "検証成功: 元のデータと復号されたデータが一致しました。" . PHP_EOL;
70        return true;
71    } else {
72        echo "検証失敗: 元のデータと復号されたデータが一致しません。" . PHP_EOL;
73        return false;
74    }
75}
76
77// サンプルコードの実行
78$testMessage = "システムエンジニア向けのPHP openssl_public_decryptの簡単な使用例です。";
79demonstrateOpensslPublicDecrypt($testMessage);
80

PHP 8のopenssl_public_decrypt関数は、主にデジタル署名の検証やデータの認証といった目的で使用されます。この関数は、プライベートキーで暗号化されたデータを、対応するパブリックキーを用いて復号する役割を持ちます。一般的なデータの機密性を確保するための暗号化(パブリックキーで暗号化し、プライベートキーで復号)とは逆の用途で用いられる点が特徴です。

引数$dataには、復号したいプライベートキーで暗号化された文字列を指定します。&$decrypted_dataは参照渡しで、復号されたデータがこの変数に格納されます。$public_keyには復号に利用するパブリックキーを指定し、$paddingはパディング方式(通常はOPENSSL_PKCS1_PADDING)を指定します。戻り値は、復号が成功すればtrue、失敗すればfalseを返します。

サンプルコードでは、まずRSAキーペアを生成し、次に元のデータをopenssl_private_encrypt関数でプライベートキーを使って暗号化しています。その後、この暗号化されたデータをopenssl_public_decrypt関数にパブリックキーを渡して復号し、元のデータと一致するかどうかを検証しています。これにより、データが正当な送信者によって署名され、改ざんされていないことを確認する一連の流れを示しています。

openssl_public_decrypt関数は、プライベートキーで暗号化されたデータをパブリックキーで復号する際に使用されます。これは主にデジタル署名の検証など、データの正当性を確認する認証目的で利用され、一般的なデータの機密性確保とは目的が異なります。機密性を保つ暗号化では、通常パブリックキーで暗号化し、プライベートキーで復号しますので混同しないよう注意が必要です。本番環境では、キーペアの安全な生成と厳重な管理が極めて重要であり、また暗号化と復号で常に同じパディングモードを使用してください。処理後はopenssl_pkey_free関数でキーリソースを必ず解放するようにしましょう。

関連コンテンツ

関連IT用語

関連プログラミング言語