---
title: マルチアカウント
description: 事業者のベースに対して1:Nの生体認証検索を実行し、顔が別のアクティブなアカウントにすでにリンクされているかどうかを検出します。
canonical: https://developer.unico.io/ja/dual-api/capabilities/multi-accounts
locale: ja
generated_by: markdown-export
---

マルチアカウント は「この顔は事業者のベース内のどこかに既に存在するか？」を問います。

:::info[不正リスク分類の一部]
マルチアカウントは、[不正リスク分類](/capabilities/fraud-risk-classification)プロダクトのケイパビリティです。個別に契約するものではなく、Unico とのオンボーディング時に API Key の設定で有効化されます。
:::

### 機能の概要

事業者のベース内でセグメント化された1:Nの生体認証検索を実行し、受信した顔を同じ `clientReferenceSegment` に関連付けられたすべてのレコードと照合します。生体認証が既に別の `clientReference` にリンクされているかどうかを検出します — これは、同一人物が同一事業者で複数のアカウントを作成した、または作成しようとしていることを示します。

### 入力

- ユーザーのセルフィー — API 連携では `imageBase64` として送信します（PNG、JPEG、または WebP；最小 640×480；最大 800 KB）。Web 連携ではキャプチャは Unico が実行します。
- `clientReference`（API では `subject.clientReference`）— **必須**。事業者のシステムにおけるユーザーの一意の識別子：自社ベース内で一意、最大 256 文字、スペース不可。

### 考えられるレスポンス

| レスポンス | 意味 |
|---|---|
| `reproved` | マルチアカウントが検出されました。顔の生体認証が同一セグメント内の別の `clientReference` に既にリンクされています。 |
| `inconclusive` | マルチアカウントは検出されませんでした。顔は事業者のベース内の他のアカウントに登録されていません。 |

この表は、ケイパビリティの個別のレスポンスを表しています。

:::warning[`YES` または `NO` のレスポンスはありません]
マルチアカウント は `YES` または `NO` を**返しません** — 重複の不在は `inconclusive` として表されます。リスクが絶対に存在しないという確認ではありません。
:::

### 利用可能なサーフェス

| サーフェス | サポート |
|---|:-:|
| **SDK**（Android、iOS、Flutter） | ✅ |
| **Web**（iFrame、リダイレクト） | ✅ |
| **API**（ヘッドレス、SDK不使用） | ✅ |

どのサーフェスでも、このケイパビリティにはリクエスト内のユーザーの `clientReference` と、API Key での有効化が必要です。

:::tip[API の enum 値]
Web & Native コントラクトのレスポンスでは、マルチアカウントの結果は `authenticationInfo.accountFarmingResult` フィールドで返されます：マルチアカウントが検出された場合は `TRUST_RESULT_YES`、重複が見つからない場合は `TRUST_RESULT_NO` / `TRUST_RESULT_INCONCLUSIVE` です。これは専用のフィールドであり、別の不正リスク分類評価に対応する `authenticationInfo.identityFraudstersResult` と組み合わされることはありません。
:::

:::warning[API 連携：ライブネス]
API 連携では、ライブネスはオプションです。ライブネスチェックなしで画像を送信すると、1:N 検索は未検証のキャプチャ（例えば、写真を撮影した写真）に対して実行され、結果はそのリスクを引き継ぎます。同じプロセスでライブネスを有効化するか、[キャプチャ標準](/developers/sdks-and-tools/capture-standard)に従って Unico SDK でキャプチャすることを推奨します。
:::

### 検索スコープ

検索スコープは `clientReferenceSegment` フィールドによって制御されます。このフィールドはオンボーディング時に Unico が API Key に設定するもので、リクエストで送信するフィールドではありません。異なるセグメントは、誤検知を引き起こすことなく単一の事業者内で共存できます（B2B のサブクライアントや、個人アカウントと法人アカウントを持つモデルに有用です）。運用上、検索をセグメント化する必要がある場合は、Unico の担当者にご相談ください。

### このケイパビリティを使用する製品

- [マルチアカウント](/products/sign-up/multi-accounts)