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

Copy
1<?php
2
3/**
4 * PHP Sodium拡張の定数 SODIUM_CRYPTO_SIGN_BYTES の値と、
5 * キーワードに関連する sodium_crypto_box 関数の基本的な使用例を示します。
6 *
7 * SODIUM_CRYPTO_SIGN_BYTES はメッセージ署名のバイト数を示す定数であり、
8 * sodium_crypto_box とは異なる暗号機能（署名 vs 鍵交換・暗号化）に属します。
9 * しかし、どちらもPHPのSodium拡張によって提供される機能です。
10 *
11 * システムエンジニアを目指す初心者向けに、基本的な暗号化のワークフローと、
12 * 各機能が持つ固有の定数の存在を理解してもらうことを目的としています。
13 */
14function demonstrateSodiumFeatures(): void
15{
16    // Sodium拡張が利用可能か確認
17    if (!extension_loaded('sodium')) {
18        echo "エラー: PHP Sodium 拡張が利用できません。PHPを'--with-sodium'オプションでビルドしてください。\n";
19        return;
20    }
21
22    echo "--- Sodium 拡張の主要な定数情報 ---\n";
23    // SODIUM_CRYPTO_SIGN_BYTES は、署名機能で使用される署名データのバイト数を示します。
24    // このサンプルでは直接使用しませんが、他の暗号学的定数と合わせて紹介します。
25    echo "SODIUM_CRYPTO_SIGN_BYTES (署名データのバイト数): " . SODIUM_CRYPTO_SIGN_BYTES . " バイト\n";
26    echo "SODIUM_CRYPTO_BOX_PUBLICKEYBYTES (鍵交換用公開鍵のバイト数): " . SODIUM_CRYPTO_BOX_PUBLICKEYBYTES . " バイト\n";
27    echo "SODIUM_CRYPTO_BOX_SECRETKEYBYTES (鍵交換用秘密鍵のバイト数): " . SODIUM_CRYPTO_BOX_SECRETKEYBYTES . " バイト\n";
28    echo "SODIUM_CRYPTO_BOX_NONCEBYTES (鍵交換暗号化用ノンスのバイト数): " . SODIUM_CRYPTO_BOX_NONCEBYTES . " バイト\n";
29    echo "SODIUM_CRYPTO_BOX_MACBYTES (鍵交換暗号化用認証タグのバイト数): " . SODIUM_CRYPTO_BOX_MACBYTES . " バイト\n";
30    echo "\n";
31
32    echo "--- sodium_crypto_box の使用例 (鍵交換とメッセージ暗号化) ---\n";
33
34    // アリスとボブが安全に通信するための鍵ペアを生成します。
35    // 各鍵ペアは公開鍵と秘密鍵で構成されます。
36    // 公開鍵は共有しても安全ですが、秘密鍵は絶対に漏洩させてはなりません。
37    $aliceKeyPair = sodium_crypto_box_keypair();
38    $alicePublicKey = sodium_crypto_box_publickey($aliceKeyPair);
39    $aliceSecretKey = sodium_crypto_box_secretkey($aliceKeyPair);
40
41    $bobKeyPair = sodium_crypto_box_keypair();
42    $bobPublicKey = sodium_crypto_box_publickey($bobKeyPair);
43    $bobSecretKey = sodium_crypto_box_secretkey($bobKeyPair);
44
45    echo "アリスとボブの鍵ペアが生成されました。\n";
46
47    $originalMessage = "こんにちはボブ、これはアリスからの秘密のメッセージです。";
48    echo "元のメッセージ: \"{$originalMessage}\"\n";
49
50    // ノンス (Nonce: Number used once) を生成します。
51    // 各暗号化操作でユニークなノンスを使用することが非常に重要です。
52    // SODIUM_CRYPTO_BOX_NONCEBYTES 定数で必要なノンスのバイト数が定義されています。
53    $nonce = random_bytes(SODIUM_CRYPTO_BOX_NONCEBYTES);
54
55    // アリスがボブ宛にメッセージを暗号化します。
56    // アリスは自身の秘密鍵とボブの公開鍵を使用して共通鍵を導出し、メッセージを暗号化します。
57    $cipherText = sodium_crypto_box(
58        $originalMessage,
59        $nonce,
60        $bobPublicKey . $aliceSecretKey // 相手の公開鍵 + 自分の秘密鍵
61    );
62    echo "暗号化されたメッセージ (Base64エンコード): " . base64_encode($cipherText) . "\n";
63
64    // ボブがアリスからのメッセージを復号化します。
65    // ボブは自身の秘密鍵とアリスの公開鍵、そしてノンスを使用してメッセージを復号化します。
66    $decryptedMessage = sodium_crypto_box_open(
67        $cipherText,
68        $nonce,
69        $alicePublicKey . $bobSecretKey // 相手の公開鍵 + 自分の秘密鍵
70    );
71
72    if ($decryptedMessage !== false) {
73        echo "復号化されたメッセージ: \"{$decryptedMessage}\"\n";
74        if ($decryptedMessage === $originalMessage) {
75            echo "結果: メッセージは正常に暗号化され、復号化されました。一致しています。\n";
76        } else {
77            echo "結果: エラー - 復号化されたメッセージが元のメッセージと一致しません。\n";
78        }
79    } else {
80        echo "結果: エラー - メッセージの復号化に失敗しました。ノンスの不一致、鍵の誤り、またはデータ破損の可能性があります。\n";
81    }
82}
83
84// 関数を実行してデモンストレーションを開始します。
85demonstrateSodiumFeatures();

