sodium_crypto_stream_xchacha20_xor_ic

(PHP 8 >= 8.2.0)

sodium_crypto_stream_xchacha20_xor_ic — Criptografa uma mensagem usando um nonce e uma chave secreta (sem autenticação)

Descrição

sodium_crypto_stream_xchacha20_xor_ic(
    #[\SensitiveParameter] string $message,
    string $nonce,
    int $counter,
    #[\SensitiveParameter] string $key
): string

A função é semelhante a sodium_crypto_stream_xchacha20_xor() mas adiciona a capacidade de definir o valor inicial do contador de blocos como um valor diferente de zero. Isso permite acesso direto a qualquer bloco sem precisar calcular os anteriores.

Cuidado

Esta criptografia não é autenticada e não impede ataques de texto cifrado escolhido. Certifique-se de combinar o texto cifrado com um Código de Autenticação de Mensagem, por exemplo, com a função sodium_crypto_aead_xchacha20poly1305_ietf_encrypt(), ou sodium_crypto_auth().

Parâmetros

message: A mensagem a criptografar.
nonce: Nonce de 24 bytes.
counter: O valor inicial do contador de blocos.
key: Chave, possivelmente gerada por sodium_crypto_stream_xchacha20_keygen().

Valor Retornado

Mensagem criptografada, ou false em caso de falha.

Exemplos

Exemplo #1 Exemplo de sodium_crypto_stream_xchacha20_xor_ic()

<?php
$n2 = random_bytes(SODIUM_CRYPTO_STREAM_XCHACHA20_NONCEBYTES);
$left  = str_repeat("\x01", 64);
$right = str_repeat("\xfe", 64);

// Tudo de uma vez só:
$stream7_unified = sodium_crypto_stream_xchacha20_xor($left . $right, $n2, $key);

// Parte por parte, com contador inicial:
$stream7_left  = sodium_crypto_stream_xchacha20_xor_ic($left, $n2, 0, $key);
$stream7_right = sodium_crypto_stream_xchacha20_xor_ic($right, $n2, 1, $key);
$stream7_concat = $stream7_left . $stream7_right;

var_dump(strlen($stream7_concat));
var_dump($stream7_unified === $stream7_concat);
?>

O exemplo acima produzirá algo semelhante a:

int(128)
bool(true)

Veja Também

sodium_crypto_stream_xchacha20_xor() - Criptografa uma mensagem usando um nonce e uma chave secreta (sem autenticação)