sodium_crypto_secretstream_xchacha20poly1305_push

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretstream_xchacha20poly1305_push — Chiffre un morceau de données pour qu'il puisse être déchiffré dans une API de streaming

Description

sodium_crypto_secretstream_xchacha20poly1305_push(
    string &$state,
    #[\SensitiveParameter] string $message,
    string $additional_data = "",
    int $tag = SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE
): string

Chiffre un morceau de données pour qu'il puisse être déchiffré dans une API de streaming.

Liste de paramètres

state

Voir sodium_crypto_secretstream_xchacha20poly1305_init_pull() et sodium_crypto_secretstream_xchacha20poly1305_init_push()

message

additional_data

tag

Optionnel. Peut être utilisé pour affirmer le comportement de déchiffrement (c'est-à-dire le ré-arrangement ou l'indication du dernier morceau dans un flux).

SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE: l'étiquette la plus courante, qui n'ajoute aucune information sur la nature du message.
SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_FINAL: indique que le message marque la fin du flux, et efface la clé secrète utilisée pour chiffrer la séquence précédente.
SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_PUSH: indique que le message marque la fin d'un ensemble de messages, mais pas la fin du flux. Par exemple, une énorme chaîne JSON envoyée en plusieurs morceaux peut utiliser cette étiquette pour indiquer à l'application que la chaîne est complète et qu'elle peut être décodée. Mais le flux lui-même n'est pas fermé, et d'autres données peuvent suivre.
SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_REKEY: "forget" la clé utilisée pour chiffrer ce message et les précédents, et dériver une nouvelle clé secrète.

Valeurs de retour

Renvoie le morceau de texte chiffré.