
Implementierung eines Post-Quanten-Kryptoschemas (Hamming Quasi-Cyclic) mit Referenz- und optimierten Versionen für sichere Schlüsselkapselung.
HQC ist ein codebasiertes Key Encapsulation Mechanism (KEM), das von NIST im Rahmen des NIST's Post-Quantum Cryptography Standardization Project ausgewählt wurde. Dieses Repository enthält die vom HQC-Team bereitgestellte Implementierung.
Das Projekt ist in modulare Komponenten gegliedert, darunter plattformübergreifender Code, Tests, Known-Answer-Vektoren und Packaging-Tools.
Man kann jede Variante in einem Out-of-Tree-Verzeichnis bauen und die vollständige Testsuite
mit einer einzigen Befehlszeile ausführen. Wählen Sie die Architektur (HQC_ARCH), das genaue
SIMD-Backend, falls zutreffend (HQC_X86_IMPL), und einen optionalen Laufzeit-Sanitizer
(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)
Konfigurationsoptionen
<arch>: ref, x86_64<impl>: avx256<sanitizer>: NONE, ASAN, LSAN, MSAN, UBSANBeispiel 1 (Portable Referenzimplementierung)
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)
Beispiel 2 (Optimierte AVX2-Implementierung (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)
Optionale Entwicklerwerkzeuge befinden sich unter tools/ und können mit -DHQC_BUILD_TOOLS=ON gebaut werden (siehe tools/README.md für Befehle und Verwendung).
Geltungsbereich. Dieses Projekt zielt ausschließlich auf Widerstandsfähigkeit gegen Timing-Angriffe ab; andere Seitenkanalangriffe werden derzeit nicht berücksichtigt.
Von diesem Projekt wird erwartet, dass es geheimnisabhängige Kontrollflüsse und Zugriffe auf geheime Speicherbereiche vermeidet, um Timing-Angriffe zu vereiteln. Die Härtung des Codes gegen compilerinduzierte Timing-Angriffe ist in Arbeit, und es werden nur Schwachstellen berücksichtigt, die bei der Kompilierung gemäß unseren Kompilierungsanweisungen auf den Zielarchitekturen entstehen (siehe #11 und #12).
Bis der FIPS 207-Standard verfügbar ist, werden Interessierte ermutigt, Probleme hier durch das Öffnen eines work item zu melden.
Merge Requests, die Work Items adressieren, sind ebenfalls willkommen.
Alle Quellen müssen vor jedem Commit mit clang-format formatiert werden.
# 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