sodium_crypto_aead_xchacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt — (Preferido) Verifica e descriptografa com XChaCha20-Poly1305

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

Verifica e descriptografa com ChaCha20-Poly1305 (variante eXtended-nonce).

Geralmente, o XChaCha20-Poly1305 é o melhor dos modos AEAD fornecidos para uso.

ciphertext: Precisa estar no formato fornecido por sodium_crypto_aead_xchacha20poly1305_ietf_encrypt() (texto cifrado e tag, concatenados).
additional_data: Dados adicionais e autenticados. São usados na verificação da tag de autenticação anexada ao texto cifrado, mas não são criptografados nem armazenados no texto cifrado.
nonce: Um número que deve ser usado apenas uma vez por mensagem. 24 bytes de comprimento. Este é um limite grande o suficiente para ser gerado aleatoriamente (por exemplo, random_bytes()).
key: Chave de criptografia (256-bit).

Retorna o texto simples em caso de sucesso, ou false em caso de falha.