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

Copy
1<?php
2
3/**
4 * libsodium拡張機能の主要な定数および定数的な関数からセキュリティ関連のサイズ情報を表示します。
5 *
6 * この関数は、キー導出関数(KDF)のコンテキスト長と、
7 * AES-256-GCM認証付き暗号化で使用されるNonceのバイト数を表示します。
8 * これらの値は、暗号操作の安全性と正確な実装のために重要です。
9 *
10 * @return void
11 */
12function showSodiumSecuritySizeInfo(): void
13{
14    // SODIUM_CRYPTO_KDF_CONTEXTBYTES:
15    // キー導出関数 (Key Derivation Function; KDF) で使用される
16    // コンテキスト文字列の最小長を定義する定数です。
17    // コンテキストは、導出された鍵の用途を明確にし、異なる目的で同じ鍵が誤って使用されることを防ぎます。
18    // 例えば、認証用の鍵と暗号化用の鍵を区別する際に役立ちます。
19    echo 'SODIUM_CRYPTO_KDF_CONTEXTBYTES (KDFコンテキスト長): ' . SODIUM_CRYPTO_KDF_CONTEXTBYTES . ' bytes' . PHP_EOL;
20
21    // sodium_crypto_aead_aes256gcm_npubbytes():
22    // AES-256-GCM 認証付き暗号化で使用される Nonce (number used once) の長さを返す関数です。
23    // Nonceは、同じ鍵で暗号化するたびに異なる値を使用する必要がある使い捨ての数値です。
24    // これにより、同じ平文が暗号化されたとしても、常に異なる暗号文が生成され、
25    // セキュリティ上の脆弱性（例: リプレイ攻撃や情報漏洩）を防ぎます。
26    echo 'sodium_crypto_aead_aes256gcm_npubbytes (AES-256-GCM Nonce長): ' . sodium_crypto_aead_aes256gcm_npubbytes() . ' bytes' . PHP_EOL;
27}
28
29// 関数を呼び出して、libsodiumのセキュリティ関連のサイズ情報を表示します。
30showSodiumSecuritySizeInfo();
31

このPHPコードは、暗号化ライブラリであるlibsodium拡張機能が提供する、セキュリティ上重要なバイトサイズ情報を示しています。具体的には、鍵の導出やデータの暗号化に用いられる特定の要素の推奨される長さを表示します。

SODIUM_CRYPTO_KDF_CONTEXTBYTESは、キー導出関数（Key Derivation Function; KDF）において、生成される鍵の用途を明確にするための「コンテキスト」と呼ばれる識別子の最小バイト数を定義する定数です。この定数は整数型（int）の値を持ち、異なる目的で同じ鍵が誤って使用されることを防ぎ、セキュリティを向上させる役割があります。

また、sodium_crypto_aead_aes256gcm_npubbytes()は、AES-256-GCMという認証付き暗号化アルゴリズムで使用されるNonce（Number Used Once; 使い捨ての数値）のバイト長を返す関数です。この関数は引数を取らず、Nonceの推奨される長さを整数型（int）で提供します。Nonceは、同じ平文が複数回暗号化される場合でも常に異なる暗号文が生成されるようにするために不可欠であり、リプレイ攻撃などのセキュリティ脆弱性を防ぐ上で極めて重要です。

これらの定数や関数は、暗号操作の安全性と正確な実装のために必要なバイトサイズ情報を提供しており、安全なシステムを構築する上で欠かせない要素となります。

