Воспроизводимая энтропия в тестах Go: как пакет testing/cryptotest фиксирует поток crypto/randЗаметка · дайджест за 17 ноября
Бумажный коллаж с математической упорядоченностью энтропии и фиксацией псевдослучайных потоков в Go.
Заметка2 раздела≈ 4 мин

Воспроизводимая энтропия в тестах Go: как пакет testing/cryptotest фиксирует поток crypto/rand

«Пакет cryptotest предоставляет детерминированный источник случайности для тестирования».

Этой строчкой авторы Go открывают документацию testing/cryptotest, появившегося в Go 1.27. Стоит коду обратиться к генератору crypto/rand, и каждый прогон тестов получает свежую системную энтропию: упавший в CI тест локально проходит чисто. Так как же отладить и воспроизвести такой сбой?

Почему тесты с crypto/rand не поддавались отладке

Простая мысль — подменить источник случайности своим io.Reader с заранее заданными байтами. Но в современных версиях crypto/rsa и crypto/ecdsa стандартная библиотека всё жёстче требует системной энтропии и попросту игнорирует пользовательские ридеры.

Даже с заглушкой внутри твоего кода криптоалгоритмы всё равно пойдут за случайностью к ОС. Редкий граничный сбой в генерации ключей или токенов превращается в призрак, который невозможно поймать повторным запуском.

Как SetGlobalRandom фиксирует и сбрасывает поток энтропии

В Go 1.27.3 эту проблему решает функция SetGlobalRandom из testing/cryptotest:

func SetGlobalRandom(t *testing.T, seed uint64)

Значение seed переводит глобальный источник энтропии процесса в детерминированный режим — это затрагивает и прямые вызовы crypto/rand.Read, и все скрытые источники в пакетах crypto/.... Аргумент t *testing.T ограничивает подмену временем жизни теста: после завершения рантайм сам вернёт системный генератор.

Логичный вопрос: а что если внутри одного теста нужно прогнать генерацию дважды и сверить результаты? Повторный вызов SetGlobalRandom с тем же сидом сбрасывает поток в исходное состояние.

Я обратил внимание на рабочий пример random_test.go из канала Библиотека Go-разработчика, проверенный на Go 1.27.3. Тест фиксирует сид 42, читает 16 байт — типичный размер для токена сброса пароля или проверки JWT — затем сбрасывает поток и снова читает 16 байт:

package mycrypto_test

import (
    "bytes"
    "crypto/rand"
    "testing"
    "testing/cryptotest"
)

func TestDeterministicEntropyStream(t *testing.T) {
    cryptotest.SetGlobalRandom(t, 42)

    firstChunk := make([]byte, 16)
    if _, err := rand.Read(firstChunk); err != nil {
        t.Fatalf("first rand.Read failed: %v", err)
    }

    cryptotest.SetGlobalRandom(t, 42)

    secondChunk := make([]byte, 16)
    if _, err := rand.Read(secondChunk); err != nil {
        t.Fatalf("second rand.Read failed: %v", err)
    }

    if !bytes.Equal(firstChunk, secondChunk) {
        t.Fatal("entropy stream did not reset deterministically")
    }
    t.Logf("deterministic_entropy_verified: len=%d bytes_match=%v", len(firstChunk), bytes.Equal(firstChunk, secondChunk))
}

Заметь: в коде нет заранее захардкоженного массива байтов. Первый вызов SetGlobalRandom(t, 42) задаёт точку отсчёта для firstChunk, второй обнуляет поток перед заполнением secondChunk, а bytes.Equal проверяет их побайтовое совпадение.

Чтобы отключить кэш тестов Go и честно прогнать сценарий заново, используют команду:

go test -v -count=1 ./...

Флаг -count=1 сбрасывает кэш, а лог теста подтверждает, что оба 16-байтовых чтения совпали бит в бит. Пойманного сида теперь хватает, чтобы локально воспроизвести сбой генерации ключей или токенов без переписывания кода под моки.

Но за глобальную подмену приходится платить двумя жёсткими ограничениями:

  • Никакого t.Parallel(): SetGlobalRandom меняет генератор на весь процесс ОС, поэтому ни сам тест, ни его предки не должны быть параллельными — иначе тест упадёт с паникой.
  • Режим FIPS-140: при сборке с Go Cryptographic Module v1.0.0 (когда crypto/fips140.Version возвращает "v1.0.0") функция не поддерживается.

Детерминизм в crypto/rand работает ровно до границы параллелизма и сертифицированного криптомодуля.

Если хочешь шире посмотреть на инструменты надёжности в языке, загляни в наш обзор релиза Go 1.27 и разбор фаззинг-тестирования в Go.

И главное предостережение лучше всего оставить за самой документацией testing/cryptotest: способ расходования случайности криптоалгоритмами в стандарте не зафиксирован и может меняться со временем — поэтому тест, ожидающий конкретного вывода криптофункции, может сломаться в будущей версии Go даже с SetGlobalRandom.

Хочу подробный разборГолоса помогают выбрать, что разобрать подробно. За этот материал 0 голосов.
Источники · 2