(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
&$state
,$message
,$additional_data
= "",$tag
= SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE
Chiffre un morceau de données pour qu'il puisse être déchiffré dans une API de streaming.
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.
Renvoie le morceau de texte chiffré.