Skip to content

[Cloudflare for SaaS, SSL] Clarify hostname readiness#30557

Open
irvinebroque wants to merge 2 commits intoproductionfrom
improve-ssl-for-saas-docs
Open

[Cloudflare for SaaS, SSL] Clarify hostname readiness#30557
irvinebroque wants to merge 2 commits intoproductionfrom
improve-ssl-for-saas-docs

Conversation

@irvinebroque
Copy link
Copy Markdown
Contributor

Summary

Updates the Cloudflare for SaaS API docs and SSL certificate status reference to clarify how to interpret the Custom Hostname Details response. The PR explains that the top-level status tracks hostname activation, nested ssl.status tracks certificate issuance and deployment, and production HTTPS readiness requires both values to be active with customer DNS pointed to the SaaS target.

Also notes that a successful TLS handshake alone is not the readiness source of truth because Cloudflare may present another matching certificate, and that non-wildcard custom hostnames can complete automatic HTTP certificate validation even when TXT validation was selected.

Documentation checklist

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-for-platforms/ @irvinebroque, @dinasaur404, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
/src/content/docs/ssl/ @RebeccaTamachiro, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
* @cloudflare/pcx-technical-writing, @cloudflare/product-owners

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

Preview URL: https://1780bbad.preview.developers.cloudflare.com
Preview Branch URL: https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/common-api-calls/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/common-api-calls/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/http/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/http/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/txt/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/txt/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/validation-status/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/hostname-validation/validation-status/
https://developers.cloudflare.com/ssl/reference/certificate-statuses/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/ssl/reference/certificate-statuses/
https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/ https://improve-ssl-for-saas-docs.preview.developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/

@irvinebroque irvinebroque marked this pull request as ready for review May 4, 2026 16:56
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 4, 2026

This PR requires additional review attention because it affects the following areas:

Partials

This PR updates partial files, which are pieces of content used across multiple files in our Render component.

@irvinebroque irvinebroque enabled auto-merge (squash) May 4, 2026 19:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants