> ## 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.

# Didit 认证控制台指南：登录、会话与设置

> Didit 企业控制台认证板块各页面说明：指标、用户、登录与会话，以及各项登录和安全设置。

**Authentication** 是 Didit 企业控制台中用于配置您的应用中用户登录方式，并查看登录过程中发生的情况的部分。
请从产品列表中的 **Authentication** 打开它；其侧边栏按以下方式对页面进行分组。

| 分组 | 页面 |
| - | - |
| 认证 | [概览](#概览)、[用户](#用户)、[登录记录](#登录与会话) |
| 登录 | [登录方式](#登录方式)、[已验证身份](#已验证身份)、[组织](#组织) |
| 防护 | [机器人防护](#机器人防护)、[安全与会话](#安全与会话)、[代理访问](#代理访问) |
| 构建 | [品牌与邮件](#品牌与邮件)、[导入用户](#导入用户)、[开发者](#开发者) |

设置属于您在控制台顶部选择的应用，生产环境应用与沙盒应用各自拥有独立的设置和用户。
查看本部分需要 `authentication` 权限的 **read** 级别，修改则需要 **write** 级别：请参阅[角色与权限](https://docs.didit.me/zh/console/roles-permissions.md)。
如果您的套餐不包含某项功能，该功能的页面会显示套餐说明；沙盒应用包含所有套餐的功能，因此您可以先行试用。

## 概览

本部分的主页用一句话概括过去 30 天的情况，并在 **Ask Didit** 中回答有关您登录情况的问题。

| 指标 | 统计内容 |
| - | - |
| **Monthly active users** | 过去 30 天内登录过的人数，并与之前 30 天进行对比。 |
| **Sign-ins** | 过去 30 天内的登录次数，以及每位活跃用户的平均登录次数。 |
| **Success rate** | 登录尝试中成功的比例，以及最常见的失败原因。 |
| **Passkey adoption** | 使用通行密钥完成的登录占比。 |

**Needs your attention** 列出您的团队应当处理的事项，例如因多次输入错误密码而被锁定的账户，并提供 **Unlock** 或 **Keep locked** 操作。
**See all analytics** 会在 [Analytics](https://docs.didit.me/zh/console/analytics.md) 中打开认证指标。

![Didit Business Console 中的认证概览，显示过去 30 天的月活跃用户、登录次数、成功率和通行密钥使用率](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-overview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=211a7703b2c07f4fb0f993d4c5636f42)

Business Console 中的 Authentication > Overview。

## 用户

**Users** 与控制台其他页面中的人员列表相同，因此每个人的登录记录与其验证和交易记录并列显示。
**Can sign in** 和 **Locked or blocked** 视图以及 **Sign-in** 筛选器可将列表缩小到登录状态、登录方式或 MFA。

对于某个人员，您的团队可以执行以下操作：

| 操作 | 作用 |
| - | - |
| **Block** 和 **Unblock** | 停止或恢复登录。封禁还会结束其会话和智能体访问。状态变更时，您可以向该人员发送邮件。 |
| **Unlock** | 清除临时锁定和失败尝试次数。 |
| **Revoke sessions** | 让该人员在所有位置退出登录，包括智能体。 |
| **Reset MFA** | 移除所有第二因素，包括通行密钥，并结束其会话。仅 Owner 或 Admin 可用。 |
| **Send sign-in link** | 向该人员发送一封邮件，其中包含一个 15 分钟有效、仅可使用一次、指向您登录页面的链接。仅 Owner 或 Admin 可用。 |
| **Send password reset** | 向该人员发送一封邮件，其中包含一个 30 分钟有效的密码重置链接。 |

您可以选择多个人员，一次对最多 100 人执行同一操作。
每项操作背后的规则见[管理员身份操作](https://docs.didit.me/zh/authentication/sign-in-methods.md#管理员身份操作)。

## 登录与会话

**Sign-ins** 有两个视图。

**Sign-in attempts** 列出每次登录尝试的状态（成功、失败、需额外验证或已阻止）、用户、方法、设备、位置、风险等级和时间。可按状态、方法和风险进行筛选。打开某次尝试即可查看其证据，例如设备、网络以及任何 VPN 或锁定信号，并可使用 **Open person**、**See in Events** 和 **Block this IP** 操作。**Block this IP** 会将该地址添加到 [名单](https://docs.didit.me/zh/console/blocklist-users.md) 中的黑名单。

![Didit Business Console 中的 Sign-ins 页面，列出登录尝试及其状态、用户、方法、设备、位置、风险和时间](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

身份验证 > 登录：列出每次尝试，并可按状态、方法和风险筛选。

**Active sessions** 列出当前已登录的会话，包括用户、设备、位置、每个会话的开始时间、最近活跃时间和结束时间。结束时间遵循您设置中的规则：会话持续 X，或无活动 Y 后结束。**Revoke** 可立即结束该设备上的会话。

![Didit Business Console 中的 Active sessions 视图，列出已登录的会话，包括设备、位置、开始时间、最近活跃时间、结束时间以及 Revoke 按钮](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-active-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=098f6be31804b0af7c680e569f341bfb)

身份验证 > 登录 > 活跃会话，每个会话都带有 Revoke 按钮。

**Open in Events** 以事件形式展示相同的活动，并通过[欺诈视图](https://docs.didit.me/zh/authentication/events-and-webhooks.md#欺诈视图)将登录与每位用户的其他活动结合起来。

## 登录方式

开启或关闭每种方式，并进行配置。
每种方式都会显示其在您登录次数中所占的比例。

| 分组 | 方式 |
| - | - |
| 无密码 | **Passkeys**、**Email code**、**Magic link** |
| 密码 | **Email and password** |
| 社交账号 | 每个社交登录提供商；在沙盒中使用 Didit 的测试凭证，或使用您自己应用的客户端 ID 和密钥 |
| 手机和可复用身份 | **Phone code**，以及发送该验证码的电话验证工作流；**Didit ID Wallet** 暂不可用 |

**Hosted sign-in** 卡片会显示您的托管登录 URL，点击 **Try your sign-in page** 即可打开该页面。
有关每种方式的工作原理，请参阅 [登录方式](https://docs.didit.me/zh/authentication/sign-in-methods.md)。

![Didit 商业控制台中的登录方式页面，包含托管登录页面卡片、无密码和密码登录方式，以及托管页面的实时预览](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

身份验证 > 登录方式，附托管登录页面的实时预览。

## 已验证身份

选择用户账户创建前必须通过的验证（无、活体检测或完整身份证件验证），设置在敏感操作前再次要求验证的规则（例如超过某一金额的出款、新增银行账户、变更邮箱或电话，以及新设备后再出款），以及您的应用在 token 中接收的已验证声明。
**预览二次验证**可显示用户看到的内容。
每条规则都会显示本月发起的验证次数以及通过的次数。
详见 [已验证身份](https://docs.didit.me/zh/authentication/verified-identity.md)。

![Didit Business Console 中的已验证身份页面，展示注册验证级别及其价格，以及敏感操作前的二次验证规则](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

认证 > 已验证身份：注册时的验证以及敏感操作前的规则。

## 组织

为企业客户开启组织功能并进行管理：点击 **新建组织**，然后管理每个组织的单点登录（SSO）和设置链接、已验证域名（支持自动加入）、成员、角色和邀请。
关键指标统计组织数量、成员数、SSO 连接数和已验证域名数。
请参阅[组织](https://docs.didit.me/zh/authentication/organizations.md)。

![Didit Business Console中的组织页面，展示关键指标，以及组织列表（包括各组织的成员、已验证域名和单点登录状态）](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-organizations.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=95f8ab54f499735fe3f8593c565c0daa)

身份认证 > 组织。

## 机器人防护

**Only allow humans** 是所有防护的总开关。
在它下方，六项防护（机器人检测、凭证填充、暴力破解锁定、一次性邮箱、VPN 与数据中心网络，以及不可能的旅行）各自可设置为 **Off**、**Log**、**Challenge** 或 **Block**，并显示本月各项防护匹配的尝试次数。
**Attack mode** 会在紧急情况下对每次注册和登录进行挑战，并会自动关闭。
关键指标显示本月被拦截和被挑战的数量，以及最大瞬时峰值。点击 **See detections** 可打开对应的事件。
详情请参阅 [机器人防护](https://docs.didit.me/zh/authentication/bot-protection.md)。

![Didit 企业控制台中的机器人防护页面，包含 Only allow humans 开关、攻击模式、关键指标，以及每项防护的 Off、Log、Challenge 和 Block 模式](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-bot-protection.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=bb899d54d9e9e32172d83afbfa996375)

认证 > 机器人防护。

## 安全与会话

| 卡片 | 设置 |
| - | - |
| **Recommendations** | 建议的更改，例如要求组织管理员启用 MFA。应用后标记为 **Done**。 |
| **Multi-factor authentication** | 哪些人必须使用 MFA：**Everyone**、**Organization admins** 或 **Optional**。用户可以使用通行密钥、验证器应用或备用码。 |
| **Sessions** | **Session lifetime**（1、7、30 或 90 天）、**Ends when idle for**（30 分钟、2 小时、1 天或 7 天）、**Sign out other devices when the password changes**，以及 **Several devices at once**。 |
| **Password** | **Minimum password length**（8、10、12 或 14）。始终拒绝常见密码。泄露密码检查位于 **Bot protection** 中。 |
| **Account protection** | **Who can sign up**（**Anyone**、**Invited people** 或 **Allowed domains**，并附带您的允许电子邮件域名列表）、**Email subaddresses**，以及来自 **Lists** 的允许名单和黑名单，二者均在登录时生效。 |
| **Redirect URLs and allowed origins** | Didit 可以将用户重定向到的确切地址，以及可以调用您的登录来源的 Web 来源。请参阅 [重定向 URL](https://docs.didit.me/zh/authentication/overview.md#重定向-url)。 |
| **Sign-in URL** | 在您的应用中开始登录的位置。您的团队从用户记录中发送的登录链接会打开该位置。 |

每项设置都对应[应用设置](https://docs.didit.me/zh/authentication/overview.md#应用设置)中的一个字段。

![Didit Business Console 中的安全与会话页面，包含 MFA 策略、会话有效期、空闲超时和密码设置](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-security-and-sessions.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=ab3736c1463119747c89f6269ef31e05)

认证 > 安全与会话。

## 代理访问

开启代理访问，并选择代理可以执行的操作、代理会话的持续时间，以及用户如何批准代理。
该页面列出活跃的代理会话，并带有 **Revoke** 按钮，同时统计批准与撤销的次数。
参阅 [代理访问](https://docs.didit.me/zh/authentication/agent-access.md)。

![Didit 商业控制台中的代理访问页面，包含代理设置、关键指标，以及带有 Revoke 按钮的活跃代理会话](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

身份验证 > 代理访问。

## 品牌与邮件

在 Customization 中查看您的品牌，设置页面文字以及您的服务条款和隐私政策链接，添加自定义登录域名，并以浅色和深色模式预览托管页面。
邮件视图列出您的登录邮件（每封都附有预览）及 **Send a test**，并列出您的电子邮件和短信的发件人。
请参阅[品牌与自定义域名](https://docs.didit.me/zh/authentication/branding-and-custom-domain.md)。

![Didit 商业控制台中沙盒应用的品牌与邮件页面，包含 Customization 中的品牌、页面文字以及托管页面的预览](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

身份验证 > 品牌与邮件，托管页面的预览。

## 导入用户

使用 CSV 或 JSON 文件导入来自其他身份平台或您自有数据库的用户：先执行试运行，检查结果，然后再正式导入。
**导入历史**列出所有导入任务及其状态和结果。
请参阅[导入用户](https://docs.didit.me/zh/authentication/migration.md)。

## 开发者

| 卡片 | 包含内容 |
| - | - |
| **密钥** | **公开密钥（Publishable key）**，可以公开，放在您的应用中；**私密密钥（Secret key）**，绝不能放在客户端代码中；以及 **Frontend API** 地址。 |
| **AI 编程代理提示词** | 一段现成的提示词，包含您应用的密钥，用于将身份验证添加到您的代码库中，并会先询问您是否要从其他平台迁移用户。 |
| **SDK** | 适用于 React、Next.js、iOS 和 Android 的安装与登录代码片段。 |
| **事件与 Webhook** | `auth.*` Webhook 类型，以及您的服务器会接收到的内容。 |

激活自定义域名后，公开密钥会发生变化：请将此处的新密钥复制到您的应用中。
请参阅[快速开始](https://docs.didit.me/zh/authentication/quickstart.md)和[事件与 Webhook](https://docs.didit.me/zh/authentication/events-and-webhooks.md)。


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