sodium_crypto_aead_xchacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt(首选) 使用 XChaCha20-Poly1305 进行验证和解密

描述

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

使用 ChaCha20-Poly1305(扩展的 nonce 变体)进行验证和解密。

通常,XChaCha20-Poly1305 是提供的 AEAD 模式中最好的选择。

参数

ciphertext

必须采用由 sodium_crypto_aead_chacha20poly1305_ietf_encrypt() 提供的格式(密文和标签,串联)。

additional_data

额外的,经过身份验证的数据。它用于验证附加到密文的身份验证标签,但它不会被加密或存储在密文中。

nonce

每个消息只能使用一次的数字。长度为 24 字节。这对于随机生成(例如 random_bytes())来说是一个足够大的界限。

key

加密密钥(256 位)。

返回值

成功时返回明文,失败时返回 false

添加注释

用户贡献注释

此页面没有用户贡献注释。
To Top