このサンプルコードは、PHP 8で利用できるSodium拡張の暗号化機能について、システムエンジニアを目指す初心者向けに解説しています。

まず、定数 SODIUM_CRYPTO_SIGN_BYTES は、デジタル署名を行う際に生成される署名データのバイト数（整数値）を示します。このコードでは、その値を出力し、他にも鍵交換や暗号化に関連する定数と合わせて、暗号機能におけるバイト数指定の重要性を紹介しています。

次に、主要な機能として sodium_crypto_box 関数を用いたメッセージの暗号化と復号化のワークフローを説明します。これは、アリスとボブといった通信相手が、お互いの公開鍵と自身の秘密鍵を組み合わせて安全に秘密のメッセージをやり取りする「鍵交換型暗号化」と呼ばれる方法です。

コードでは、まずアリスとボブがそれぞれ公開鍵と秘密鍵のペアを生成します。その後、アリスがボブへメッセージを送る際、自身の秘密鍵とボブの公開鍵、そして各暗号化操作でユニークに生成される「ノンス（Nonce: Number used once）」を用いてメッセージを暗号化します。sodium_crypto_box 関数は、元のメッセージ、ノンス、相手の公開鍵と自身の秘密鍵を結合した鍵情報を引数として受け取り、暗号化されたメッセージの文字列を戻り値として返します。

ボブは、自身の秘密鍵とアリスの公開鍵、そしてアリスから受け取ったノンスを使ってメッセージを復号化します。この一連の処理を通じて、安全な通信における鍵ペアとノンスの役割、そして定数が暗号機能の基礎としてどのように利用されているかを学ぶことができます。

Copy
1<?php
2
3/**
4 * Libsodium拡張の暗号学的定数に関する情報を提供する関数。
5 *
6 * システムエンジニアを目指す初心者向けに、Libsodium拡張が提供する
7 * いくつかの重要なバイト長定数の意味と値を示します。
8 *
9 * Libsodiumは、安全性と使いやすさを重視した、現代的な暗号ライブラリです。
10 * これらの定数は、暗号処理に必要なバッファサイズやデータの長さを決定する際に利用されます。
11 */
12function showLibsodiumCryptoConstants(): void
13{
14    echo "--- Libsodium 暗号学的定数情報 ---\n\n";
15
16    // プログラミング言語リファレンス情報で指定された定数:
17    // SODIUM_CRYPTO_SIGN_BYTES は、Ed25519署名アルゴリズムにおける
18    // 生成される署名（シグネチャ）のバイト長を表します。
19    // この値は、署名が常に固定サイズであることを示します。
20    echo "Ed25519署名バイト長 (SODIUM_CRYPTO_SIGN_BYTES): " . SODIUM_CRYPTO_SIGN_BYTES . " バイト\n";
21
22    // キーワードに関連する情報:
23    // sodium_crypto_aead_aes256gcm_npubbytes() は、
24    // AES256-GCM認証付き暗号化で使用される nonce (Number Used Once) の推奨バイト長を返します。
25    // nonceは、同じ鍵で複数回暗号化を行う際に異なる暗号文を生成するために使われる、
26    // 各暗号化操作で一意である必要があるランダム値です。
27    echo "AES256-GCM Nonceバイト長 (sodium_crypto_aead_aes256gcm_npubbytes()): " . sodium_crypto_aead_aes256gcm_npubbytes() . " バイト\n";
28
29    echo "\nセキュリティ関連の処理では、これらの定数が示す推奨値に従うことが非常に重要です。\n";
30    echo "正確なバイト長を把握することで、安全かつ効率的な暗号処理を実装できます。\n";
31}
32
33// 関数を実行して定数の値を出力します。
34showLibsodiumCryptoConstants();

このサンプルコードは、PHPのLibsodium拡張が提供する主要な暗号学的定数の意味と値を示すものです。Libsodiumは、安全かつ使いやすい現代的な暗号ライブラリであり、これらの定数は暗号処理に必要なデータの長さを定義します。

SODIUM_CRYPTO_SIGN_BYTES定数は、Ed25519署名アルゴリズムによって生成される署名（デジタルシグネチャ）のバイト長を表します。この定数の値は整数であり、Ed25519署名が常に固定の64バイトであることを示しています。これにより、署名検証時に必要なバッファサイズなどを事前に正確に把握できます。

また、サンプルコードではsodium_crypto_aead_aes256gcm_npubbytes()関数も紹介しています。この関数は、AES256-GCM認証付き暗号化で使用されるnonce（Number Used Once）の推奨バイト長を整数で返します。nonceは、同じ鍵で複数回暗号化を行う際に異なる暗号文を生成するために、各暗号化操作で一意である必要があるランダム値です。

セキュリティ関連の処理では、これらの定数が示す推奨値に従うことが非常に重要です。正確なバイト長を把握することで、安全で効率的な暗号処理を実装できます。