Cifra un mensaje utilizando un nonce y una clave secreta (sin autenticación)

# sodium_crypto_stream_xchacha20_xor_ic

(PHP 8 >= 8.2.0)

sodium_crypto_stream_xchacha20_xor_ic — Cifra un mensaje utilizando un nonce y una clave secreta (sin autenticación)

### Descripción

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

Esta función es similar a sodium_crypto_stream_xchacha20_xor() pero añade la posibilidad de establecer el valor inicial del contador de bloques a un valor distinto de cero. Esto permite acceder directamente a cualquier bloque sin tener que calcular los anteriores.

Precaución

Este cifrado no está autenticado y no previene los ataques de texto cifrado elegido. Asegúrese de combinar el texto cifrado con un código de autenticación de mensaje, por ejemplo, con la función sodium_crypto_aead_xchacha20poly1305_ietf_encrypt(), o sodium_crypto_auth().

### Parámetros

`message`
  El mensaje a cifrar.
`nonce`
  Un nonce de 24 bytes.
`counter`
  El valor inicial del contador de bloques.
`key`
  Clave, posiblemente generada por la función sodium_crypto_stream_xchacha20_keygen().

### Valores devueltos

El texto cifrado, o o `false` si ocurre un error.

### Ejemplos

Ejemplo #1 Ejemplo 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);

    // Todo en una vez:
    $stream7_unified = sodium_crypto_stream_xchacha20_xor($left . $right, $n2, $key);

    // Por partes, con un 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);
    ?>

Resultado del ejemplo anterior es similar a:

    int(128)
    bool(true)

### Ver también

- sodium_crypto_stream_xchacha20_xor() - Cifra un dato utilizando un nonce y una clave secreta (sin autenticación)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open