How sandbox-quantum/pqc-fido2-impl works
Based on our analysis of the file tree and README, this project is a specialized FIDO2 implementation that upgrades the existing protocol with post-quantum cryptographic algorithms. The project’s purpose is to demonstrate a full FIDO2 ecosystem—comprising an authenticator (hardware firmware and its companion software), a browser with integrated support, and a Java-based authentication server—enhanced with PQC capabilities (specifically, Dilithium3 and Kyber768).
Main Components
• Authenticator: This layer is twofold. It includes:
• The Rust-based implementation (found in the authenticator-rs directory) running on the device.
• The hardware firmware on Nitrokey 3 (contained within the nitrokey-3-firmware directory) and its related submodules (like trussed, fido-authenticator, ctap-types, usbd-ctaphid, and cosey).
• Browser: Illustrated as the Firefox browser, which has been modified (per the docs and instructions in docs/firefox.md) to work with the PQC authenticator.
• Server: Represented by the Java WebAuthn Server (in the java-webauthn-server directory), which makes use of additional dependencies (notably liboqs-java) for handling the post-quantum cryptography operations.
• Supporting Libraries & Tools: Include liboqs-java which acts as the Java wrapper for liboqs. This is built separately (as indicated in the README) and is critical to the cryptographic operations in the server.
• Hardware Link: Within the authenticator block, clearly illustrate the connection between the firmware (nitrokey-3-firmware) and its companion software layers (authenticator-rs and the supporting modules like trussed, cosey, etc.) that run on/with the Nitrokey 3 device.
Architectural Patterns and Design Principles
• Modular Architecture: Stress that each component (authenticator, browser, server) is developed and maintained as separate units. Emphasize the integration via well-defined protocols (WebAuthn, CTAP2).
• Extensibility: Note that the project forks several repositories, demonstrating a design that leverages modular, interchangeable components.