PHP Conference Nagoya 2025

sodium_crypto_aead_chacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_chacha20poly1305_ietf_decryptVé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.

add a note

User Contributed Notes 1 note

up
0
joy at codilar dot com
5 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
To Top