Copy
1<?php
2
3/**
4 * libsodium拡張機能を使った公開鍵暗号化・復号化のサンプルコード
5 *
6 * システムエンジニアを目指す初心者向けに、SODIUM_CRYPTO_KDF_CONTEXTBYTES 定数の値と
7 * sodium_crypto_box 関数による基本的な暗号化・復号化のワークフローを示します。
8 *
9 * 注: SODIUM_CRYPTO_KDF_CONTEXTBYTES は鍵導出関数 (KDF) に関連する定数であり、
10 * sodium_crypto_box とは直接的な使用関係はありませんが、どちらもPHPのlibsodium拡張機能の一部です。
11 */
12function demonstrateSodiumCryptoBox(): void
13{
14    // libsodium拡張機能が利用可能か確認
15    if (!extension_loaded('sodium')) {
16        echo "エラー: libsodium拡張機能が有効になっていません。\n";
17        echo "php.iniで 'extension=sodium' を有効にしてください。\n";
18        return;
19    }
20
21    // SODIUM_CRYPTO_KDF_CONTEXTBYTES 定数の値を出力
22    // この定数は、鍵導出関数で使用されるコンテキストのバイト長を示します。
23    // 今回のサンプルでは直接使用しませんが、libsodium拡張機能の一部として紹介します。
24    echo "SODIUM_CRYPTO_KDF_CONTEXTBYTES の値: " . SODIUM_CRYPTO_KDF_CONTEXTBYTES . " バイト\n\n";
25
26    echo "--- libsodium公開鍵暗号化 (sodium_crypto_box) のデモンストレーション ---\n";
27
28    // 1. アリスとボブの鍵ペアを生成
29    // sodium_crypto_box_keypair() は公開鍵と秘密鍵を連結したものを返します。
30    $aliceKeypair = sodium_crypto_box_keypair();
31    $bobKeypair = sodium_crypto_box_keypair();
32
33    // 鍵ペアから公開鍵と秘密鍵を抽出
34    $alicePublicKey = sodium_crypto_box_publickey($aliceKeypair);
35    $aliceSecretKey = sodium_crypto_box_secretkey($aliceKeypair);
36
37    $bobPublicKey = sodium_crypto_box_publickey($bobKeypair);
38    $bobSecretKey = sodium_crypto_box_secretkey($bobKeypair);
39
40    echo "アリスの公開鍵 (hex): " . bin2hex($alicePublicKey) . "\n";
41    echo "ボブの公開鍵 (hex): " . bin2hex($bobPublicKey) . "\n\n";
42
43    // 2. 送信するメッセージ
44    $message = "こんにちは、ボブ！これはアリスからの秘密のメッセージです。";
45    echo "元のメッセージ: " . $message . "\n";
46
47    // 3. ノンス (Nonce) の生成
48    // ノンスは使い捨てのランダムな値で、各メッセージに対してユニークである必要があります。
49    // 同じ鍵ペアで複数のメッセージを暗号化する場合、異なるノンスを使用することが非常に重要です。
50    // SODIUM_CRYPTO_BOX_NONCEBYTES は、必要なノンスのバイト長を示す定数です。
51    $nonce = random_bytes(SODIUM_CRYPTO_BOX_NONCEBYTES);
52    echo "生成されたノンス (hex): " . bin2hex($nonce) . "\n";
53    echo "ノンスの長さ: " . strlen($nonce) . " バイト (期待値: " . SODIUM_CRYPTO_BOX_NONCEBYTES . ")\n\n";
54
55    // 4. アリスがボブの公開鍵と自身の秘密鍵を使ってメッセージを暗号化
56    // sodium_crypto_box 関数は、メッセージを暗号化し、さらにメッセージが改ざんされていないことを
57    // 保証する認証タグも付与します（認証付き暗号）。
58    $ciphertext = sodium_crypto_box($message, $nonce, $bobPublicKey, $aliceSecretKey);
59    echo "暗号化されたメッセージ (hex): " . bin2hex($ciphertext) . "\n";
60    echo "暗号化されたメッセージの長さ: " . strlen($ciphertext) . " バイト\n\n";
61
62    // 5. ボブがアリスの公開鍵と自身の秘密鍵、そして同じノンスを使ってメッセージを復号化
63    // sodium_crypto_box_open 関数は、メッセージの認証を行い、問題なければ復号化します。
64    // メッセージが改ざんされている場合や、鍵ペア、ノンスが正しくない場合は false を返します。
65    $decryptedMessage = sodium_crypto_box_open($ciphertext, $nonce, $alicePublicKey, $bobSecretKey);
66
67    if ($decryptedMessage !== false) {
68        echo "復号化されたメッセージ: " . $decryptedMessage . "\n";
69        echo "復号化成功！メッセージは安全に送受信されました。\n";
70    } else {
71        echo "復号化に失敗しました。\n";
72        echo "メッセージが改ざんされたか、鍵ペアまたはノンスが間違っている可能性があります。\n";
73    }
74}
75
76// サンプル関数を実行
77demonstrateSodiumCryptoBox();

このPHPサンプルコードは、libsodium拡張機能を用いた公開鍵暗号化の基本的な流れをシステムエンジニアを目指す初心者向けに示しています。

まず、SODIUM_CRYPTO_KDF_CONTEXTBYTESは、鍵導出関数（KDF）で使用されるコンテキストのバイト長を示す整数型の定数です。この定数自体は、本サンプルの公開鍵暗号化処理に直接は使用されませんが、PHPのlibsodium拡張機能が提供する多くの定数の一つとして紹介されています。

本コードの主要な機能は、sodium_crypto_box関数とsodium_crypto_box_open関数によるメッセージの暗号化と復号化です。 sodium_crypto_boxは、送信者の秘密鍵と受信者の公開鍵、そして使い捨てのユニークな値であるノンス（Nonce）を引数にとり、平文のメッセージを認証付き暗号文に変換します。これにより、メッセージの機密性だけでなく、改ざんされていないこと（認証）も保証されます。戻り値は、暗号化されたメッセージデータです。 一方、sodium_crypto_box_openは、暗号文、使用されたノンス、送信者の公開鍵、受信者の秘密鍵を引数にとり、メッセージの認証を行いながら復号を試みます。認証と復号が成功すれば元のメッセージ（文字列）を返し、メッセージが改ざんされていたり、鍵やノンスが正しくない場合はfalseを返します。この一連のプロセスにより、安全な通信が実現されます。