Skip to content

docs(NGINXaaS): add post-quantum quick-start for AWS and GCP - #2303

Merged
JTorreG merged 9 commits into
nginx:mainfrom
defanator:abelov-NGINXAAS-2120-pqc
Sep 22, 2026
Merged

JTorreG merged 9 commits into
nginx:mainfrom
defanator:abelov-NGINXAAS-2120-pqc

Conversation

@defanator

Copy link
Copy Markdown
Member

Proposed changes

This PR adds quick-start section for configuring PQ-enabled deployments in NGINXaaS for AWS and NGINXaaS for Google Cloud, as well as addresses other references in related area (mostly around supported certificate/key formats).

Checklist

Before sharing this pull request, I completed the following checklist:

Footnotes

  1. Potentially sensitive information includes personally identify information (PII), authentication credentials, and live URLs. Refer to the style guide for guidance about placeholder content.

@defanator
defanator requested a review from a team as a code owner September 21, 2026 19:04
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Sep 21, 2026
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/google/quickstart/pqc.md Outdated
@promptless

promptless Bot commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

This pull request adds post-quantum cryptography quick-start guides for F5 NGINXaaS for AWS and F5 NGINXaaS for Google Cloud, adds a quickstart landing page for each, and updates the two SSL/TLS certificate overview pages to list ML-DSA and note ML-DSA key-format support.

Style findings (also left inline on each pqc.md page):

  • em-dash: Both pqc.md pages use em dashes in the intro paragraph, the TLS 1.3 prerequisite, and the "What's next" bullets. F5 technical content avoids em dashes, because they don't translate well for global audiences. Replace each with a period, comma, colon, or parentheses.
  • f5-product-names: On both pqc.md pages, the first mention in the body ("NGINXaaS for AWS" and "NGINXaaS for Google Cloud") should carry the "F5" prefix. Drop "F5" on later mentions.

Technical accuracy (I couldn't verify these against a product source, because no NGINXaaS source repository is tracked here; a subject matter expert should confirm each):

  1. Both overview pages list "ML-DSA (post-quantum KEX)". Elsewhere in this pull request, ML-KEM is the key exchange and ML-DSA is the certificate and signature algorithm, so "KEX" on ML-DSA looks inconsistent. Confirm the correct label.
  2. The pqc.md pages describe hybrid mode as combining "classical elliptic-curve key exchange (EC) with ML-KEM for data encryption". Confirm what ML-KEM does in this context (key establishment or data encryption).
  3. The pqc.md pages state that hybrid ML-KEM is active by default, that ML-KEM hybrid groups are in the default key exchange group list, and that clients negotiate X25519MLKEM768 automatically on TLS 1.3. Confirm these defaults for current NGINXaaS deployments.
  4. Confirm the ML-DSA key-format constraints stated on the overview and pqc.md pages: the Console accepts the seed-only format only, and Secrets Manager (AWS) and Secret Manager (Google Cloud) accept both seed-only and seed-priv.
  5. Confirm that $ssl_curve reports X25519MLKEM768 for hybrid connections and returns an empty value for TLS 1.2, as the "Track ML-KEM adoption" section states.

Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/google/quickstart/pqc.md Outdated
Comment thread content/nginxaas/google/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md
Comment thread content/nginxaas/google/quickstart/pqc.md Outdated

@amudukutore amudukutore left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Comment thread content/nginxaas/aws/deploy/ssl-tls-certificates/overview.md Outdated
Comment thread content/nginxaas/aws/deploy/ssl-tls-certificates/overview.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/aws/quickstart/pqc.md Outdated
Comment thread content/nginxaas/google/deploy/ssl-tls-certificates/overview.md Outdated
@JTorreG
JTorreG merged commit 8d4d426 into nginx:main Sep 22, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants