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

# 数据保留与删除：GDPR 隐私控制

> 在 Didit 中配置身份核验数据的保存时长、按需删除会话，并借助欧盟数据驻留、GDPR 和数据处理协议（DPA）支持实现隐私优先的 KYC。

## 角色与处理位置

| 方面 | 详细信息 |
| - | - |
| **处理者角色** | Didit 作为**数据处理者**行事；您仍是**数据控制者**。 |
| **处理区域** | 每个应用的[数据位置](https://docs.didit.me/zh/console/applications.md#数据所在地)在创建应用时选定：默认为欧盟（爱尔兰），悉尼（澳大利亚）和墨西哥即将推出。企业账户可以启用**境内处理**（本地数据驻留），具体取决于可用性和合同。 |
| **合规定位** | 设计旨在支持 **GDPR** 及当地数据保护法规。请在下方配置保留期限，以满足您的义务。 |

> [!NOTE]
>
> 需要 DPA、TOMs 或其他合规证明吗？请联系您的 Didit 对接人员。

***

## 保留控制

在 **Business Console → App Settings → Data retention** 中配置保留期限。

**1. 打开保留设置**

前往 **Business Console → App Settings → Data retention**。

**2. 选择保留策略**

从 **1 个月**到 **10 年**中选择一个期限。**无限期**和自定义期限仅在企业版中提供。
新应用默认采用其套餐包含的最长期限：免费版为 **1 年**，Growth 版为 **5 年**，Scale 版为 **10 年**，企业版为**无限期**。

**3. 保存**

点击 **保存**，将策略应用于所有未来和现有会话。

该策略适用于 Didit 存储的验证输入/输出、衍生结果以及运营元数据。当会话达到保留期限结束时，它将按照[删除会话](https://docs.didit.me/zh/sessions-api/delete-session.md)的方式被删除，包括其人脸特征向量，除非您启用了[生物特征模板保留](#生物特征模板保留)。

![Business Console 中的数据保留设置](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/data-retention-settings.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=e2ca6a8e32ed8ec5a2cd910d3cdbaefc)

***

## 手动删除

当您需要一次性删除时，可以在控制台中删除单个会话。

1. 在侧边栏中打开**用户验证**（或**企业验证**）。
2. 搜索或筛选目标会话。
3. 点击右上角的**删除**按钮并确认。

![在控制台中删除验证会话](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/data-retention-delete-session.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=ff1947059d7d9d60643b7568e189e3a6)

***

## 程序化删除

随时可以通过 API 调用[删除会话](https://docs.didit.me/zh/sessions-api/delete-session.md) endpoint 删除会话。

```bash theme={null}
curl --request DELETE \
  --url https://verification.didit.me/v3/session/{session_id}/delete/ \
  --header 'x-api-key: YOUR_API_KEY'
```

| 响应 | 含义 |
| - | - |
| `200 OK` | 会话已删除。响应体会报告人脸生物特征数据的处理结果（`face_retention_outcome`）。 |
| `404 Not Found` | 会话已被删除，或 `session_id` 未知。 |

如需处理数据主体的擦除请求，请在请求体中发送 `{"deletion_instruction": "privacy_erasure"}`，以便同时清除该人员保留的任何生物特征模板。

***

## 生物特征模板保留

每个带活体自拍的 KYC 会话都会保存一个人脸特征向量，用于重复检测和 [人脸搜索 1:N](https://docs.didit.me/zh/core-technology/face-search/overview.md)。默认情况下，该特征向量会随会话一起删除，因此如果您删除了某人的会话，此人再次验证时不会被标记为重复。

如果工作流的活体检测步骤已[关闭自动人脸搜索](https://docs.didit.me/zh/core-technology/face-search/overview.md#关闭自动人脸搜索)，则该特征向量从一开始就不会被保存，因此保留策略对这些会话没有需要保留的内容。

如果您在审批后很快删除会话，但仍需要识别重复注册，请启用**生物特征模板保留**。Didit 会像往常一样删除会话及其全部数据，并保留一个与用户绑定、单独管理且不含图像的人脸生物特征模板。

> [!WARNING]
>
> 保留的生物特征模板属于生物特征数据。它不是匿名的，也不是临时的，并且不会随会话一起删除。它会一直保留，直到计划到期、适用法律规定的更早期限、用户被删除、收到隐私擦除请求或被明确清除。只有在您的控制者指令和隐私声明涵盖该功能时才启用保留，并且所选的保留期限必须符合适用于您用户的法律。

### 启用方法

**1. 打开保留设置**

前往 **Business Console → App Settings → Data retention**。

**2. 开启保留生物特征模板**

选择 **Retain until scheduled expiry or earlier deletion**。设置说明为：*在运营性会话删除后，保留一个不含图像的人脸生物特征模板，用于租户范围内的重复检测。该模板仍属于生物特征数据，并会按其配置的到期时间、适用法律规定的期限、用户删除、隐私擦除请求或明确清除而删除。*

**3. 设置有限的保留期限**

输入模板可保留的天数（1 至 3650）。未填写则无法保存设置。Didit 会应用以下三者中最短的期限：此期限、您的通用保留窗口，以及您在删除调用中发送的任何截止时间。

**4. 保存**

该策略仅对此后的删除生效。修改设置不会创建或清除任何现有模板。

通过编程方式设置相同策略，请使用 `PATCH /v3/webhook/`：

```bash theme={null}
curl -X PATCH https://verification.didit.me/v3/webhook/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"face_retention_policy": "retain_until_user_deleted", "face_retention_days": 365}'
```

| 字段 | 取值 | 说明 |
| - | - | - |
| `face_retention_policy` | `delete_with_session`（默认）、`retain_until_user_deleted` | 删除会话时，人脸特征向量如何处理。 |
| `face_retention_days` | 整数 1-3650 | 保留模板的有限保留期限。当策略为 `retain_until_user_deleted` 时必填；缺少该字段时请求会被以 `400` 拒绝。 |

现有应用会保持 `delete_with_session`，直到您更改策略。Didit 不会代您启用保留。

### 什么会保留，什么会被擦除

| 随会话一起删除 | 保留（仅限选择加入） |
| - | - |
| 决策、提取的数据以及每条特征记录 | 用于比对的数值型人脸模板 |
| 证件图像、肖像、自拍、活体视频、地址证明文件、额外上传文件 | 新的随机模板 ID 和一个不透明的来源参考标识 |
| 会话 ID、会话编号及其与任何媒体文件的关联 | 所属用户、保留日期、指令类别和指令 ID，以及执行操作的主体 ID |

保留的模板限定于租户范围，并且仅依据您的指令用于重复人脸和多账户检测、生物识别认证以及您自己的人脸名单。它绝不会用于模型训练、数据分析、跨组织比对，也不会用于 Didit 自身的欺诈处理。

### 逐次删除控制

每次删除都会报告其结果，并且每个删除调用都可以覆盖该策略：

* **控制台**：删除确认页面会显示每个会话的模板将被保留还是删除。确认文字为：*此操作将删除该会话，并开始删除其会话数据。如果为此次运营性删除启用了生物特征模板保留，则一个不含图像的生物特征模板会单独保留，直至其计划到期或被更早清除。隐私擦除请求同样会清除该模板。* 没有用户的会话无法保留模板，并会被标记为此类情况。
* **API**：在 [删除会话](https://docs.didit.me/zh/sessions-api/delete-session.md) 或 [批量删除会话](https://docs.didit.me/zh/management-api/sessions/batch-delete.md) 中发送 `retain_face_embeddings`、`face_retention_days`、`face_retention_deadline`、`deletion_instruction` 和 `instruction_id`。

### 两种删除指令

| 指令 | 作用 |
| - | - |
| 运营性会话删除（`operational_session_delete`，默认） | 删除会话及其数据。只有在策略或请求如此指定时才保留模板，并且响应会说明结果。 |
| 隐私擦除（`privacy_erasure`） | 删除会话，并清除该人员的所有已保留模板。应用策略无法覆盖此指令。用于处理数据主体请求。 |

### 何时清除模板

* 您在 **Lists → Biometric templates** 中或通过 [生物特征模板 API](https://docs.didit.me/zh/management-api/biometric-templates/overview.md) 清除它。
* 您使用 [批量删除用户](https://docs.didit.me/zh/management-api/users/delete.md) 删除该用户。
* 您使用 `deletion_instruction: "privacy_erasure"` 删除该用户的任意会话。
* 其保留期限结束。Didit 会自动清除它。

将策略切换回 **随会话一起删除** 会停止新模板的创建，但不会清除现有模板，您需要明确清除它们。

### 在哪里查看

* **Lists → Biometric templates** 列出每个模板，包括其所属用户、来源、保留日期和到期日期以及状态，并支持单个和批量清除。
* **Users → \[user] → Biometric templates** 显示绑定到某一用户的模板。
* [生物特征模板 API](https://docs.didit.me/zh/management-api/biometric-templates/overview.md) 提供相同的数据和操作，每次保留和清除都会记录在审计日志中。

> [!NOTE]
>
> 保留的模板受您的数据处理协议中生物特征数据条款的约束。本页内容不构成法律建议：您仍需对适用于您用户的法律依据、告知、同意和保留期限负责。

***

## 处理后清除模式

为实现最大程度的数据最小化，请先通过 Didit 处理验证数据，并在通过 Webhook 收到结果后立即清除。

**1. 创建会话**

您的后端调用 [Create Session](https://docs.didit.me/zh/sessions-api/create-session.md) API。

**2. Didit 执行检查**

身份验证、活体检测、AML 以及其他已配置的检查将自动执行。

**3. 接收 Webhook**

Didit 会发送包含 `status`、`session_id`、`vendor_data` 以及完整验证数据的 [Webhook](https://docs.didit.me/zh/integration/webhooks.md)。

**4. 仅保存所需数据**

仅存储您的记录所需的最少字段（例如 `status`、`vendor_data`）。

**5. 从 Didit 删除**

针对该 `session_id` 调用 [Delete Session](https://docs.didit.me/zh/sessions-api/delete-session.md) API，以从 Didit 删除该会话及其数据。如果您依赖未来注册中的重复检测，请先启用[生物特征模板保留](#生物特征模板保留)；否则人脸特征向量也会被一并删除。

***

## 安全与保障

> [card] ISO/IEC 27001
>
> 已建立信息安全管理体系（ISMS）。证书及摘要可按需提供。

> [card] 渗透测试
>
> 定期开展第三方渗透测试，并对整改情况进行跟踪。

> [card] 无已知安全漏洞
>
> 截至目前，未报告任何安全事件。

> [card] 内部安全团队
>
> 设有专门的网络安全团队，采用最小权限访问，并严格隔离各环境。

> [!NOTE]
>
> 所有 API 活动都会记录在 **审计日志** 中，用于安全、合规和故障排查。您可以回溯查看的时长取决于您的套餐：请参阅[审计日志](https://docs.didit.me/zh/console/audit-logs.md#数据保留)。

***

## 数据最小化存储

我们正在新增相关功能，允许您**仅保留选定的数据字段**，例如保留 `status` 和 `vendor_data`，同时自动清除图像和证件等较大的附件。这为遵循数据最小化原则的团队提供了更严格的控制。

> [!TIP]
>
> 想要提前体验附件级保留规则？请联系您的 Didit 客户代表。

***

## 常见问题

> [accordion] 我可以为不同环境设置不同的保留策略吗？
>
> 可以。您可以为 Didit 中的每个应用分别配置不同的保留策略。

> [accordion] 删除前可以导出数据吗？
>
> 可以。通过控制台或 API 导出会话数据，然后调用 Delete Session endpoint。

> [accordion] 已删除的用户还会被识别为重复用户吗？
>
> 仅当您在删除其会话之前启用了生物特征模板保留时才会。默认情况下，人脸特征向量会随会话一并删除，该用户可以再次验证，且不会被标记为重复。请参阅[生物特征模板保留](#生物特征模板保留)。

> [accordion] 在哪里可以查看谁访问了什么？
>
> 在控制台中使用 **审计日志**（**Settings > Organization > Audit log**）。可按用户、端点或日期范围筛选。您可以回溯查看的时长取决于您的套餐：请参阅[审计日志](https://docs.didit.me/zh/console/audit-logs.md#数据保留)。

***

## 实施清单

**1. 配置保留策略**

在 **Console → App Settings → Data retention** 中设置您的保留策略。

**2. 订阅 Webhook**

设置 [Webhook](https://docs.didit.me/zh/integration/webhooks.md) 并验证签名。

**3. 持久化最少字段**

仅存储您的业务所需的字段。

**4. 实现程序化删除**

如果您使用处理后清除模式，请调用 [Delete Session](https://docs.didit.me/zh/sessions-api/delete-session.md) API。

**5. 确认处理地区**

在 **Application settings > Data and privacy** 中检查您应用的数据位置（默认为欧盟，企业客户可选择本国境内）。

**6. 分离环境**

为沙盒与生产环境分别使用独立的 API 密钥，并配置各自独立的保留策略。定期轮换密钥。


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