Шифрует сообщение неясным кодом и секретным ключом (без аутентификации)

# sodium_crypto_stream_xchacha20_xor_ic

(PHP 8 >= 8.2.0)

sodium_crypto_stream_xchacha20_xor_ic — Шифрует сообщение неясным кодом и секретным ключом (без аутентификации)

### Описание

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

Функция работает аналогично функции sodium_crypto_stream_xchacha20_xor(), но добавляет возможность установить начальное значение счётчика блоков в ненулевое значение. Это помогает получить прямой доступ к любому блоку без необходимости вычисления предыдущих.

Предостережение

Это шифрование неаутентифицировано и не предотвращает атаки с подобранным шифротекста. Обязательно объедините шифротекст с кодом аутентификации сообщения, например, с функциями sodium_crypto_aead_xchacha20poly1305_ietf_encrypt() или sodium_crypto_auth().

### Список параметров

`message`
  Сообщение для шифрования.
`nonce`
  24-байтовый одноразовый номер.
`counter`
  Начальное значение счётчика блоков.
`key`
  Ключ, который, возможно, сгенерировала функция sodium_crypto_stream_xchacha20_keygen().

### Возвращаемые значения

Функция возвращает зашифрованное сообщение или `false`, если возникла ошибка.

### Примеры

Пример #1 Пример использования функции 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);

    // Всё сразу:
    $stream7_unified = sodium_crypto_stream_xchacha20_xor($left . $right, $n2, $key);

    // По частям, с начальным счётчиком:
    $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);

    ?>

Вывод приведённого примера будет похож на:

    int(128)
    bool(true)

### Смотрите также

- sodium_crypto_stream_xchacha20_xor() - Шифрует сообщение одноразовым номером и секретным ключом (без аутентификации)

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