PHPCon Poland 2024

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_aead_xchacha20poly1305_ietf_decrypt(Empfohlen) Überprüft und entschlüsselt eine Nachricht mit XChaCha20-Poly1305

Beschreibung

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

Überprüft und entschlüsselt eine Nachricht mit ChaCha20-Poly1305 (Erweiterte-Nonce-Variante).

Im Allgemeinen ist XChaCha20-Poly1305 der beste der angebotenen AEAD-Modi.

Parameter-Liste

ciphertext

Muss das von der Funktion sodium_crypto_aead_chacha20poly1305_ietf_encrypt() bereitgestellte Format haben (Chiffretext und Tag, verknüpft).

additional_data

Zusätzliche, zu authentifizierende Daten. Diese Daten werden weder verschlüsselt, noch an den Chiffriertext angehängt.

nonce

Eine Nummer, die nur einmal pro Nachricht verwendet werden darf; 24 Bytes lang. Diese Größe ist groß genug, um sie zufällig zu erzeugen (z. B. mit random_bytes()).

key

Schlüssel für die Entschlüsselung (256-bit).

Rückgabewerte

Gibt im Erfolgsfall den Klartext zurück. Bei einem Fehler wird false zurückgegeben.

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top