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

Copy
1<?php
2
3// SODIUM_CRYPTO_SCALARMULT_SCALARBYTES 定数は、
4// crypto_scalarmult 演算で使用されるスカラー（秘密鍵）の推奨バイト長を示します。
5echo "スカラー（秘密鍵）の推奨バイト長: " . SODIUM_CRYPTO_SCALARMULT_SCALARBYTES . " バイト\n\n";
6
7// ここでは、アリスとボブが安全な通信のための共有シークレットを生成するシナリオをシミュレートします。
8// 各自が秘密鍵（スカラー）を生成し、その長さには SODIUM_CRYPTO_SCALARMULT_SCALARBYTES を使用します。
9
10// アリスの秘密鍵（スカラー）を生成します。
11// random_bytes 関数で推奨されるバイト長のランダムなバイト列を生成します。
12$aliceSecretKey = random_bytes(SODIUM_CRYPTO_SCALARMULT_SCALARBYTES);
13echo "アリスの秘密鍵の長さ: " . strlen($aliceSecretKey) . " バイト\n";
14echo "アリスの秘密鍵 (hex): " . bin2hex($aliceSecretKey) . "\n\n";
15
16// ボブの秘密鍵（スカラー）を生成します。
17$bobSecretKey = random_bytes(SODIUM_CRYPTO_SCALARMULT_SCALARBYTES);
18echo "ボブの秘密鍵の長さ: " . strlen($bobSecretKey) . " バイト\n";
19echo "ボブの秘密鍵 (hex): " . bin2hex($bobSecretKey) . "\n\n";
20
21// アリスとボブは各自の秘密鍵から公開鍵を生成し、お互いに交換します。
22// sodium_crypto_scalarmult_base は、与えられた秘密鍵から対応する公開鍵を導出します。
23$alicePublicKey = sodium_crypto_scalarmult_base($aliceSecretKey);
24echo "アリスの公開鍵 (hex): " . bin2hex($alicePublicKey) . "\n\n";
25
26$bobPublicKey = sodium_crypto_scalarmult_base($bobSecretKey);
27echo "ボブの公開鍵 (hex): " . bin2hex($bobPublicKey) . "\n\n";
28
29// 各自が「相手の公開鍵」と「自分の秘密鍵」を使って共有シークレットを計算します。
30// sodium_crypto_scalarmult 関数は、この2つの情報から共通のシークレットを生成します。
31$aliceSharedSecret = sodium_crypto_scalarmult($aliceSecretKey, $bobPublicKey);
32echo "アリスが計算した共有シークレット (hex): " . bin2hex($aliceSharedSecret) . "\n\n";
33
34$bobSharedSecret = sodium_crypto_scalarmult($bobSecretKey, $alicePublicKey);
35echo "ボブが計算した共有シークレット (hex): " . bin2hex($bobSharedSecret) . "\n\n";
36
37// アリスとボブが計算した共有シークレットは一致するはずです。
38if ($aliceSharedSecret === $bobSharedSecret) {
39    echo "✔ アリスとボブの共有シークレットは一致しました。安全な通信が可能です。\n";
40} else {
41    echo "✖ エラー: 共有シークレットが一致しませんでした。\n";
42}
43
44// 注意: ここで生成された共有シークレットは、通常、直接暗号化鍵として使用する前に、
45// 鍵導出関数 (KDF) を通してさらに強化することが推奨されます。
46
47?>

PHP 8のSODIUM_CRYPTO_SCALARMULT_SCALARBYTES定数は、暗号演算の一つであるcrypto_scalarmultで利用される「スカラー」（秘密鍵にあたる部分）の推奨されるバイト長を示す整数値（int）です。この定数は、PHPのSodium拡張機能の一部であり、安全な暗号通信の基盤となる共有シークレットを生成する際に重要となります。

サンプルコードでは、この定数を用いてアリスとボブが共通の秘密情報を安全に生成するプロセスをシミュレートしています。まず、SODIUM_CRYPTO_SCALARMULT_SCALARBYTESで示される推奨バイト長に基づいて、各自が自身の秘密鍵（スカラー）を生成します。その後、その秘密鍵から公開鍵を導出し、お互いに交換します。最終的に、自分の秘密鍵と相手の公開鍵を組み合わせてsodium_crypto_scalarmult関数を実行することで、アリスとボブ双方で全く同じ共有シークレットが計算されることを示しています。これにより、お互いに知られることなく安全な通信が可能となる共有の秘密が確立されます。この定数を使用することで、暗号処理に必要な適切な鍵長を簡単に得ることができます。

