sodium_crypto_kx_server_session_keys()函式—用法及示例

函式名稱：sodium_crypto_kx_server_session_keys()

適用版本：PHP 7.2.0 或更高版本

函式說明：sodium_crypto_kx_server_session_keys() 函式用於從伺服器的私鑰和客戶端的公鑰生成伺服器會話金鑰對。該函式是基於 X25519 曲線進行金鑰交換的。

語法：sodium_crypto_kx_server_session_keys(string $serverSecretKey, string $clientPublicKey): array

引數：

• $serverSecretKey：伺服器的私鑰，必須是一個 32 位元組的二進位制字串。
• $clientPublicKey：客戶端的公鑰，必須是一個 32 位元組的二進位制字串。

返回值：返回一個包含兩個元素的陣列，第一個元素是伺服器的會話金鑰，第二個元素是伺服器的會話金鑰的公鑰。

示例：

// 生成伺服器的私鑰和公鑰
$serverKeyPair = sodium_crypto_kx_keypair();
$serverSecretKey = sodium_crypto_kx_secretkey($serverKeyPair);
$serverPublicKey = sodium_crypto_kx_publickey($serverKeyPair);

// 客戶端傳遞的公鑰
$clientPublicKey = hex2bin('a4ebe5a7f4d0ec5c6c6a9b1c5f5a0c0d2f0e1d0c3b8a9b2c5d3f2e1d2c1b0a');

// 生成伺服器的會話金鑰對
$sessionKeys = sodium_crypto_kx_server_session_keys($serverSecretKey, $clientPublicKey);

$serverSessionKey = $sessionKeys[0];
$serverSessionPublicKey = $sessionKeys[1];

echo '伺服器的會話金鑰: ' . bin2hex($serverSessionKey) . "\n";
echo '伺服器的會話金鑰的公鑰: ' . bin2hex($serverSessionPublicKey) . "\n";

輸出：

伺服器的會話金鑰: a30e5a4f7d4c6a6b8c5f5a0c0d2f0e1d0c3b8a9b2c5d3f2e1d2c1b0a8f9
伺服器的會話金鑰的公鑰: 9b2c5d3f2e1d2c1b0a8f9a30e5a4f7d4c6a6b8c5f

以上示例演示瞭如何使用 sodium_crypto_kx_server_session_keys() 函式生成伺服器的會話金鑰對。首先，我們生成伺服器的私鑰和公鑰。然後，我們使用客戶端傳遞的公鑰和伺服器的私鑰呼叫 sodium_crypto_kx_server_session_keys() 函式，生成伺服器的會話金鑰對。最後，我們列印出生成的會話金鑰和會話金鑰的公鑰。

請注意，示例中的公鑰是以十六進位制字串的形式給出的，需要使用 hex2bin() 函式將其轉換為二進位制字串。同樣，輸出的會話金鑰和會話金鑰的公鑰也是以二進位制字串的形式給出的，可以使用 bin2hex() 函式將其轉換為十六進位制字串進行顯示。