PHPの crypto_secretbox() 関数について解説

こんにちは！今日はPHPのSodiumライブラリで提供されている強力な暗号化関数、crypto_secretbox() についてご紹介します。この関数は、対称鍵暗号を使用してデータを安全に暗号化・復号するために使われます。

crypto_secretbox() 関数とは？

crypto_secretbox() は、データを対称鍵暗号方式で暗号化するための関数です。この暗号化方式では、同じ鍵を使って暗号化と復号を行います。データの安全性を確保するために、ランダムなナンス（nonce）と呼ばれる値が使われます。

この関数を使用すると、データの機密性が保証されるだけでなく、改ざん検出機能も備わります。つまり、暗号化されたデータが第三者によって変更された場合、復号が失敗するように設計されています。

基本的な使い方

string sodium_crypto_secretbox(string $message, string $nonce, string $key)

$message: 暗号化するデータ（プレーンテキスト）。
$nonce: ナンス（ランダムで一意の値）。SODIUM_CRYPTO_SECRETBOX_NONCEBYTES バイトの長さが必要です。
$key: 暗号化に使用する秘密鍵。SODIUM_CRYPTO_SECRETBOX_KEYBYTES バイトの長さが必要です。

この関数は、暗号化されたメッセージを返します。

例

<?php
$message = "これは秘密のメッセージです";
$key = random_bytes(SODIUM_CRYPTO_SECRETBOX_KEYBYTES);
$nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);

// メッセージを暗号化
$ciphertext = sodium_crypto_secretbox($message, $nonce, $key);

echo bin2hex($ciphertext) . "\n";
?>

このコードでは、$message を指定した nonce と key を使って暗号化しています。暗号化された結果はバイナリ形式のデータであり、安全に保存・送信することができます。

暗号化されたデータの復号

データを復号するには、sodium_crypto_secretbox_open() 関数を使用します。

<?php
$decrypted = sodium_crypto_secretbox_open($ciphertext, $nonce, $key);

if ($decrypted === false) {
    echo "復号に失敗しました。データが改ざんされた可能性があります。\n";
} else {
    echo "復号されたメッセージ: " . $decrypted . "\n";
}
?>