> ## 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 控制台中的黑名单对话框](https://mintcdn.com/didit-0f962782/ibesJiSLVa9jZb5z/images/console-blocklist-dialog.jpeg?fit=max\&auto=format\&n=ibesJiSLVa9jZb5z\&q=85\&s=720e89731283ab7a417aeda7e2ca0a0a)

***

## 概述

黑名单针对四种实体类型运作：

> [card] 证件黑名单
>
> 防止重复使用被识别为欺诈、被盗或存在其他问题的特定证件。

> [card] 人脸黑名单
>
> 防止生物特征数据与先前列入黑名单的人脸匹配的用户通过验证。

> [card] 电话号码黑名单
>
> 防止使用已列入黑名单的电话号码进行验证。

> [card] 邮箱黑名单
>
> 防止使用已列入黑名单的邮箱地址进行验证。

> [!NOTE]
>
> 在验证过程中检测到黑名单实体时，会话将被自动拒绝，并返回相应的警告：`ID_DOCUMENT_IN_BLOCKLIST`、`FACE_IN_BLOCKLIST`、`FRONT_CAMERA_FACE_IN_BLOCKLIST`、`PHONE_NUMBER_IN_BLOCKLIST`、`EMAIL_IN_BLOCKLIST`、`IP_ADDRESS_IN_BLOCKLIST` 或 `DEVICE_FINGERPRINT_IN_BLOCKLIST`。

***

## 黑名单的工作方式

### 证件黑名单

将证件添加到黑名单时，系统会存储该证件唯一标识符（证件号码、MRZ 数据等）的安全指纹。在之后的验证会话中，如果证件与这些指纹匹配，会话将被自动拒绝。

适用于：

* 防止重复使用已知的欺诈证件
* 拦截已报告为失窃的证件
* 防止多个账户使用同一证件

### 人脸黑名单

将人脸添加到黑名单时，系统会存储从面部特征中提取的生物特征模板。这些模板会与新验证会话中的人脸进行比对。

一次会话可以提供多张可加入黑名单的人脸：

* **活体自拍**，在活体检测期间拍摄。
* **证件采集期间拍摄的自拍**。用户拍摄证件正反面时，前置摄像头可能会为其拍摄一张自拍（参见[身份证件验证报告](https://docs.didit.me/zh/core-technology/id-verification/report-id-verification.md)）。这些自拍中的每一张都可以单独加入黑名单，这也涵盖了在活体检测步骤之前就已停止的用户。

无论黑名单中的人脸来自何处，新会话中都会将其与两类自拍进行比对：

* 活体自拍会在活体检测期间与黑名单比对（`FACE_IN_BLOCKLIST`）。
* 证件采集期间拍摄的每张自拍，会在评估证件时与黑名单比对（`FRONT_CAMERA_FACE_IN_BLOCKLIST`，若为近似匹配则为 `POSSIBLE_FRONT_CAMERA_FACE_IN_BLOCKLIST`，并会转入审核）。只有人脸清晰的自拍才会进行比对。

要在控制台中将会话中的人脸加入黑名单，请打开该会话，选择 **添加到黑名单**，然后选中您想要的人脸。每张人脸都会显示其图片及拍摄位置。

适用于：

* 防止曾尝试欺诈的用户创建新账户
* 在新的注册尝试中执行平台封禁
* 落实监管排除要求

### 电话号码黑名单

将电话号码添加到黑名单时，系统会将新验证会话与已列入黑名单的号码进行评估（包括标准化的 E.164 格式）。

适用于：

* 拦截与反复滥用或违反政策相关的号码
* 防止使用同一电话号码再次注册
* 落实地区合规要求

### 邮箱黑名单

将邮箱地址添加到黑名单时，系统会将新验证会话与已列入黑名单的地址进行检查（不区分大小写，并经过标准化处理）。

适用于：

* 防止来自同一邮箱地址的反复欺诈或垃圾信息尝试
* 对与同一邮箱关联的多个账户执行封禁
* 满足账户注册的合规要求

***

## 交易黑名单

除验证黑名单外，以下实体类型也会在 **交易监控** 期间进行检查。如果发现任何匹配项，交易将在评估规则之前被**立即拒绝**：

| 黑名单 | 检查的实体 |
| - | - |
| **钱包地址黑名单** | 加密货币钱包支付方式的 `account_id` |
| **银行账户黑名单** | 银行转账支付方式的 `account_id` |
| **IP 地址黑名单** | 交易方设备的 IP 地址（支持 CIDR 范围） |
| **设备指纹黑名单** | 交易方的设备指纹 |
| **用户黑名单** | 申请人的 `vendor_data` 标识符 |
| **企业黑名单** | 企业的 `vendor_data` 标识符 |

> [!NOTE]
>
> 交易黑名单检查独立于验证黑名单检查。两者使用相同的底层名单，因此为验证而列入黑名单的实体同样会被列入交易黑名单。

***

## 管理黑名单

可通过以下方式将条目添加到黑名单：

* **Didit 控制台**：在侧边栏中打开 **名单**，选择一个黑名单，然后手动添加条目。同一页面还包含您的允许名单和自定义名单，**名单 > 生物特征模板** 中保存着您选择保留的[生物特征模板](https://docs.didit.me/zh/console/data-retention.md#生物特征模板保留)。
* **Lists API**：以编程方式管理黑名单条目。请参阅 [Lists API 参考](https://docs.didit.me/zh/management-api/lists/overview.md)。

> [!NOTE]
>
> 有关基于 API 的黑名单管理，请参阅[创建条目](https://docs.didit.me/zh/management-api/lists/create-entry.md)、[删除条目](https://docs.didit.me/zh/management-api/lists/delete-entry.md)和[列出条目](https://docs.didit.me/zh/management-api/lists/list-entries.md) endpoint。


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