Skip to content

SaaS & Custom Domains

How to design TLS for SaaS custom domains at scale

A customer hostname is not a marketing field. It is ownership, DNS, issuance, delivery and renewal.

sslcertificates.io Editorial · Published 2026-09-21 · Fact-checked 2026-09-21 · Topic window 2026-09-03

A SaaS custom domain is a lifecycle:

customer types hostname → you store a row → they prove ownership → you issue → you deliver the leaf to the listener that already has SNI for that tenant → you mark HTTPS ready → you renew without another marketing page.

sslcertificates.io custom hostnames: POST /api/v1/custom-hostnames returns ownership_token (own_…) and cname_target. Statuses are pending → certificate_pending → active. There is no public POST /custom-hostnames/{id}/validate. Do not invent it.

DNS drift is the hidden failure: the customer deletes the TXT or moves the CNAME after go-live. Renewal then fails. Webhook certificate.renewal_failed must update the tenant table, not only a Slack channel.

Provider neutrality matters only where it is true. We do not require a CDN cutover. We also do not claim Cloudflare SSL for SaaS as a live-verified platform product until a disposable account has completed E2E.

Sources

Related

Automate the lifecycle this article describes

Inventory, renewals and verified deployment are product surfaces — not adjectives.

Start free Read the Product hub