sodium_crypto_secretstream_xchacha20poly1305_pull

(PHP 7 >= 7.2.0, PHP 8)

sodium_crypto_secretstream_xchacha20poly1305_pull — 암호화된 스트림에서 데이터 청크 해독


설명

sodium_crypto_secretstream_xchacha20poly1305_pull(string &$state, string $ciphertext, string $additional_data = ""): array|false

암호화된 스트림에서 데이터 청크를 해독합니다.


매개변수

state
sodium_crypto_secretstream_xchacha20poly1305_init_pull()sodium_crypto_secretstream_xchacha20poly1305_init_push() 참조
ciphertext
해독할 암호문 청크입니다.
additional_data
인증 태그에 포함할 선택적 추가 데이터입니다.

반환 값

두 개의 값이 있는 배열:

  • string; 해독된 청크
  • int; 선택적 태그(푸시 중에 제공된 경우). 가능한 값:
    • 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: 이 메시지와 이전 메시지를 암호화하는 데 사용된 키를 "잊고" 새 비밀 키를 파생합니다.