sodium_crypto_aead_xchacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt — XChaCha20-Poly1305 を用いてメッセージを検証し、復号する(AEADモードのうちもっとも好ましい)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt(
    string $ciphertext,
    string $additional_data,
    string $nonce,
    #[\SensitiveParameter] string $key
): string|false

ChaCha20-Poly1305 (eXtended-nonce バリアント) を用いてメッセージを検証し、復号します。

一般的には、提供されている AEADモードの中で、 XChaCha20-Poly1305 を使うのがもっとも好ましいです。

ciphertext: sodium_crypto_aead_xchacha20poly1305_ietf_encrypt() が生成したフォーマット (暗号化されたテキスト、タグを連結したもの) でなければなりません。
additional_data: 追加の認証データ。これは、暗号化されたテキストに追加された認証タグを検証するのに用いられますが、このデータは暗号化されていませんし、暗号化されたテキストにも保存されていません。
nonce: メッセージごとに一度だけ使われる数値。長さは24バイトです。これは、 (たとえば、random_bytes()を使って) ランダムな値を生成するのに十分大きな長さです。
key: 暗号化キー(256ビット)

成功時にプレーンテキストを返します。失敗した場合に false を返します

There are no user contributed notes for this page.