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。