跳转到主要内容
Didit Authentication 是新功能。Didit 会为您的应用开启事件投递。使用户退出登录或封禁用户的规则操作尚未生效:使用这些操作的规则会记录该操作,但不会执行。
Didit Authentication 会自动将其活动数据发送至 Didit,您无需自行提交登录事件。每个事件都会记录到具有相同 vendor_data 的用户名下,与该用户的验证和交易记录并列显示。 请勿再将同一次登录的 auth.login 事件发送到 /v3/events/。这样会导致事件被重复存储,而且这些事件不会更新用户的登录摘要,也不会触发 auth.* Webhook。

发送的内容

机器人防护的判定结果(attempt_challenged、attempt_blocked 等)也会存储为 auth.* 事件,因此会显示在时间线中。 新设备是指其设备 ID 和指纹都与该用户之前登录过的设备均不匹配的设备。 每个事件包含以下内容:
  • 登录 method(例如 password 或 passkey),以及登录失败或账户被锁定时的 reason,
  • 地址和设备信息:持久设备 ID、指纹、用户代理,以及客户端提供时的机器人评分,
  • 会话 ID。
对于未知或未经验证的标识符所发起的登录失败,事件中没有 vendor_data。Didit 永远不会接收标识符本身,只会接收其带密钥的哈希值。这些尝试不会关联到任何用户,但下方的欺诈视图仍会按账户统计这些尝试。

查看位置

用户资料

每个用户都有一份登录摘要,显示在 用户 列表和用户资料中,并通过 /v3/users/ 以 authentication 字段返回:
  • status 取值为 ACTIVE(活跃)、LOCKED(因安全策略被锁定)或 BLOCKED(被您的团队封禁)。
  • 对于没有登录身份的用户,authentication 为 null。
  • 您可以在 用户 中按登录状态、登录方式(包括“无”)和 MFA 进行筛选。

事件与时间线

登录事件会显示在控制台的 事件 页面以及每个用户的 事件 标签页中。查看这些事件需要 list:transactions 或 read:authentication 权限。打开某个登录事件后,可以看到设备和网络信息、任何防护原因(例如 bots、stuffing、brute、vpn、travel 或 attack_mode),以及该事件所匹配的规则。

欺诈视图

事件 页面提供了现成的视图,可将登录记录与用户的其他活动结合起来分析: 这些视图最多可回溯 31 天。

事件规则

登录事件与您的其他事件一样,会经过相同的事件规则处理。Authentication fraud 规则包包含四个预设: 在您自定义的规则中,以下字段较为实用:event.category、event.action_type、event.payload.method、event.payload.reason、event.security.changed_field、event.device.fingerprint、event.device.persistent_device_id、event.device.bot_score、event.ip.is_vpn_or_tor、event.ip.is_data_center、event.ip.country、event.ip.travel_distance_km 和 event.ip.travel_speed_kmh。 事件规则仅对登录事件提供两项操作:让用户退出所有会话和禁止用户登录。这两项操作尚未生效。在此之前,规则会以 DISABLED 状态记录这些操作,但不会执行。其他操作(评分、状态、标签、备注、名单和案件)均照常运行。

Webhooks

将 Webhook 目标订阅到您需要的 auth.* 类型。只有已订阅的目标才会收到这些事件。您可以在控制台中使用 Try Webhook 发送每种类型的示例。
auth.new_device
  • 请使用 auth_event.event_id 进行去重。它是登录事件自身的 ID,同一事件的每次投递都保持不变。auth_event.event_uuid 可用于通过 GET /v3/events/{event_uuid}/ 读取已存储的事件。
  • 对于未指向任何已知用户的尝试,vendor_data、vendor_user_id 和 authentication 为 null。
  • 请按照 Didit 所有 Webhook 的方式验证签名(参见 webhooks)。

计费

认证事件不按事件计费,认证按月活跃用户计费。

您的应用所拥有的事件

对于发生在您自有产品中的操作,例如资料变更或提现请求,请从您的服务器(使用 x-api-key 调用 POST /v3/events/)或通过设备使用限定范围的监控 token 提交事件。参见 事件 和 SDK 事件提交。请使用该用户访问令牌中的 vendor_data。
最后修改于 2026年11月7日