Copy
1<?php
2
3/**
4 * SODIUM_CRYPTO_SCALARMULT_SCALARBYTES 定数を使用して、
5 * Ed25519 楕円曲線暗号のスカラ乗算における秘密鍵（スカラ）のサイズと、
6 * その生成、そして sodium_crypto_scalarmult_ed25519_noclamp 関数の鍵交換での使用例を示します。
7 *
8 * この定数は、Ed25519/X25519 鍵交換プロトコルで使われるスカラ（秘密鍵）のバイト数を示します。
9 */
10function demonstrateEd25519KeyExchangeNoclamp(): void
11{
12    // SODIUM_CRYPTO_SCALARMULT_SCALARBYTES 定数の値を取得し表示します。
13    // この定数は、Ed25519 スカラ乗算で使用する秘密鍵（スカラ）のバイト数を定義します。
14    $scalarBytes = SODIUM_CRYPTO_SCALARMULT_SCALARBYTES;
15    echo "SODIUM_CRYPTO_SCALARMULT_SCALARBYTES の値: " . $scalarBytes . " バイト\n";
16    echo "これは Ed25519 秘密鍵（スカラ）の推奨サイズです。\n\n";
17
18    // --- アリスとボブの鍵交換のシミュレーション ---
19
20    // 1. アリスの秘密鍵（スカラ）と公開鍵の生成
21    // 秘密鍵は SODIUM_CRYPTO_SCALARMULT_SCALARBYTES で指定された長さで生成します。
22    $aliceSecretScalar = sodium_randombytes($scalarBytes);
23    // Ed25519の秘密鍵から対応する公開鍵を導出します。
24    // sodium_crypto_scalarmult_ed25519_base は秘密鍵を引数に取り、公開鍵を返します。
25    $alicePublicKey = sodium_crypto_scalarmult_ed25519_base($aliceSecretScalar);
26
27    echo "アリスの秘密鍵（スカラ） (Hex): " . sodium_bin2hex($aliceSecretScalar) . "\n";
28    echo "アリスの公開鍵 (Hex): " . sodium_bin2hex($alicePublicKey) . "\n\n";
29
30    // 2. ボブの秘密鍵（スカラ）と公開鍵の生成
31    $bobSecretScalar = sodium_randombytes($scalarBytes);
32    $bobPublicKey = sodium_crypto_scalarmult_ed25519_base($bobSecretScalar);
33
34    echo "ボブの秘密鍵（スカラ） (Hex): " . sodium_bin2hex($bobSecretScalar) . "\n";
35    echo "ボブの公開鍵 (Hex): " . sodium_bin2hex($bobPublicKey) . "\n\n";
36
37    // 3. 共有シークレットの計算
38    // お互いの秘密鍵と相手の公開鍵を使って、それぞれが共有シークレットを計算します。
39    // sodium_crypto_scalarmult_ed25519_noclamp 関数は、スカラと曲線上の点（公開鍵）を引数に取ります。
40    // これは Ed25519 カーブ上で直接スカラ乗算を行うため、通常の X25519 鍵交換とは内部的な処理が異なります。
41    // ここで生成される共有シークレットは、メッセージ暗号化のための共通鍵を導出するために使用できます。
42
43    // アリスが計算する共有シークレット: 自分の秘密鍵 + ボブの公開鍵
44    $aliceSharedSecret = sodium_crypto_scalarmult_ed25519_noclamp($aliceSecretScalar, $bobPublicKey);
45
46    // ボブが計算する共有シークレット: 自分の秘密鍵 + アリスの公開鍵
47    $bobSharedSecret = sodium_crypto_scalarmult_ed25519_noclamp($bobSecretScalar, $alicePublicKey);
48
49    echo "アリスが計算した共有シークレット (Hex): " . sodium_bin2hex($aliceSharedSecret) . "\n";
50    echo "ボブが計算した共有シークレット (Hex): " . sodium_bin2hex($bobSharedSecret) . "\n\n";
51
52    // 4. 共有シークレットの一致確認
53    // 両者が計算した共有シークレットが一致すれば、安全な鍵交換が成功したことになります。
54    if ($aliceSharedSecret === $bobSharedSecret) {
55        echo "共有シークレットは一致しました。Ed25519 鍵交換が成功しました。\n";
56        echo "この共有シークレットは、後続の暗号化操作のキーとして利用できます。\n";
57    } else {
58        echo "エラー: 共有シークレットが一致しませんでした。\n";
59    }
60}
61
62// 関数を実行
63demonstrateEd25519KeyExchangeNoclamp();
64
65?>

PHPのSODIUM_CRYPTO_SCALARMULT_SCALARBYTESは、Ed25519楕円曲線暗号のスカラ乗算、特に鍵交換プロトコルで使われる秘密鍵（スカラ）の推奨バイト数を示す整数定数です。この定数を使用することで、安全な暗号操作に必要な正しいサイズの秘密鍵を生成できます。

サンプルコードでは、この定数を用いてEd25519鍵交換のプロセスを具体的に示しています。まず、SODIUM_CRYPTO_SCALARMULT_SCALARBYTESの値を取得し、秘密鍵のサイズを確認します。次に、アリスとボブという二者間の鍵交換をシミュレーションします。

アリスとボブはそれぞれ、sodium_randombytes関数でこの定数が示す長さのランダムな秘密鍵（スカラ）を生成します。そして、sodium_crypto_scalarmult_ed25519_base関数を用いて、それぞれの秘密鍵から対応する公開鍵を導出します。これらの関数は、バイト列としての秘密鍵を受け取り、対応するバイト列としての公開鍵を返します。

最終的に、アリスは自身の秘密鍵とボブの公開鍵を、ボブは自身の秘密鍵とアリスの公開鍵をそれぞれ使用し、sodium_crypto_scalarmult_ed25519_noclamp関数で共有シークレットを計算します。この関数は秘密鍵（スカラ）と相手の公開鍵（曲線上の点）を引数にとり、共通の共有シークレットをバイト列として返します。両者が計算した共有シークレットが一致すれば、安全な鍵交換が成功したことになり、この共有シークレットはメッセージの暗号化などに利用できます。