ユーザーの生体認証：顔検索とブロックリスト

​

顔がユーザーに紐付く仕組み

​

顔検索 (1:N)

• オンボーディング時の重複検出：同一人物が2つのアカウントを作成するのを防ぎます。
• 逆引き検索：防犯カメラの映像のフレームや、不正調査で得た画像に写っているユーザーを特定します。
• リピーターの識別：再訪した顧客の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は最も大きな顔を抽出し、ユーザーに紐づく新しいFaceレコードとして保存します。
3. その顔は、プロフィールの証拠、重複検知、顔検索の対象として登録されます。今後照合で一致したセッションを却下することが目的の場合は、ブロックリストの画面を使用してください。

• オフラインで認証済みの顧客の顔写真が手元にある場合。
• 不正対策データベースにある既知の不正行為者をブロックリストに事前登録したい場合。

​

プライバシーとデータ保持

• 顔エンベディングは画像ではなく数値ベクトルです。画像そのものは暗号化されたオブジェクトストレージに保存され、署名付きURLでアクセスします。顔エンベディングは生体データです。
• 保持期間はアプリケーションのデータ保持ポリシーに従います。保持された生体認証テンプレートには、より厳格で期限が定められた生体認証テンプレートの保持期間が適用されます。
• セッションを削除すると画像が削除され、デフォルトではエンベディングも削除されます。アプリケーションで生体認証テンプレートの保持を有効にしている場合、セッションを削除しても、画像を含まないテンプレートが有効期限に達するか削除されるまで保持されます。
• GDPR / CCPAに基づく忘れられる権利の請求には、その人物のセッションをdeletion_instruction: "privacy_erasure"で削除するか、ユーザーを削除してください。どちらの方法でも、保持されたテンプレートもすべて完全に削除されます。管理している顔ブロックリストのエントリは、削除するまで残ります。

​

次のステップ