sodium_crypto_secretstream_xchacha20poly1305_push

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretstream_xchacha20poly1305_push — 스트리밍 API에서 안전하게 복호화할 수 있도록 데이터 청크를 암호화합니다.


설명

sodium_crypto_secretstream_xchacha20poly1305_push(
    string &$state,
    string $message,
    string $additional_data = "",
    int $tag = SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE
): string
                

스트리밍 API에서 안전하게 복호화할 수 있도록 데이터 청크를 암호화합니다.


매개변수

state
sodium_crypto_secretstream_xchacha20poly1305_init_pull()sodium_crypto_secretstream_xchacha20poly1305_init_push() 참조
message
additional_data
tag
선택 과목. 암호 해독 동작을 주장하는 데 사용할 수 있습니다(즉, 스트림의 최종 청크를 다시 지정하거나 표시).
  • SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_MESSAGE: 메시지의 특성에 대한 정보를 추가하지 않는 가장 일반적인 태그입니다.
  • SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_FINAL: 메시지가 스트림의 끝을 표시하고 이전 시퀀스를 암호화하는 데 사용된 비밀 키를 지움을 나타냅니다.
  • SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_PUSH: 메시지가 메시지 집합의 끝을 표시하지만 스트림의 끝은 표시하지 않음을 나타냅니다. 예를 들어, 여러 청크로 전송된 거대한 JSON 문자열은 이 태그를 사용하여 문자열이 완전하고 디코딩될 수 있음을 애플리케이션에 나타낼 수 있습니다. 그러나 스트림 자체는 닫히지 않고 더 많은 데이터가 따를 수 있습니다.
  • SODIUM_CRYPTO_SECRETSTREAM_XCHACHA20POLY1305_TAG_REKEY: 이 메시지와 이전 메시지를 암호화하는 데 사용된 키를 "잊고" 새 비밀 키를 파생합니다.

반환 값

암호화된 암호문을 반환합니다.