用户黑名单：屏蔽人脸、证件与邮箱

黑名单可阻止未通过合规检查的用户创建新会话或发起新交易。Didit 支持按标识符类型设置黑名单，因此您可以在多个数据点（人脸、证件、邮箱、电话、用户 vendor_data）上拦截同一名恶意行为者。

​

用户支持的标识符类型

每种标识符类型都在其自然的触发点执行：

• 人脸和证件：在新会话期间执行。
• 邮箱和电话：在收集这些信息的会话步骤中执行，或在交易 payload 中执行。
• IP 和设备：在会话中的设备与 IP 分析期间执行。
• 用户 vendor_data：在创建会话或交易时执行。

​

黑名单是如何产生的

​

系统名单与自定义名单

每个应用都有系统黑名单，每种标识符类型对应一个，由 Didit 自动管理。您无法重命名或删除它们。自定义名单则由您创建、命名并设定适用范围。

​

通过 API 将用户加入黑名单

使用 Lists API 添加黑名单条目。要按 vendor_data 拦截用户，请在对应的黑名单中添加 USER 类型的条目：

1. 使用 entry_type=user 和 is_system=true 过滤，列出所有名单，找到系统用户黑名单。
2. 在该名单上创建条目，并将 value 设为用户的 vendor_data。

要按人脸拦截用户，请参阅 人脸与生物识别。要按邮箱、电话、证件或 IP 拦截，请使用对应的系统黑名单，并在 value 中填写相应标识符。

​

执行流程

对于人脸和证件黑名单，检查发生在验证步骤中：

​

从黑名单中移除

• 控制台：Blocklist → [type] → row actions → Remove。
• API：使用 删除条目 端点，并提供名单 UUID 和条目 UUID。

移除条目不会自动将用户恢复为 ACTIVE。如果您希望允许其发起新会话，请使用 PATCH /v3/users/{vendor_data}/update-status/ 更改状态。

​

黑名单审计记录

黑名单中的每次添加或移除都会记录到审计日志中：

• 添加者（用户邮箱，或 'system'、'api'）。
• 操作时间。
• 可选的 comment，用于说明原因。
• 若条目是自动生成的，则关联的会话或交易。

​

后续步骤