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

Copy
1<?php
2
3/**
4 * SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES 定数の使用例とAEAD暗号化のデモンストレーション。
5 *
6 * この関数は、SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES 定数が示す
7 * nonce（ノンス）のバイト長を取得し、それを用いてデータを暗号化・復号化する
8 * 基本的な流れを示します。Nonceは暗号化ごとに異なる値である必要があります。
9 */
10function demonstrateAeadNonceLength(): void
11{
12    // SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES 定数の値を取得し表示します。
13    // これは、ChaCha20-Poly1305-IETF アルゴリズムで必要とされるnonceのバイト長です。
14    // Nonce (Number Used Once) は、各暗号化操作で一度だけ使用されるランダムな値です。
15    // これにより、同じ鍵と平文であっても異なる暗号文が生成され、セキュリティが向上します。
16    $nonceBytes = SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES;
17    echo "ChaCha20-Poly1305-IETFのnonceに必要なバイト長: " . $nonceBytes . " バイト\n\n";
18
19    // 暗号化/復号化に使用する秘密鍵を生成します。
20    // この鍵は誰にも知られないように厳重に保護されるべきです。
21    $key = sodium_crypto_aead_chacha20poly1305_ietf_keygen();
22    echo "生成された秘密鍵 (HEX): " . bin2hex($key) . "\n\n";
23
24    // 暗号化する平文データです。
25    $plaintext = "システムエンジニアの皆さん、こんにちは！これは秘密のメッセージです。";
26    echo "元の平文データ: " . $plaintext . "\n\n";
27
28    // 関連データ (Associated Data) を定義します。
29    // これは暗号化されませんが、暗号文と一緒に認証され、改ざんされていないことを保証します。
30    // 例えば、メッセージIDやタイムスタンプなど、暗号化されたデータと紐づく情報に使われます。
31    $associatedData = "user_id:123, message_type:greeting";
32    echo "関連データ: " . $associatedData . "\n\n";
33
34    // Nonceを生成します。
35    // Nonceの長さは、SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES 定数で指定されたバイト長である必要があります。
36    // このNonceは暗号文と一緒に保存または送信されますが、秘密にする必要はありません。
37    try {
38        $nonce = random_bytes($nonceBytes);
39    } catch (Exception $e) {
40        echo "Nonceの生成に失敗しました: " . $e->getMessage() . "\n";
41        return;
42    }
43    echo "生成されたNonce (HEX): " . bin2hex($nonce) . "\n\n";
44
45    // データを暗号化します。
46    // sodium_crypto_aead_chacha20poly1305_ietf_encrypt 関数は、平文、関連データ、nonce、鍵を引数にとります。
47    $ciphertext = sodium_crypto_aead_chacha20poly1305_ietf_encrypt(
48        $plaintext,
49        $associatedData,
50        $nonce,
51        $key
52    );
53    echo "生成された暗号文 (HEX): " . bin2hex($ciphertext) . "\n\n";
54
55    // 暗号文を復号化します。
56    // sodium_crypto_aead_chacha20poly1305_ietf_decrypt 関数は、暗号文、関連データ、nonce、鍵を引数にとります。
57    // 暗号化時と全く同じnonce、関連データ、鍵が使用されない場合、復号化は失敗し、falseを返します。
58    $decryptedText = sodium_crypto_aead_chacha20poly1305_ietf_decrypt(
59        $ciphertext,
60        $associatedData,
61        $nonce,
62        $key
63    );
64
65    if ($decryptedText === false) {
66        echo "復号化に失敗しました。\n";
67        echo "理由として、データが改ざんされた、または鍵、nonce、関連データのいずれかが間違っている可能性が考えられます。\n";
68    } else {
69        echo "復号化された平文データ: " . $decryptedText . "\n\n";
70
71        // 元の平文と復号化された平文が一致するかを確認します。
72        if ($plaintext === $decryptedText) {
73            echo "結果: 暗号化と復号化は成功し、データは元の状態に戻りました。\n";
74        } else {
75            echo "結果: エラー - 復号化されたデータが元のデータと一致しませんでした。\n";
76        }
77    }
78}
79
80// 関数を実行してデモンストレーションを開始します。
81demonstrateAeadNonceLength();

PHP 8のSODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTESは、強力な暗号化方式であるChaCha20-Poly1305-IETFにおいて、nonce（ノンス）と呼ばれる一時的な値のバイト長を示す定数です。Nonceは「Number Used Once」の略で、暗号化ごとに異なる値を一度だけ使用することにより、同じ鍵と平文から常に異なる暗号文が生成され、セキュリティを向上させる重要な要素となります。この定数は引数を取らず、nonceに必要なバイト長を整数（int）で返します。

