Passer au contenu principal
POST
/
custom-domains
/
{id}
/
verify
TypeScript
import { ManagementClient } from "auth0";

async function main() {
    const client = new ManagementClient({
        token: "<token>",
    });
    await client.customDomains.verify("id");
}
main();
{
  "custom_domain_id": "cd_0000000000000001",
  "domain": "login.mycompany.com",
  "primary": false,
  "status": "ready",
  "type": "self_managed_certs",
  "cname_api_key": "d4feca...",
  "origin_domain_name": "mycompany_cd_0000000000000001.edge.tenants.auth0.com",
  "verification": {
    "methods": [
      {
        "name": "txt",
        "record": "auth0-domain-verification=...",
        "domain": "_cf-custom-hostname.login.mycompany.com"
      }
    ],
    "status": "verified",
    "error_msg": "<string>",
    "last_verified_at": "<string>"
  },
  "custom_client_ip_header": "<string>",
  "tls_policy": "recommended",
  "domain_metadata": {},
  "certificate": {
    "status": "provisioning",
    "error_msg": "<string>",
    "certificate_authority": "letsencrypt",
    "renews_before": "<string>"
  }
}

Autorisations

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

id
string
requis

ID of the custom domain to verify.

Réponse

Custom domain successfully verified.

custom_domain_id
string
défaut:cd_0000000000000001
requis

ID of the custom domain.

domain
string
défaut:login.mycompany.com
requis

Domain name.

primary
boolean
défaut:false
requis

Whether this is a primary domain (true) or not (false).

status
enum<string>
défaut:ready
requis

Custom domain configuration status. Can be failed, pending_verification, or ready.

Options disponibles:
pending_verification,
ready,
failed
type
enum<string>
défaut:self_managed_certs
requis

Custom domain provisioning type. Can be auth0_managed_certs or self_managed_certs.

Options disponibles:
auth0_managed_certs,
self_managed_certs
cname_api_key
string
défaut:d4feca...

CNAME API key header.

origin_domain_name
string
défaut:mycompany_cd_0000000000000001.edge.tenants.auth0.com

Intermediate address.

verification
object

Domain verification settings.

custom_client_ip_header
string | null

The HTTP header to fetch the client's IP address

tls_policy
string
défaut:recommended

The TLS version policy

domain_metadata
object

Domain metadata associated with the custom domain, in the form of an object with string values (max 255 chars). Maximum of 10 domain metadata properties allowed.

certificate
object

Certificate information. This object is relevant only for Custom Domains with Auth0-Managed Certificates.