
Реализация постквантовой криптографической схемы (Hamming Quasi-Cyclic) с эталонной и оптимизированной версиями для безопасной инкапсуляции ключей.
HQC — это основанный на кодах механизм инкапсуляции ключа (KEM), выбранный NIST в рамках проекта NIST по стандартизации постквантовой криптографии. Этот репозиторий содержит реализацию, предоставленную командой HQC.
Проект организован в виде модульных компонентов, включая кроссплатформенный код, тесты, векторы известных ответов и инструменты упаковки.
Можно собрать любой вариант во внешнем каталоге и запустить полный набор тестов
одной командной строкой. Выберите архитектуру (HQC_ARCH), конкретный
SIMD-бэкенд, если применимо (HQC_X86_IMPL), и опциональный санитайзер времени выполнения
(HQC_SANITIZER).
# 1) Configure
cmake -S . -B build-<arch> \
-DCMAKE_BUILD_TYPE=Release \
-DHQC_ARCH=<arch> \
-DHQC_X86_IMPL=<impl> \
-DHQC_SANITIZER=<sanitizer>
# 2) Build
cmake --build build-<arch> -- -j$(nproc)
# 3) Test
ctest --test-dir build-<arch> --output-on-failure -j$(nproc)
Параметры конфигурации
<arch>: ref, x86_64<impl>: avx256<sanitizer>: NONE, ASAN, LSAN, MSAN, UBSANПример 1 (Портативная эталонная реализация)
rm -rf build-ref &&
cmake -S . -B build-ref \
-DCMAKE_BUILD_TYPE=Release \
-DHQC_ARCH=ref &&
cmake --build build-ref -j$(nproc) &&
ctest --test-dir build-ref -j$(nproc)
Пример 2 (оптимизированная реализация AVX2 (Haswell/AVX256))
rm -rf build-avx256 &&
cmake -S . -B build-avx256 \
-DCMAKE_BUILD_TYPE=Release \
-DHQC_ARCH=x86_64 \
-DHQC_X86_IMPL=avx256 &&
cmake --build build-avx256 -j$(nproc) &&
ctest --test-dir build-avx256 -j$(nproc)
Дополнительные инструменты разработчика находятся в каталоге tools/ и могут быть собраны с помощью -DHQC_BUILD_TOOLS=ON (команды и использование см. в tools/README.md).
Область применения. Этот проект нацелен только на устойчивость к атакам по времени; другие атаки по побочным каналам в настоящее время не рассматриваются.
Ожидается, что этот проект будет избегать зависящих от секретов потоков управления и доступа к секретным областям памяти, чтобы противостоять атакам по времени. Усиление защиты кода от атак по времени, вызванных компилятором, находится в процессе разработки, и будут рассматриваться только уязвимости, возникающие при компиляции в соответствии с нашими инструкциями по компиляции на целевых архитектурах (см. #11 и #12).
До появления стандарта FIPS 207 всем рекомендуется сообщать о проблемах здесь, открывая work item.
Запросы на слияние, решающие рабочие задачи, также приветствуются.
Все исходные файлы должны быть отформатированы с помощью clang-format перед каждым коммитом.
# Run from the build directory you already created
cmake --build build-<arch> --target clang-format # rewrites files in-place
cmake --build build-<arch> --target check-format # check format