サンプルコードでは、この定数を用いてChaCha20-Poly1305-IETFアルゴリズムでデータを暗号化・復号化する一連の流れを解説しています。まず、SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTESでnonceの必要な長さを取得し、その長さでランダムなnonceを生成します。その後、生成された秘密鍵、nonce、平文、および任意で追加する関連データ（暗号化はされないが認証される情報）を用いてデータを暗号化します。復号化の際には、暗号化時と全く同じ鍵、nonce、関連データが必要となり、これらが一つでも異なると復号化は失敗し、改ざんを検知できる仕組みです。このデモンストレーションにより、セキュアなデータ通信においてnonceがいかに重要であるかを理解できます。

Copy
1<?php
2
3/**
4 * この関数は、PHP Sodium拡張機能における主要なAEAD (Authenticated Encryption with Associated Data)
5 * 暗号化アルゴリズムで使用されるノンス（nonce）の推奨バイトサイズを取得し、その意味を説明します。
6 *
7 * ノンスは "number used once" の略で、暗号化の際に各メッセージに固有のランダムな値として使用されます。
8 * これにより、同じ鍵と平文であっても異なる暗号文が生成され、セキュリティが向上します。
9 * 各暗号化操作で異なるノンスを使用することが非常に重要です。
10 *
11 * @return void
12 */
13function displaySodiumAeadNonceSizes(): void
14{
15    echo "--- PHP Sodium拡張機能: ノンス (Nonce) サイズ情報 ---\n";
16    echo "ノンスは、各暗号化操作で一度だけ使用される、予測不能なランダムな値です。\n";
17    echo "これにより、暗号文の安全性が高まり、攻撃者が同じデータが複数回暗号化されたことを特定するのを防ぎます。\n\n";
18
19    // SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES は、
20    // ChaCha20-Poly1305 (IETFバージョン) アルゴリズムのノンスの推奨バイトサイズを定義する定数です。
21    // この値は通常12です。
22    $chacha20IetfNonceSize = SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES;
23    echo "ChaCha20-Poly1305 (IETF) アルゴリズムのノンスサイズ: " . $chacha20IetfNonceSize . " バイト\n";
24
25    // キーワードに関連する AES-256-GCM アルゴリズムのノンスサイズも取得します。
26    // SODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES は、
27    // AES-256-GCM アルゴリズムのノンスの推奨バイトサイズを定義する定数です。
28    // この値も通常12です。
29    $aes256gcmNonceSize = SODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES;
30    echo "AES-256-GCM アルゴリズムのノンスサイズ: " . $aes256gcmNonceSize . " バイト\n\n";
31
32    echo "--- ノンス生成例 (ChaCha20-Poly1305 IETF の場合) ---\n";
33    try {
34        // 取得したサイズに基づき、暗号学的に安全なランダムなノンスを生成します。
35        // random_bytes() はPHP 7以降で利用可能な、安全なランダムバイトを生成する関数です。
36        $nonce = random_bytes($chacha20IetfNonceSize);
37        echo "生成されたノンス (バイナリ値を16進数で表示): " . bin2hex($nonce) . "\n";
38        echo "生成されたノンスの長さ: " . strlen($nonce) . " バイト\n";
39    } catch (Exception $e) {
40        // random_bytes() の呼び出し中にエラーが発生した場合 (例: 十分なエントロピーがない場合)
41        echo "ノンス生成エラー: " . $e->getMessage() . "\n";
42    }
43
44    echo "\nこれらのノンスサイズは、対応する暗号化関数 (例: sodium_crypto_aead_chacha20poly1305_ietf_encrypt)\n";
45    echo "に、適切な長さのノンスを渡すために必要不可欠な情報です。\n";
46}
47
48// 関数を実行して、Sodium拡張機能のノンスサイズ情報を表示します。
49displaySodiumAeadNonceSizes();

このサンプルコードは、PHPのSodium拡張機能で利用される重要なセキュリティ要素である「ノンス（Nonce）」について解説し、その推奨バイトサイズを取得する方法を示しています。ノンスは「number used once」の略で、暗号化の際に各メッセージに固有の、予測不可能なランダムな値として一度だけ使用されることを意味します。これにより、たとえ同じ鍵と平文であっても異なる暗号文が生成され、セキュリティが大幅に向上し、攻撃者が暗号文のパターンを分析するのを防ぎます。

SODIUM_CRYPTO_AEAD_CHACHA20POLY1305_IETF_NPUBBYTES定数は、ChaCha20-Poly1305 (IETFバージョン) というAEAD暗号化アルゴリズムで必要とされるノンスの推奨バイト数を整数値（int）で提供します。この定数は引数を持ちません。コードでは、この定数を用いてChaCha20-Poly1305 IETFの推奨ノンスサイズを取得し、表示しています。また、キーワードにもあるSODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES定数も同様にAES-256-GCMアルゴリズムの推奨ノンスサイズを返しており、その値も表示しています。

さらに、取得した推奨ノンスサイズに基づき、random_bytes()関数を使って実際に暗号学的に安全なノンスを生成する例も示しています。この生成されたノンスは、その長さが推奨サイズと一致することを確認しています。これらの推奨ノンスサイズは、対応する暗号化関数（例: sodium_crypto_aead_chacha20poly1305_ietf_encrypt）に適切な長さのノンスを渡すために非常に重要な情報となります。