sodium_crypto_aead_chacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_chacha20poly1305_ietf_decrypt — Vérifie que le texte chiffré inclut une étiquette valide

Description

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

Vérifie puis déchiffre avec ChaCha20-Poly1305 (variante IETF).

La variante IETF utilise des nonces de 96 bits et des compteurs internes de 32 bits, au lieu de 64 bits pour les deux.

Liste de paramètres

ciphertext: Doit être au format fourni par sodium_crypto_aead_chacha20poly1305_ietf_encrypt() (texte chiffré et étiquette, concaténés).
additional_data: Additionnel, données authentifiées. Cela est utilisé dans la vérification de l'étiquette d'authentification ajoutée au texte chiffré, mais il n'est pas chiffré ou stocké dans le texte chiffré.
nonce: Un nombre qui doit être utilisé une seule fois, par message. 12 octets de long.
key: La clé de chiffrement (256 bits).

Valeurs de retour

Renvoie le texte en clair en cas de succès, ou false si une erreur survient.

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

joy at codilar dot com ¶

6 years ago

sodium_crypto_aead_chacha20poly1305_ietf_decrypt function mentions in its documentation that it'll always return a string. But when passed a malformed input as argument, it returns a boolean

＋add a note