Skip to content

[SSL] Correct Pages custom domain TLS and cipher suite guidance - #34873

Open
dknecht wants to merge 1 commit into
productionfrom
dane/pages-custom-domain-tls
Open

dknecht wants to merge 1 commit into
productionfrom
dane/pages-custom-domain-tls

Conversation

@dknecht

@dknecht dknecht commented Nov 3, 2026

Copy link
Copy Markdown
Member

Summary

The Cloudflare Pages section of Compliance and vulnerabilities says zone-level TLS and cipher suite settings apply to a Pages custom domain. They do not. A Pages custom domain is a custom hostname on the project's <project>.pages.dev zone, and its certificate and TLS settings are set by Pages when the hostname is created. The Minimum TLS Version and cipher suites of the zone that contains the custom domain are not inherited.

This also makes the page contradict four other SSL pages, which already say these settings cannot be configured for Pages hostnames:

  • ssl/edge-certificates/additional-options/minimum-tls.mdx
  • ssl/edge-certificates/additional-options/cipher-suites/troubleshooting.mdx
  • ssl/edge-certificates/additional-options/cipher-suites/customize-cipher-suites/api.mdx
  • ssl/edge-certificates/additional-options/cipher-suites/customize-cipher-suites/dashboard.mdx

The change:

  • States that the limitation covers Pages custom domains as well as *.pages.dev.
  • Replaces the incorrect payment-page advice with Workers Custom Domains. Their certificate is on the customer's zone, so zone TLS settings apply. It links the Pages-to-Workers migration guide.

Internal evidence: CUSTESC-14456 (Pages engineering confirmed that hostname TLS settings are set by the Pages API and not inherited from the zone), BANDA-1543, CUSTESC-57881, and CUSTESC-61879 (customers whose zone cipher settings did not apply to their Pages custom domains). Follow-up from DEE-3981.

Documentation checklist

@dknecht
dknecht requested review from a team, baubuchon-cf and lgarofalo as code owners November 3, 2026 02:49
@github-actions github-actions Bot added the product:ssl Related to SSL label Nov 3, 2026
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed 904e911 · 0 findings · incremental

Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@cloudflare-docs-bot

Copy link
Copy Markdown
Contributor

Review coverage

🟡 1 ownership area needs approval.

Suggested reviewers: @baubuchon-cf @lgarofalo

Needs approval Eligible approvers Suggested
ssl @baubuchon-cf, @lgarofalo, @cloudflare/appsec-reviewers, @cloudflare/product-owners baubuchon-cf, lgarofalo
CODEOWNERS mappings for displayed areas (1)
Pattern Owners
/src/content/docs/ssl/ @baubuchon-cf, @lgarofalo, @cloudflare/appsec-reviewers, @cloudflare/product-owners

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://dane-pages-custom-domain-tls.previews.developers.cloudflare.com (commit 904e911)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://281c76fa.previews.developers.cloudflare.com 904e911 2026-11-03T02:57:51.887Z Visit the dashboard ↗

@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant