This playbook helps cloud, IAM, application, and security teams convert PQC readiness into a controlled migration program. It is intentionally vendor-neutral and focuses on cryptographic touchpoints that commonly appear in cloud and identity architectures.
Guiding principle: treat PQC migration as a crypto-agility and dependency-management program, not only as an algorithm replacement task.
Cloud and IAM cryptographic touchpoints
| Area | Examples to inventory |
|---|---|
| TLS/mTLS | Ingress, egress, service mesh, API gateways, load balancers, database connections, partner endpoints. |
| Federation | SAML signing/encryption certificates, OIDC/OAuth token signing algorithms, JWT key rotation, partner metadata. |
| Workload identity | Service accounts, managed identities, SPIFFE/SPIRE-style identities, machine certificates, short-lived credentials. |
| Remote access | VPN, SSH, privileged access gateways, bastion hosts, jump servers, break-glass paths. |
| Signing | Code signing, container signing, artifact signing, firmware signing, secure boot, release pipelines. |
| Key management | KMS, HSM, certificate authorities, secrets stores, trust stores, BYOK/HYOK processes, key rotation workflows. |
| Applications | Cryptographic libraries, protocol negotiation, hard-coded algorithms, SDK/client library behavior, dependency update paths. |
Phase-based migration playbook
| Phase | Activity | Detailed action | Output |
|---|---|---|---|
| 0. Mobilize | Define scope and governance | Confirm cloud, IAM, PKI, signing, service identity, API, network, and supplier scope. Assign an owner, RACI, and review cadence. | Approved scope, RACI, and timeline. |
| 1. Discover | Inventory crypto touchpoints | Collect certificates, TLS endpoints, federation metadata, token signing keys, workload identities, SSH keys, VPN profiles, code signing keys, KMS/HSM integrations, service mesh settings, and CI/CD dependencies. | Cloud/IAM crypto dependency map. |
| 2. Prioritize | Score risk and blockers | Score by quantum vulnerability, data shelf life, criticality, exposure, crypto agility, supplier support, and operational complexity. | Prioritized migration backlog. |
| 3. Design | Define target migration patterns | Use approved libraries, certificate lifecycle automation, policy-managed algorithms, protocol upgrades, hardware refresh, supplier upgrades, or compensating controls. Use PQC or hybrid-capable paths only where protocols and products support them. | Target-state architecture and standards. |
| 4. Pilot | Validate in non-production | Test representative TLS, mTLS, federation, signing, workload identity, API gateway, service mesh, and monitoring flows. Verify latency, certificate size, client compatibility, logs, and rollback. | Pilot report and go/no-go decision. |
| 5. Rollout | Execute phased deployment | Use canaries, maintenance windows, partner notifications, automated checks, and rollback triggers. Keep changes reversible until compatibility is proven. | Change records and deployment evidence. |
| 6. Operate | Make discovery continuous | Refresh crypto inventory using certificates, endpoints, code repositories, dependencies, SBOM/CBOM where available, CI/CD, and network telemetry. | Recurring inventory dashboard and exception review. |
Target design principles
- Use policy-managed cryptographic settings rather than hard-coded algorithms.
- Centralize certificate lifecycle management, renewal, revocation, ownership, and evidence.
- Abstract cryptographic libraries behind supported interfaces so future algorithm transitions are less disruptive.
- Validate PQC or hybrid-capable configurations only where protocol, product, client, and partner support is mature enough for the use case.
- Maintain backward-compatible rollout and rollback paths until telemetry confirms stable operation.
- Require supplier disclosures for cryptographic dependencies, update mechanisms, support windows, and PQC roadmaps.
Role map
| Role | Responsibilities |
|---|---|
| Security architecture | Policy, target-state design, risk scoring, exception review, and standards alignment. |
| IAM/PKI team | Certificate authority readiness, federation signing keys, trust stores, machine identities, key rotation, and relying-party testing. |
| Cloud/platform team | Endpoint discovery, service identity, service mesh/API gateway policies, KMS/HSM integration, telemetry, and deployment automation. |
| Application owners | Library dependency updates, protocol/client compatibility, business testing, and release planning. |
| Supplier/procurement team | Supplier roadmap requests, contract language, support windows, and product upgrade commitments. |
| Operations/SOC | Monitoring, alerting, incident response, rollback runbooks, and audit evidence. |
Acceptance criteria for a pilot
- Inventory fields are complete for pilot assets, including owner, algorithm, protocol, library, certificate location, supplier, and risk score.
- Test clients and relying parties represent real production diversity.
- Handshake, signing, token validation, certificate chain, latency, and logging behavior are measured.
- Rollback is tested and documented.
- Operational dashboards show the changed protocols, certificates, and error conditions.
- Exception decisions have owner, expiration date, and compensating controls.
Reference sources
This resource hub is an independent, vendor-neutral planning aid. It is not a NIST, CISA, or government publication and does not imply endorsement by any public agency.