> ## 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 がユーザーエンティティにブロックを適用する仕組みを解説します。識別子の種類（顔、書類、メール、電話番号、vendor_data）、自動ブロックリスト登録、手動ブロックリスト登録に対応しています。

ブロックリストは、コンプライアンスチェックに不合格となったユーザーが新しいセッションを作成したり、新しい取引を実行したりすることを防ぎます。Diditは**識別子タイプ**ごとのブロックリストに対応しているため、同じ不正行為者を複数のデータポイント（顔、書類、メールアドレス、電話番号、ユーザーのvendor\_data）にわたってブロックできます。

## ユーザーでサポートされる識別子タイプ

| タイプ | キー | 一致する条件 |
| - | - | - |
| 顔 | `FACE` | 新しいセッションのライブネス用セルフィーが、ブロックリストに登録された顔と一致する |
| 書類番号 | `DOCUMENT` | 新たに提出された身分証明書の番号が、ブロックリストに登録された書類番号と一致する |
| メールアドレス | `EMAIL` | 新しいセッションまたは取引で、ブロックリストに登録されたメールアドレスが使用される |
| 電話番号 | `PHONE` | 新しいセッションまたは取引で、ブロックリストに登録された電話番号が使用される |
| IPアドレス | `IP_ADDRESS` | 提出者のIPが一致する。単一のIP（`1.2.3.4`）とCIDR範囲（`10.0.0.0/8`）に対応 |
| デバイスフィンガープリント | `DEVICE_FINGERPRINT` | 提出者のデバイスフィンガープリントが一致する |
| ユーザー | `USER` | セッションまたは取引で、ブロックリストに登録された`vendor_data`が使用される |

各識別子タイプは、それぞれ適切なタイミングで適用されます。

* 顔と書類: 新しいセッションの実行中に適用されます。
* メールアドレスと電話番号: それらを収集するセッションのステップ、または取引のペイロードで適用されます。
* IPとデバイス: セッション内のデバイス・IP分析で適用されます。
* ユーザーのvendor\_data: セッションまたは取引の作成時に適用されます。

## ブロックリストへの登録方法

**1. 自動: セッションが却下された場合**

セッションが却下され、ワークフローの自動ブロックリスト設定が有効になっている場合、Diditは該当する識別子（顔、書類、メールアドレス、電話番号）を対応するシステムブロックリストに自動的に追加し、ユーザーのステータスを`BLOCKED`に変更します。

**2. 自動: ブロックリストに一致した場合**

受信したセッションが既存のブロックリストのエントリーと一致すると、そのセッションは`blocked_face`、`blocked_document`、`blocked_email`などの理由コードとともに自動的に却下されます。

**3. 手動: コンソールから**

アナリストが*Users → \[user] → Actions → Add to blocklist*からユーザーをブロックリストに登録し、記録する識別子を1つ以上選択します。

**4. プログラム: Lists API経由**

[Lists API](https://docs.didit.me/ja/management-api/lists/overview.md)を使用すると、プログラムでエントリーを追加できます。これはコンソールが内部で使用しているものと同じAPIです。

## システムリストとカスタムリスト

すべてのアプリケーションには、Diditが自動管理する**システムブロックリスト**が識別子タイプごとに1つずつあります。これらの名前の変更や削除はできません。カスタムリストは、お客様が自由に作成し、名前を付け、適用範囲を設定できます。

| リスト | 作成者 | 説明 |
| - | - | - |
| System Face Blocklist | Didit | アプリケーションの正規の顔ブロックリスト |
| System Document Blocklist | Didit | 正規の書類番号ブロックリスト |
| System Email Blocklist | Didit | 正規のメールアドレスブロックリスト |
| System Phone Blocklist | Didit | 正規の電話番号ブロックリスト |
| System User Blocklist | Didit | ブロックされた`vendor_data`識別子 |
| カスタムブロックリスト | お客様 | 地域ごと、パートナーごと、リスクレベルごとなど、適用範囲を絞ったリスト |

## APIでユーザーをブロックリストに追加する

ブロックリストのエントリーを追加するには、[Lists API](https://docs.didit.me/ja/management-api/lists/overview.md)を使用します。`vendor_data`でユーザーをブロックするには、対応するブロックリストにUSERタイプのエントリーを追加します。

1. `entry_type=user`と`is_system=true`でフィルターして[すべてのリストを一覧表示](https://docs.didit.me/ja/management-api/lists/list.md)し、システムのUserブロックリストを見つけます。
2. そのリストに、`value`をユーザーの`vendor_data`に設定して[エントリーを作成](https://docs.didit.me/ja/management-api/lists/create-entry.md)します。

顔でユーザーをブロックする方法は、[顔と生体認証](https://docs.didit.me/ja/entities/users/faces-and-biometrics.md#ブロックリストに顔をアップロードする)を参照してください。メールアドレス、電話番号、書類、IPでブロックするには、対応するシステムブロックリストを使用し、`value`に適切な識別子を指定します。

## 実施フロー

```mermaid theme={null}
sequenceDiagram
    participant Client
    participant Didit
    participant Lists as Blocklist check
    participant Workflow
    Client->>Didit: POST /v3/session/ (vendor_data=user-42)
    Didit->>Lists: Does user-42 match a USER blocklist?
    Lists-->>Didit: Match found
    Didit-->>Client: Session auto-declined (reason: blocked_user)
```

顔と書類のブロックリストでは、チェックは検証ステップで行われます。

```mermaid theme={null}
sequenceDiagram
    participant User
    participant Didit
    participant Lists as Face Blocklist
    User->>Didit: Liveness capture
    Didit->>Lists: Embedding search
    Lists-->>Didit: Match similarity > threshold
    Didit-->>User: Session declined (reason: blocked_face)
```

## ブロックリストからの削除

* **コンソール**: *Blocklist → \[type] → row actions → Remove*。
* **API**: リストのUUIDとエントリーのUUIDを指定して、[エントリーの削除](https://docs.didit.me/ja/management-api/lists/delete-entry.md)エンドポイントを使用します。

エントリーを削除しても、ユーザーが自動的に`ACTIVE`に戻ることはありません。新しいセッションを許可したい場合は、`PATCH /v3/users/{vendor_data}/update-status/`を使用してステータスを変更してください。

## ブロックリストの監査証跡

ブロックリストへの追加と削除はすべて[監査ログ](https://docs.didit.me/ja/console/audit-logs.md)に記録されます。

* エントリーを追加した人（ユーザーのメールアドレス、または`'system'`、`'api'`）。
* 日時。
* 理由を説明する任意の`comment`。
* エントリーが自動的に生成された場合は、関連するセッションまたは取引。

## 次のステップ

> [card] [Lists API](https://docs.didit.me/ja/management-api/lists/overview.md)
>
> ブロックリスト/許可リストAPIの完全なリファレンスです。

> [card] [コンソールのブロックリスト](https://docs.didit.me/ja/console/blocklist-users.md)
>
> UIからブロックリストを管理します。

> [card] [顔と生体認証](https://docs.didit.me/ja/entities/users/faces-and-biometrics.md)
>
> 顔ブロックリストの仕組みを説明します。


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