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

Copy
1<?php
2
3/**
4 * Libsodiumの認証付き公開鍵暗号化機能 (sodium_crypto_box) の使用例を示します。
5 * また、指定された定数 SODIUM_CRYPTO_SIGN_SEEDBYTES の値も出力します。
6 *
7 * SODIUM_CRYPTO_SIGN_SEEDBYTES は署名鍵生成のシード長を示す定数であり、
8 * ここで主に扱う sodium_crypto_box 関数による暗号化・復号化とは直接的な用途は異なります。
9 * しかし、これらはPHPのSodium拡張に含まれる機能の一部です。
10 *
11 * @return void
12 */
13function demonstrateSodiumCryptoBoxCommunication(): void
14{
15    // PHP 8 の Libsodium 拡張はデフォルトで有効です。
16
17    // 指定された定数 SODIUM_CRYPTO_SIGN_SEEDBYTES の値を確認します。
18    // この定数は主にデジタル署名機能で使用されるシードのバイト長を示します。
19    echo 'SODIUM_CRYPTO_SIGN_SEEDBYTES の値: ' . SODIUM_CRYPTO_SIGN_SEEDBYTES . PHP_EOL . PHP_EOL;
20
21    echo "--- Libsodium (sodium_crypto_box) を使用した安全なメッセージ交換 ---" . PHP_EOL . PHP_EOL;
22
23    // 1. 鍵ペアの生成
24    // アリス（送信者）とボブ（受信者）それぞれが公開鍵と秘密鍵のペアを生成します。
25    // 公開鍵は安全に共有され、秘密鍵は厳重に保管されます。
26    $aliceKeyPair = sodium_crypto_box_keypair();
27    $alicePublicKey = sodium_crypto_box_publickey_from_keypair($aliceKeyPair);
28    $aliceSecretKey = sodium_crypto_box_secretkey_from_keypair($aliceKeyPair);
29
30    $bobKeyPair = sodium_crypto_box_keypair();
31    $bobPublicKey = sodium_crypto_box_publickey_from_keypair($bobKeyPair);
32    $bobSecretKey = sodium_crypto_box_secretkey_from_keypair($bobKeyPair);
33
34    echo "✔ 鍵ペアの生成が完了しました。" . PHP_EOL;
35    echo "   アリス公開鍵 (一部): " . substr(bin2hex($alicePublicKey), 0, 16) . "..." . PHP_EOL;
36    echo "   ボブ公開鍵 (一部):   " . substr(bin2hex($bobPublicKey), 0, 16) . "..." . PHP_EOL . PHP_EOL;
37
38    // 2. メッセージと Nonce (Nonce は Number used once の略) の準備
39    // Nonce は各暗号化操作で一意である必要があり、予測不可能であるべきです。
40    // 同じ鍵ペアで複数のメッセージを暗号化する場合、毎回異なる Nonce を使用しなければなりません。
41    $originalMessage = 'Hello Bob, this is a very secret message from Alice!';
42    $nonce = random_bytes(SODIUM_CRYPTO_BOX_NONCEBYTES); // Nonce のバイト長は SODIUM_CRYPTO_BOX_NONCEBYTES で定義されています。
43
44    echo "✔ 暗号化するメッセージの準備ができました。" . PHP_EOL;
45    echo "   元のメッセージ: '" . $originalMessage . "'" . PHP_EOL;
46    echo "   生成された Nonce (一部): " . substr(bin2hex($nonce), 0, 16) . "..." . PHP_EOL . PHP_EOL;
47
48    // 3. アリスがボブの公開鍵と自身の秘密鍵を使ってメッセージを暗号化
49    // sodium_crypto_box は認証付き暗号化を提供し、メッセージの機密性と完全性を保証します。
50    $cipherText = sodium_crypto_box(
51        $originalMessage,
52        $nonce,
53        $bobPublicKey,    // 受信者（ボブ）の公開鍵
54        $aliceSecretKey   // 送信者（アリス）の秘密鍵
55    );
56
57    echo "✔ メッセージがアリスによって暗号化されました。" . PHP_EOL;
58    echo "   暗号化されたデータ (一部): " . substr(bin2hex($cipherText), 0, 16) . "..." . PHP_EOL . PHP_EOL;
59
60    // 4. ボブがアリスの公開鍵と自身の秘密鍵を使ってメッセージを復号化
61    // 復号化には、暗号化時と同じ Nonce、送信者の公開鍵、受信者の秘密鍵が必要です。
62    $decryptedMessage = sodium_crypto_box_open(
63        $cipherText,
64        $nonce,
65        $alicePublicKey, // 送信者（アリス）の公開鍵
66        $bobSecretKey    // 受信者（ボブ）の秘密鍵
67    );
68
69    echo "✔ ボブがメッセージを復号化しようとしています..." . PHP_EOL;
70    if ($decryptedMessage !== false) {
71        echo "   復号化されたメッセージ: '" . $decryptedMessage . "'" . PHP_EOL;
72        echo "   メッセージの一致確認: " . ($originalMessage === $decryptedMessage ? '成功！' : '失敗') . PHP_EOL;
73    } else {
74        echo "   復号化に失敗しました。メッセージが改ざんされたか、鍵またはNonceが間違っています。" . PHP_EOL;
75    }
76    echo PHP_EOL;
77}
78
79// 関数の実行
80demonstrateSodiumCryptoBoxCommunication();
81

このコードは、PHPのLibsodium拡張機能に含まれる定数 SODIUM_CRYPTO_SIGN_SEEDBYTES の値を出力します。この定数は、デジタル署名機能を生成する際のシードのバイト長を整数値で示しています。

