Back to blog

Post-Quantum Cryptography Architecture: How to Diagram a Crypto-Agile Migration (2026)

How to diagram post-quantum cryptography (PQC) architecture. Covers ML-KEM, ML-DSA, hybrid classical/PQC handshakes, crypto-agility, and migration sequencing for systems moving off RSA and ECC — with prompt templates.

R
Ryan·Senior AI Engineer
·

Post-quantum cryptography (PQC) architecture is the set of design patterns for replacing RSA and elliptic-curve cryptography with algorithms resistant to attack by a cryptographically relevant quantum computer. 2026 is the year this moved from "research roadmap slide" to an active migration item on security architecture reviews: NIST's ML-KEM and ML-DSA standards are finalized, major browsers and TLS libraries ship hybrid support by default, and "harvest now, decrypt later" — attackers recording encrypted traffic today to decrypt once a quantum computer exists — makes long-lived sensitive data a present-day risk, not a future one.

A post-quantum cryptography architecture diagram needs to show two things clearly: where classical algorithms are still in use today, and how the system reaches crypto-agility — the ability to swap the underlying algorithm without re-architecting the whole stack. This guide covers the hybrid migration pattern, the key algorithms, and prompt templates for generating PQC architecture diagrams.

Why hybrid, not a hard cutover

No serious PQC migration in 2026 replaces classical algorithms outright. Instead, systems run a hybrid handshake that combines a classical algorithm (ECDH on curve X25519, for example) with a post-quantum algorithm (ML-KEM) and derives the session key from both. If the post-quantum algorithm turns out to have an undiscovered weakness, the classical algorithm still provides the security guarantee it always did; if a quantum computer breaks the classical algorithm, the post-quantum component holds. Your diagram should show this as two parallel key-exchange paths feeding a single key-derivation function, not a single swapped-out algorithm box.

The core NIST-standardized algorithms

AlgorithmPurposeReplaces
ML-KEM (FIPS 203)Key encapsulation for establishing a shared secretRSA / ECDH key exchange in TLS handshakes
ML-DSA (FIPS 204)Digital signatures for authentication and integrityRSA / ECDSA signatures on certs, code signing, tokens
SLH-DSA (FIPS 205)Stateless hash-based signatures (conservative fallback)High-assurance signing where algorithm diversity matters most
AES-256, SHA-384/512Symmetric encryption and hashingNo change required — already quantum-resistant at current key sizes

It's worth stating explicitly in your diagram's notes: symmetric primitives like AES-256 and SHA-384 are not part of the migration. Grover's algorithm only halves their effective security margin, which existing key sizes already absorb. The migration is specifically about asymmetric key exchange and signatures, where Shor's algorithm is a complete break.

Crypto-agility: the real architectural goal

The specific algorithms matter less than whether your system can change algorithms without a multi-year rewrite. A crypto-agile architecture isolates every cryptographic operation behind an abstraction layer — diagram this as a "crypto provider" component that TLS termination, token signing, and data-at-rest encryption all call into, rather than each service linking directly against a specific algorithm implementation. When ML-KEM parameters change or a new standard is finalized, you update the provider configuration, not every service that does cryptography.

Where to prioritize migration first

  1. Long-lived sensitive data in transit: Anything encrypted today that must stay confidential for 10+ years — health records, government data, trade secrets — is exposed to harvest-now-decrypt-later attacks and should move to hybrid TLS first.
  2. Certificate authorities and code signing: Root and intermediate CA keys have long validity periods and cascading trust — migrating the signature algorithm here has the widest blast radius and the longest lead time, so it should start early even though the rollout is slow.
  3. External-facing TLS endpoints: Public APIs and websites are the easiest to move to hybrid key exchange since major browsers and clients already negotiate it automatically when the server offers it.
  4. Internal service-to-service auth last: Short-lived internal tokens and mTLS between services you fully control carry the lowest harvest-now risk and can migrate on a normal infrastructure upgrade cycle.

Prompt templates for post-quantum architecture diagrams

Hybrid TLS migration for a public API gateway

"Post-quantum cryptography architecture for a public-facing API gateway migrating to hybrid TLS. Client connects over TLS 1.3 with a hybrid key exchange group: X25519 (classical ECDH) combined with ML-KEM-768 (post-quantum KEM); both key exchange results are fed into a combined KDF that derives the session key, so the session is secure if either algorithm holds. Server certificate uses a traditional ECDSA signature today, with a parallel ML-DSA-65 certificate chain served to clients that advertise PQC signature support, negotiated via certificate_authorities extension. All cryptographic operations route through an internal crypto-provider abstraction (a Rust library wrapping liboqs) rather than being called directly by service code, so the KEM and signature algorithm can be upgraded via config change. Symmetric encryption for the session remains AES-256-GCM (already quantum-resistant, unchanged). A crypto-inventory service scans all internal certs and TLS configs weekly, flagging any endpoint still on pure classical key exchange for the migration backlog."

Long-term data-at-rest protection for healthcare records

"Post-quantum architecture for encrypting healthcare records that must remain confidential for 25+ years. Data encryption keys (DEKs) use AES-256-GCM for the bulk data (no PQC change needed). Key-encrypting keys (KEKs) that wrap the DEKs are protected via a hybrid envelope: an RSA-4096 KEK (legacy, kept for backward compatibility during transition) and a parallel ML-KEM-1024 KEK, with both required to unwrap a DEK — a harvest-now attacker who eventually breaks RSA via a quantum computer still cannot decrypt without also breaking ML-KEM. KEKs are managed by an HSM-backed key management service that supports both algorithm families. Digital signatures on record integrity checksums use SLH-DSA (hash-based, most conservative security assumption) given the multi-decade retention requirement. A key-rotation scheduler re-wraps all DEKs under new KEKs annually, decoupling the cryptographic migration timeline from the data retention timeline."

Frequently asked questions about post-quantum cryptography architecture

Do I need to migrate to post-quantum cryptography now?

It depends on how long your data needs to stay confidential. If your system encrypts data today that must remain secret for 10+ years, you are exposed to harvest-now-decrypt-later attacks and should prioritize hybrid TLS and long-term key protection now. If your data is short-lived and the value decays within a year or two, the urgency is lower — though certificate authorities and infrastructure vendors are moving to hybrid defaults regardless, so most systems will get baseline protection automatically over the next migration cycle.

Does AES-256 need to be replaced for post-quantum security?

No. Symmetric algorithms like AES-256 and hash functions like SHA-384/512 are not broken by known quantum algorithms — Grover's algorithm only reduces their effective security margin by half, which current key sizes already account for. Post-quantum migration is specifically about asymmetric cryptography (key exchange and digital signatures), where Shor's algorithm represents a complete break of RSA and elliptic-curve schemes.

What does "crypto-agility" mean in an architecture diagram?

Crypto-agility means your architecture isolates every cryptographic algorithm behind an abstraction layer, so the algorithm can be swapped via configuration rather than a code rewrite across every service. In a diagram, this shows up as a single "crypto provider" or "key management service" component that all TLS termination, signing, and encryption operations route through, instead of each service directly calling a specific cryptographic library implementation.

Related guides: Zero trust architecture diagrams, authentication architecture diagrams, threat modeling diagrams, and SOC 2 architecture diagrams.

Ready to try it yourself?

Start Creating - Free