跳转到主要内容
Didit Authentication 的托管登录页面和登录邮件使用您的品牌,与您的验证流程使用的是同一品牌。 您可以为 Authentication 设置页面文本和法律链接,也可以将登录移至您自己的域名,例如 auth.example.com。 请在控制台的 Authentication > Branding and emails 中进行管理。该页面会以浅色和深色两种模式实时预览托管登录页面。
Didit 商业控制台中沙盒应用的 Branding and emails 页面,显示来自 Customization 的品牌、页面文本以及托管登录页面的预览

Authentication > Branding and emails,附托管页面预览。

您的品牌

品牌标志、品牌色、背景、圆角和字体均来自您在控制台中的应用 Customization 设置,托管页面和邮件会随之呈现相同样式。 如需修改,请选择 Edit in Customization。一次修改即可同时更新验证流程和登录页面。
  • 页面会跟随用户设备的浅色或深色模式显示,品牌色会针对深色背景进行调整。
  • 页面会显示您应用的名称。
  • 在 Free 套餐中,托管页面会显示 Secured by Didit 标识。
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 域名上为用户提供登录服务。
通行密钥归属于用户登录所用的域名。 启用自定义域名后,现有通行密钥必须重新注册,因此请在用户开始添加通行密钥之前先添加您的域名。

设置方法

  1. 在 Custom domain 下,输入 Your domain(例如 auth.example.com),然后选择 Add domain。请使用子域名:CNAME 记录无法设置在域名的根级别。
  2. 创建控制台显示的 DNS 记录:从您的域名指向应用 Didit 主机的 CNAME 记录。
  3. 选择 Check DNS now。新记录最多可能需要一小时才能显示。Didit 找到该记录后,会为您的域名签发证书,证书会自动续期。
  4. 当域名显示 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、设置以及已注册的用户 保持不变。
请将可发布密钥保存在应用的单一配置项中,这样切换时只需修改一处。
最后修改于 2026年11月22日