> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 自定义域名 KYC 验证：DNS 设置

> 使用你自己的子域名而非 verify.didit.me 提供 Didit 验证流程。添加域名、创建两条 DNS 记录并完成所有权验证。

从您自己的子域名提供验证流程，即使用 `verify.yourbrand.com` 而不是 `verify.didit.me`。用户在整个流程中都停留在您的域名上，这样就去掉了[白标](https://docs.didit.me/zh/console/white-label.md)流程中最后一处可见的 Didit 引用。

> [!NOTE]
>
> 自定义域名是白标功能的一部分，适用于 **Scale** 和 **Enterprise** 套餐。您还需要对 **Customization** 拥有写入权限。只有只读权限的成员会看到该部分被禁用。

> [!NOTE]
>
> 当您的企业退出 Scale 或 Enterprise 套餐时（包括未转为付费套餐即结束的 Scale 试用），其自定义域名会被删除，新的验证链接将重新使用 Didit 的域名。2026 年 11 月 1 日之前连接的自定义域名可在任何套餐上保留；如果您删除它，重新添加自定义域名需要 Scale 或 Enterprise 套餐。

> [!NOTE]
>
> 自定义域名仅适用于**生产环境应用**。[沙盒](https://docs.didit.me/zh/integration/sandbox-testing.md)应用无法添加自定义域名，沙盒会话始终运行在默认的托管验证域名上。请在 Business Console 中切换到您的生产环境应用，然后设置域名。

***

## 要求

| 要求 | 详情 |
| - | - |
| **生产环境应用** | 该域名属于生产环境应用。沙盒应用无法配置自定义域名。 |
| **仅限子域名** | 请使用 `verify.yourbrand.com`。根域名（如 `yourbrand.com`）会被拒绝，带有 `www.` 前缀的域名同样会被拒绝。 |
| **未被占用** | 该子域名不能指向您现有的网站或应用。 |
| **DNS 访问权限** | 您需要在 DNS 服务商处创建两条记录。 |

***

## 工作原理

您在 Business Console 中输入子域名。随后 Didit 会生成两条 DNS 记录，供您在 DNS 服务商处添加：

| 记录 | 用途 |
| - | - |
| **验证 CNAME** | 证明您拥有该域名，并由此签发 SSL 证书。 |
| **CloudFront CNAME** | 将您的子域名指向验证界面。 |

两条记录均为必需。记录解析生效后，您即可在控制台中验证域名所有权，流程将开始从您的域名提供服务。

***

## 设置您的域名

**1. 添加域名**

前往 **Customization > Domain**，输入您的子域名（例如 `verify.yourbrand.com`），然后点击 **添加域名**。

控制台会生成您的 DNS 记录，这通常只需几秒钟。

**2. 复制两条记录**

控制台会为每条记录显示一张卡片：**验证 CNAME** 和 **CloudFront CNAME**。每张卡片提供两个值：

| 卡片字段 | 在您的 DNS 服务商处填写的位置 |
| - | - |
| **主机名** | 记录的**名称**（主机） |
| **数据/URL** | 记录的**值**（目标） |

> [!WARNING]
>
> 在 DNS 服务商处粘贴时，请勿对调 **主机名** 和 **数据/URL**，并为每个值使用复制按钮。验证值很长，容易输错。

**3. 在 DNS 服务商处添加两条记录**

将两条记录都创建为 `CNAME`。仅添加 **CloudFront CNAME** 是之后验证失败的最常见原因。

将 TTL 设置为 `300`，这样之后所做的任何更正都能在几分钟内生效，而不是几小时。

**4. 验证所有权**

返回控制台，点击 **验证域名**。验证成功后，面板会变为 **域名已验证**，按钮随之消失。

如果验证失败，控制台会显示 **验证失败** 框，并给出具体原因。在更改任何内容之前请先阅读，它会指明缺失或不正确的记录。

> [!NOTE]
>
> DNS 通常会在几分钟内生效，但最长可能需要 **24–48 小时**。如果控制台提示 **检测到 DNS 更改**，说明您的记录已正确配置，只是生效仍在进行中，无需任何操作。

***

## 更改或删除您的域名

要将流程迁移到其他子域名，请输入新的子域名并点击 **更新域名**。Didit 会签发一对新的记录，因此您必须在 DNS 服务商处添加这些记录，并重新验证。

要恢复为 `verify.didit.me`，请清空该字段并点击 **删除域名**。

> [!NOTE]
>
> 配置自定义域名期间，无法重新启用 Didit 登录页面。请先删除该域名。

***

## 故障排除

> [accordion] 出现 500 错误，或提示另一个 CloudFront 分配
>
> 您的子域名有一条与 CNAME 冲突的 `A` 记录，同一主机不能同时拥有这两种记录。请删除 `A` 记录，只保留 CNAME。
>
> 如果没有 `A` 记录，说明 CloudFront CNAME 指向了错误的目标。请与控制台中 **Data/URL** 的值逐字符比对。

> [accordion] 验证始终不成功
>
> 请检查您的服务商处是否**两条**记录都已添加。仅添加 CloudFront 记录是最常见的原因，因为流程页面看似能正常加载，但证书始终无法签发。
>
> 控制台中的 **验证失败** 框会指出缺失或错误的记录。

> [accordion] 证书始终无法签发（Cloudflare）
>
> 请将两条记录都设为 **DNS only**，即灰色云朵，关闭代理。橙色云朵代理会拦截请求，导致证书无法签发。
>
> 没有代理开关的服务商（例如 cPanel）不受影响。

> [accordion] 记录名称被重复追加
>
> 某些服务商会自动追加您的域名，将 `verify.yourbrand.com` 变成 `verify.yourbrand.com.yourbrand.com`。
>
> 在这些服务商处，请输入**相对**名称，而不是控制台显示的完整名称：输入 `verify` 而不是 `verify.yourbrand.com`，输入 `_abc123.verify` 而不是 `_abc123.verify.yourbrand.com`。然后重新打开已保存的记录，检查其保存的完整名称是否与控制台中的 **主机名** 完全一致。

> [accordion] 修改需要数小时才能生效
>
> 您的记录会按其 TTL 的时长进行缓存。请将 TTL 设为 `300`，并等待旧值过期后再重新测试。

***

## 后续步骤

* **让界面的其余部分与您的品牌保持一致**：颜色、徽标和字体可在[自定义](https://docs.didit.me/zh/console/white-label.md)中设置。
* **按工作流启用您的样式**：品牌样式仅适用于开启了 **包含自定义样式** 的工作流。请参阅[白标](https://docs.didit.me/zh/console/white-label.md#在工作流中启用自定义样式)。
* **了解您的披露义务**：自定义域名会隐藏 Didit 的品牌标识，但不会改变 Didit 的角色。请参阅[合规责任](https://docs.didit.me/zh/console/white-label.md#白标流程中的合规责任)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.