また、Libsodiumの sodium_crypto_box 関数を使った認証付き公開鍵暗号化の具体的な使用例を紹介しています。この機能は、メッセージの機密性（内容が漏れないこと）と完全性（改ざんされていないこと）を保証し、安全な通信を実現します。

コードでは、まず sodium_crypto_box_keypair() 関数を用いて公開鍵と秘密鍵のペアを生成し、sodium_crypto_box_publickey_from_keypair() と sodium_crypto_box_secretkey_from_keypair() でそれぞれの鍵を抽出します。これらの関数は引数なし、または鍵ペアを引数に取り、鍵データ（文字列）を返します。次に、暗号化するメッセージと、各暗号化操作で一意である必要がある Nonce（Number used once）を準備します。

メッセージの暗号化は sodium_crypto_box() 関数で行います。この関数は、元のメッセージ、Nonce、受信者の公開鍵、送信者の秘密鍵を引数として受け取り、暗号化されたデータを文字列で返します。復号化には sodium_crypto_box_open() 関数を使用し、暗号化されたデータ、同じ Nonce、送信者の公開鍵、受信者の秘密鍵を引数に渡します。復号が成功すれば元のメッセージが文字列として返され、失敗した場合は false が返されます。この一連の流れは、PHPアプリケーションで安全な情報交換を行うための基本的な暗号化通信の仕組みを具体的に示しています。

Copy
1<?php
2
3/**
4 * libsodium 拡張機能における主要な定数の情報を表示します。
5 * SODIUM_CRYPTO_SIGN_SEEDBYTES 定数の役割と、関連キーワードの定数との違いを
6 * システムエンジニアを目指す初心者にも分かりやすく説明します。
7 */
8function displaySodiumConstantsInfo(): void
9{
10    // PHP sodium 拡張機能が有効になっているかを確認します。
11    // この拡張機能は、安全な暗号化やデジタル署名などの機能を提供します。
12    if (!extension_loaded('sodium')) {
13        echo "エラー: PHP sodium 拡張機能が有効になっていません。\n";
14        echo "この機能を利用するには、PHP sodium 拡張機能を有効にする必要があります。\n";
15        return;
16    }
17
18    // SODIUM_CRYPTO_SIGN_SEEDBYTES 定数の値とその意味を表示します。
19    // この定数は、デジタル署名のための鍵ペアを生成する際に必要となる
20    // 「シード」（乱数の種）のバイト数（データの長さ）を示します。
21    // ed25519 署名アルゴリズムで使用されます。
22    $signSeedBytes = SODIUM_CRYPTO_SIGN_SEEDBYTES;
23    echo "SODIUM_CRYPTO_SIGN_SEEDBYTES: " . $signSeedBytes . " バイト\n";
24    echo "  - これは、デジタル署名用の秘密鍵と公開鍵のペアを安全に生成するために必要な、\n";
25    echo "    ランダムなデータの長さ（シードのバイト数）を示します。\n";
26    echo "  - このシードから鍵ペアが決定論的に生成されるため、安全なシードの生成が非常に重要です。\n\n";
27
28    // キーワードに関連する SODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES 定数の値とその意味を表示します。
29    // この定数は、認証付き暗号化（AES256-GCM）で使用される「ノンス」（使い捨ての数字）のバイト数を示します。
30    // ノンスは、同じ鍵で複数のメッセージを暗号化する際に、各メッセージで異なる値を使用することで、
31    // 暗号の安全性を確保するために不可欠です。
32    $aeadNpubBytes = SODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES;
33    echo "SODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES: " . $aeadNpubBytes . " バイト\n";
34    echo "  - これは、データを安全に暗号化・復号化する際に使用する「ノンス」（Nonce：Number used once）の\n";
35    echo "    推奨されるデータの長さを示します。\n";
36    echo "  - ノンスは、暗号化のたびに異なる値を使用する必要があり、暗号文の漏洩を防ぐ上で重要です。\n\n";
37
38    echo "これらの定数は、libsodium が提供する様々な暗号学的操作（署名や暗号化）が\n";
39    echo "それぞれの目的のために必要とするデータの正確なバイト数を示しています。\n";
40    echo "これらの値に基づいて適切な長さのデータを扱うことで、暗号操作の安全性が保証されます。\n";
41}
42
43// 関数を実行し、定数に関する情報を表示します。
44displaySodiumConstantsInfo();
45
46?>

このPHPのサンプルコードは、libsodium拡張機能が提供する重要な暗号学的定数について紹介しています。特に、SODIUM_CRYPTO_SIGN_SEEDBYTES定数は、デジタル署名を行うための秘密鍵と公開鍵のペアを安全に生成する際に必要となる「シード」（乱数の種）の推奨されるバイト数、つまりデータの長さを示します。この定数に引数はなく、その値は整数（int）として返されます。安全な署名鍵の生成には、この定数が示す正確な長さのランダムなシードが不可欠です。

また、キーワードとして挙げられているSODIUM_CRYPTO_AEAD_AES256GCM_NPUBBYTES定数も表示しています。こちらは、データを認証付きで暗号化・復号化する際に使用する「ノンス」（Nonce：Number used once、使い捨ての数字）の推奨されるバイト数を示します。ノンスは、同じ鍵で複数の情報を暗号化する際に、それぞれの暗号化で異なる値を用いることで、暗号の安全性を保証するために非常に重要な役割を担います。

これらの定数は、libsodiumが提供するデジタル署名やデータ暗号化といった暗号学的操作が、その機能を実現するために必要とするデータの正確な長さを開発者に示します。これにより、適切な長さのデータを扱うことで、暗号操作の信頼性と安全性が確保されることを理解できます。