Skip to Content
TestingCustom App Domains

Custom App Domains

Verfügbarkeit

Custom-domain ownership verification ist implementiert, custom-domain traffic und certificate serving aber nicht. Current service kann domain request store, DNS instructions return, public DNS query und nur verified names through planned Caddy tls-ask gate allow.

Adds verified hostname noch nicht to gateway, obtains certificate nicht, routes requests für hostname nicht. Move production traffic to this feature noch nicht. verified status proves only configured DNS ownership check.

Verification workflow

  1. Hostname an app slug attach.
  2. Returned DNS records publish.
  3. Service ask to verify against public resolvers.
  4. Returned status und any check error inspizieren.
  5. Keep using platform preview URL; verification activates custom hostname nicht.

Subdomains use CNAME check against <slug>.apps.openfactory.tech. Apex names use generated TXT challenge plus presence of A record. Apex A record not checked against particular ingress address, also keine route validation.

REST surface

MethodPathCurrent result
POST/api/app-gateway/domainsStores pending domain und returns DNS instructions.
GET/api/app-gateway/domains?app_slug={slug}Lists domain records.
GET/api/app-gateway/domains/{domain}Gets one record.
POST/api/app-gateway/domains/{domain}/verifyPerforms immediate public-DNS check.
DELETE/api/app-gateway/domains/{domain}Removes stored record.
GET/api/app-gateway/tls-ask?domain={domain}Returns allow or deny for verified record; intended for future Caddy integration.

Example attach request:

POST /api/app-gateway/domains Content-Type: application/json { "app_slug": "my-app", "domain": "app.example.com" }

Service rejects platform-owned zones, duplicate ownership, invalid hostnames und more than five domains per app.

What remains before activation

Production use requires all completed und tested:

  • gateway configuration for each verified hostname;
  • decided public-ingress path terminating customer certificate;
  • certificate issuance, renewal, expiry inventory und alerting;
  • immediate und periodic reconciliation after DNS changes;
  • owner authorization on every list, read, verify und delete path; und
  • real-domain test covering DNS, TLS, routing, renewal, removal und rollback.

Until evidence exists, treat domain API as DNS-verification preview only.