> ## 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のエンティティは、ユーザーと法人の2種類です。KYCセッション、取引、書類、生体情報、リスクを1つのプロフィールに集約します。

Diditは、アプリケーション内で起こるすべてを、2種類の主要なエンティティタイプを軸に整理します。

| エンティティ | 表すもの | 紐付け先 |
| - | - | - |
| **ユーザー** | 個人 | ユーザー認証（KYC）セッション、顔の生体情報、取引（申請者/取引相手として）、ブロックリスト |
| **法人** | 法的主体（会社、LLC、個人事業主、ファンド） | 法人確認（KYB）セッション、役員、UBO、取引（申請者/取引相手として）、ブロックリスト |

すべての検証セッション、すべての取引、すべてのブロックリストのエントリを、エンティティに紐付けられます。紐付けると、エンティティは履歴、リスクシグナル、コンプライアンスの状態を時間をかけて集約する、永続的なプロフィールになります。

## エンティティとセッション

**エンティティ**と**セッション**は別のものです。

| 概念 | スコープ | 存続期間 | 例 |
| - | - | - | - |
| **セッション** | 1回の検証イベント | 1回のフロー（レビュー中は数分から数日） | 1回のKYC試行 |
| **エンティティ** | 永続的なプロフィール | ユーザー/法人がプラットフォーム上に存在する限り | 2年間に3回のユーザー認証（KYC）セッションを行った顧客「Jane Doe」 |

1つのエンティティに、再検証、再提出、追加のチェック、定期的な継続モニタリングなど、多数のセッションを持たせることができます。エンティティはその結果を集約します。

## 自動作成と手動での事前作成

エンティティは、次の3つの方法のいずれかで作成されます。

**1. セッションから自動作成**

`vendor_data`の識別子を指定してセッションを作成し、一致するエンティティがない場合、Diditはエンティティを自動的に作成します。これが最も一般的な方法です。

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "workflow_id": "wf_kyc_standard", "vendor_data": "user-42" }'
```

セッションが開始された時点で、`user-42`のユーザーエンティティが作成されます。

**2. Management APIで事前作成**

先にエンティティを作成し、それに対してセッションを開始します。最初の検証の前に、リスクシグナル（ステータス、タグ、カスタムメタデータ）を設定しておきたい場合に便利です。

```bash theme={null}
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "vendor_data": "user-42", "display_name": "Jane Doe" }'
```

**3. コンソールで作成**

コンプライアンスチームは、Business Consoleから直接ユーザーや法人を作成できます。手動でのオンボーディング、インポート、是正ワークフローに便利です。

## エンティティがすべてを結び付ける仕組み

`vendor_data`フィールドが、結び付けのキーです。セッションや取引に`vendor_data`を渡すと、Diditは一致するエンティティにそれを振り分けます。

```mermaid theme={null}
flowchart LR
    VD["vendor_data:<br/>user-42"] --> U[User entity]
    S1[User Verification (KYC) session #1] --> VD
    S2[User Verification (KYC) session #2] --> VD
    T1[Transaction #1] --> VD
    T2[Transaction #2] --> VD
    F[Face biometric] --> VD
    D[Documents] --> VD
    BL[Blocklist entry] --> VD
```

詳しくは、[`vendor_data`の紐付けガイド](https://docs.didit.me/entities/vendor-data-linking)を参照してください。

## エンティティでできること

ユーザーまたは法人のエンティティごとに、次のことができます。

| 操作 | 目的 |
| - | - |
| **作成/更新** | エンティティのプロフィールデータ（氏名、国、カスタムメタデータ）を設定または変更する |
| **ステータスの変更** | `ACTIVE`、`FLAGGED`、`BLOCKED`のいずれかにする。強制は今後のセッションと取引に反映されます |
| **生体情報の紐付け** | 1:N検索、重複検出、ブロックリスト登録のために、顔の参照画像をアップロードする |
| **KYC/KYBの履歴の確認** | エンティティに紐付くすべてのセッションを、機能ごとの結果とともに取得する |
| **取引履歴の確認** | エンティティが申請者または取引相手であるすべての取引を取得する |
| **ブロックリストへの追加** | このエンティティに関わる今後のセッションや取引をブロックする |
| **インポート/エクスポート** | CSVからエンティティを一括アップロードするか、外部のコンプライアンスツール向けにエクスポートする |
| **削除** | エンティティを削除する（履歴は監査のために保持されます） |

詳しい手順は、[ユーザー](https://docs.didit.me/entities/users/overview.md)と[法人](https://docs.didit.me/entities/businesses/overview.md)にあります。

## ユーザーと法人の関係

1人のユーザーを、1つまたは複数の法人に紐付けられます。これはKYBの中で自然に発生します。

* ユーザーは、ある法人の**取締役**であり、別の法人の**UBO**であることがあります。
* ユーザーのユーザー認証（KYC）セッションは、[主要関係者](https://docs.didit.me/business-verification/key-people.md)のフローを通じて、法人の法人確認（KYB）セッションに紐付けられます。

Diditはこれらの関係を保持します。法人エンティティを確認すると、紐付けられたすべてのユーザーが分かり、ユーザーエンティティを確認すると、関連するすべての法人が分かります。

## ライフサイクルとステータス

すべてのエンティティにはステータスがあり、新しいアクティビティに対してDiditがブロックを適用するかどうかを決めます。

| ステータス | 効果 |
| - | - |
| `ACTIVE` | 通常。セッションと取引は、ワークフローとルールの設定どおりに進みます |
| `FLAGGED` | セッションと取引は許可されますが、自動的に手動レビューに回されます |
| `BLOCKED` | セッションと取引は自動的に拒否され、新しいセッションは作成できません |

遷移とWebhookイベントについては、[エンティティのライフサイクル](https://docs.didit.me/entities/lifecycle.md)の全文を参照してください。

## 次のステップ

> **[ライフサイクル](https://docs.didit.me/entities/lifecycle.md)**
>
> すべてのエンティティの状態、遷移、ライフサイクルイベント。

> **[vendor\_dataの紐付け](https://docs.didit.me/entities/vendor-data-linking.md)**
>
> `vendor_data`がセッション、取引、エンティティを結び付ける仕組み。

> **[ユーザー](https://docs.didit.me/entities/users/overview.md)**
>
> ユーザーエンティティ、操作、コンソールのワークフローの詳細。

> **[法人](https://docs.didit.me/entities/businesses/overview.md)**
>
> 法人エンティティ、操作、コンソールのワークフローの詳細。

> **[エンティティのWebhook](https://docs.didit.me/entities/webhooks.md)**
>
> すべてのエンティティの変更をリアルタイムで通知するイベント。

> **[ブロックリスト](https://docs.didit.me/console/blocklist-users.md)**
>
> ブロックリストのエントリが、ユーザーおよび法人エンティティとどう連動するか。


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