auth.example.com。
请在控制台的 Authentication > Branding and emails 中进行管理。该页面会以浅色和深色两种模式实时预览托管登录页面。

Authentication > Branding and emails,附托管页面预览。
您的品牌
品牌标志、品牌色、背景、圆角和字体均来自您在控制台中的应用 Customization 设置,托管页面和邮件会随之呈现相同样式。 如需修改,请选择 Edit in Customization。一次修改即可同时更新验证流程和登录页面。- 页面会跟随用户设备的浅色或深色模式显示,品牌色会针对深色背景进行调整。
- 页面会显示您应用的名称。
- 在 Free 套餐中,托管页面会显示 Secured by Didit 标识。

托管登录页面会跟随用户设备的浅色或深色模式显示。
页面文案和法律链接
托管页面提供英语、西班牙语、法语、德语和日语版本。页面会根据用户浏览器的语言选择显示语言,也可以通过登录 URL 中的
ui_locales 参数指定。
您可以为每种语言分别设置自定义文案:未设置文案的语言将保留 Didit 提供的翻译默认文案。
通过 API 调用 认证管理 API 中的 PATCH branding/ 可以设置相同的字段:
登录邮件
Branding and emails 中的邮件视图列出了您应用的登录邮件,并提供每封邮件的预览和 Send a test 按钮:
每封邮件在您的应用中均标记为 On 或 Off。
如果您已在自定义中设置已验证的邮箱域名,邮件将从该域名发出;否则,邮件将从
Didit <no-reply@didit.me> 发出。
自定义域名
默认情况下,您的应用在https://<slug>.auth.didit.me 上为用户提供登录服务。自定义域名会将托管页面、运行时 API 和令牌签发方迁移到您自己的子域名,例如 auth.example.com。自定义域名仅适用于生产应用:沙盒应用始终在 Didit 域名上为用户提供登录服务。
设置方法
- 在 Custom domain 下,输入 Your domain(例如
auth.example.com),然后选择 Add domain。请使用子域名:CNAME 记录无法设置在域名的根级别。 - 创建控制台显示的 DNS 记录:从您的域名指向应用 Didit 主机的
CNAME记录。 - 选择 Check DNS now。新记录最多可能需要一小时才能显示。Didit 找到该记录后,会为您的域名签发证书,证书会自动续期。
- 当域名显示 Verified 后,选择 Use this domain,将其设为应用的登录源。
通过 API 操作时,
PUT domain/ 并附带 {"domain": "auth.example.com"} 可添加域名,POST domain/verify/ 用于检查域名,POST domain/activate/ 用于激活域名,DELETE domain/ 用于删除域名。
激活后会发生哪些变化
- 签发方。 新令牌的
iss将包含您的域名,发现文档和 JWKS 也会迁移到该域名。请更新后端校验的签发方,或在旧令牌过期前同时接受两个签发方。参见 令牌与 JWKS。 - 可发布密钥。 该密钥编码了签发方,因此会发生变化:请从 Authentication > Developers 复制新密钥并更新到您的应用中。
- 旧域名下的会话和令牌 将在 5 分钟内失效。
- 通行密钥 必须在新域名上重新注册。
- 重定向 URL、设置以及已注册的用户 保持不变。