PHP マニュアル: 暗号化されたテキストが、有効なタグを持っているかを調べる

説明

stringfalse sodium_crypto_aead_chacha20poly1305_ietf_decrypt(
    string $ciphertext,
    string $additional_data,
    string $nonce,
    string $key
)

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

IETF バリアントは、96ビットの nonce と 32ビットの内部カウンタを持ちます。標準では、nonce, 内部カウンタともに64ビットです。

パラメータ

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

戻り値

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