用户生物识别：人脸搜索与黑名单

​

人脸如何关联到用户

​

人脸搜索 (1:N)

• 注册时的重复检测：防止同一人创建两个账户。
• 反向查找：在欺诈调查中，通过 CCTV 画面或图片识别对应的用户。
• 回头客识别：为回头客跳过 KYC。

• POST /v3/face-search/：独立人脸搜索

​

重复检测

• 拒绝被标记为重复的会话。
• 标记待审核：转交人工分析师处理。
• 仅警告：允许通过，但添加风险标签。

​

人脸黑名单

​

将导入的人脸上传到用户资料

# 1. Create or retrieve the User keyed by your vendor_data
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "previous_provider": "legacy-kyc-vendor" }
  }'

# Response includes:
# { "didit_internal_id": "11111111-2222-3333-4444-555555555555", ... }

# 2. Upload the imported face to the User profile
curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/11111111-2222-3333-4444-555555555555/faces/upload/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-jpg-or-png>",
    "comment": "Imported from previous KYC provider"
  }'

​

黑名单的添加方式

​

将人脸上传到黑名单

​

从黑名单中移除人脸

​

会话删除后保留的生物特征模板

• 它仅包含数值化的人脸模板和保留元数据。它绝不包含人脸图像、活体视频、证件数据、提取的身份字段、决策结果，也不包含已删除会话的 ID。
• 它与在线会话中的人脸一样，参与重复检测、人脸搜索、生物识别认证以及您的人脸名单。命中结果会以 source: "retained_template"、用户的 vendor_user_id 和 vendor_data，以及 biometric_template_id 返回。
• 它属于生物识别数据，并带有有限期限，由 expires_at 指定。在以下任一情况下会被清除：删除该用户、使用 deletion_instruction: "privacy_erasure" 删除该用户的任一会话、模板到期，或您在 Lists → 生物特征模板 中手动清除，或通过生物特征模板 API 清除。
• 未包含 vendor_data 的会话没有可关联模板的用户。删除此类会话时会报告 ineligible_no_vendor_user，人脸特征向量会随会话一并删除。
• 保留的模板绝不会被加入黑名单。从已删除会话创建的人脸黑名单条目会保留其自身独立的生物识别条目及生命周期。

​

人脸生命周期摘要

​

从控制台上传人脸

1. 进入 Users → [user] → Actions → Upload face。
2. 选择图像，Didit 会提取最大的人脸，并存储一条与该用户关联的新人脸记录。
3. 该人脸将作为用户资料证据，并用于重复检测和人脸搜索。如需拒绝未来的匹配会话，请使用黑名单区域。

• 您已通过线下渠道核验某位客户，并持有其已知肖像。
• 您希望使用欺诈数据库中已知的恶意行为者预先填充黑名单。

​

隐私与保留

• 人脸特征向量是数值向量，而不是图像。图像本身存储在加密对象存储中，并通过签名 URL 访问。人脸特征向量属于生物识别数据。
• 保留期限遵循您应用的数据保留政策。被保留的生物特征模板则遵循更严格且有期限的生物特征模板保留期限。
• 删除会话会删除图像，默认还会删除特征向量。如果您的应用已选择启用生物特征模板保留，删除会话时会保留一个不含图像的模板，直至其到期或被清除。
• 对于 GDPR / CCPA 的被遗忘权请求，请使用 deletion_instruction: "privacy_erasure" 删除该人员的会话，或删除用户。两种方式都会同时清除所有保留的模板。您管理的人脸黑名单条目会一直保留，直至您将其移除。

​

后续步骤