用途:围绕 Auth0 自定义域名提供端到端支持,串联 Auth0 Management API、DNS 服务商、验证轮询与相关配置,适用于首次搭建、验证排障、已有域名管理、删除和健康检查。
主要能力:分为五类能力——搭建自定义域名(在 Auth0 创建、检测 DNS 服务商、写入 CNAME、验证所有权并报告应用需更新项);排查验证(针对 pending_verification 或验证失败,按诊断阶梯检查 DNS、代理、CNAME 扁平化、冲突记录、传播与私有区域问题);管理已有域名(设置默认域名、更新 TLS 策略、配置自定义客户端 IP 头、设置 passkey 的 relying party identifier、管理每域名元数据、列出域名与状态);删除域名(默认域名告警、列出依赖应用、删除并清理 CNAME);健康检查(只读列出域名、比对 DNS、呈现默认配置并标记问题)。错误码优先排查:Free 套餐 POST 返回 403 通常是缺少信用卡(在 Dashboard → Tenant Settings → Billing 添加,不会扣款),不是套餐问题;type 为 self_managed_certs 的 403 才是 Enterprise 限制;409 表示域名已存在,可用 auth0 domains list 检查;PATCH 中带 type 返回 400,因证书类型创建后固定,需删除重建;operation_not_supported 为租户功能开关未开;404 多为 ID 或租户错误;429 需退避,验证轮询采用 5s、10s、20s、30s、60s 退避。
使用方式:以会话式提问选择能力,输入逐条询问;破坏性操作前仅做一次是否确认。使用 Auth0 CLI 时需在首个命令前运行 auth0 tenants list 确认活跃租户,必要时 auth0 tenants use <tenant-name>。DNS 自动化分层:Cloudflare 通过 MCP(claude mcp add --transport http cloudflare https://mcp.cloudflare.com/mcp)、Route 53 用 AWS 凭证(aws sts get-caller-identity 验证)、Azure DNS 用 Azure CLI(az account show 验证);其他服务商为手动添加。
适用场景与限制:适用于 Auth0 自定义域名全生命周期运维与自动化集成。自定义域名所有套餐可用,但 Free 租户需绑定信用卡用于身份验证;自管理证书仅 Enterprise;多自定义域名(MCD)为 Enterprise,每租户最多 20 个;证书类型创建后不可通过 PATCH 更改;CNAME 验证后不可删除,否则影响证书续期;子域使用 passkey 时必须设置 relying_party_identifier。本资料未提供具体价格、完整代码示例与全部错误码细节。