不正リスクレベル検出
ライブネスと行動アラートを組み合わせ、書類キャプチャや政府発行識別子なしに、実在の人物が登録を行っていることを確認します。
このユースケースが解決する課題
不正リスクレベル検出は、書類キャプチャや政府発行識別子による本人確認を必要とせず、単一のプロセス内で実在の人物が登録を行っていることを確認するという課題に対応します。
ライブネスと行動アラートを組み合わせることで、パイプラインはカメラの前に実在の人物がいることを確認し、同時にその顔がUnicoネットワーク内でリスクシグナルを持っているかどうかを確認します。結果として、書類データだけでなく行動上の信頼性に基づいたオンボーディング判断が可能になります。
このユースケースを使用する場面：
- 本人は正当であるが意図が不正であるという詐欺の被害を受けている場合。
- 合成IDを使用してアカウントを開設するID詐欺の試みを特定・ブロックする必要がある場合。
- 複数の機関にわたって複数のア カウントを開設してマネーロンダリングを行うマルアカウント攻撃を特定・ブロックする必要がある場合。
- ネットワーク内で突然の過剰活動を生成するユーザーを検出することでバーストアウト詐欺を軽減したい場合。
- ビジネスモデルが各個人にオペレーターごと（または国ごと）に最大1つのアクティブアカウントのみを保有することを要求している場合。
このユースケースを使用しない場面：
- 政府データベースに対する書類の静的整合性のみを確認する必要がある場合 → オンボーディングをご利用ください。
- この顔がオンボーディングを完了した顔と同一であるかどうかのみを確認する必要がある場合 → 確認 (1:1)をご利用ください。
関連するケイパビリティ
単一プロセス内で実行されるパイプライン：
| ケイパビリティ | フローにおける役割 |
|---|---|
| Liveness（オプション） | セルフィーが生きた人物のものであることを確認し、ディープフェイクやインジェクション攻撃を軽減します。行動分析前の入力の完全性を確保します。 |
| Risk Fraud Classification | 取引データ（顔、コード、履歴）をグローバルネットワーク履歴と照合します。統計モデルを適用して、その取引の最終的なリスクレベルを生成します。 |
前提条件
- Bearer トークン — クライアント認証情報によるOAuth2認証。認証を参照してください。
- APIKEY の有効化 — 行動分析権限を持つV3用に設定されたキー。環境を参照してください。
- 主キー（
subject.code） — 取引を実行している識別子：書類番号、メールアドレス、または電話番号。
リスクレベルの精度を 最大化する
リクエストとともにメタデータとコンテキストを送信することを強くお勧めします。これには登録データ（氏名、生年月日、性別、その他の情報）、email、phone、clientReference が含まれます。また、Livenessソリューションを使用すると、デバイスリスク、位置情報、および追加の行動シグナルで分析が強化されます。
ステップバイステップの実装
- Native
- Web
- API
ネイティブSDKによる統合 — Android、iOS、またはFlutter向けのUnico SDKを使用して、アプリ内でキャプチャが実行されます。
- SDKをインストールする — プラットフォーム向けのUnico SDK依存関係を追加します。Android、iOS、またはFlutterのセットアップガイドを参照してください。
- プロセスを作成する — 適切な
flow値 とユーザーの識別子を指定してプロセスの作成を呼び出します。返されたtokenを使用してSDKを初期化します。 - キャプチャを開始する — SDKがカメラUIをレンダリングし、デバイス上でライブネス検出を実行して、キャプチャされたペイロードを返します。
- 結果を照会する — プロセスの取得を呼び出してケイパビリティの結果を取得します。
- ビジネスルールを適用する — レスポンスフィールドを評価して承認、拒否、またはエスカレーションを行います。
iFrame、リダイレクト、またはネイティブ経由の統合 — UnicoがキャプチャUIをホストし、ポーリングで結果を受信します。
- プロセスを作成する — 適切な
flow値 とユーザーの識別子を指定してプロセスの作成を呼び出します。レスポンスにはuserRedirectUrlが含まれます。 - ユーザーをリダイレクトする — ユーザーを
userRedirectUrlに送信します。Unicoがキャプチャジャーニーをレンダリングします。ネイティブアプリではwebAppTokenを使用します。 - ユーザーがジャーニーを完了する — キャプチャ後、ユーザーは
callbackUriにリダイレクトされます。 - 結果を照会する — プロセスの取得を呼び出してケイパビリティの結果を取得します。
- ビジネスルールを適用する — レスポンスフィールドを評価して承認、拒否、またはエスカレーションを行います。
直接API統合 — Unico SDKまたはキャプチャ標準に従った独自のUIを使用してセルフィーをキャプチャし、Unico APIに直接画像を送信します。
- セルフィーのキャプチャ — プラットフォーム向けのUnico SDKを使用するか、キャプチャ標準に従ってライブネス要件を満たすセルフィー画像を取得します。
- プロセスの作成 — プロセスの作成を呼び出し、適切な
flow値, ユーザーの識別子とimagebase64としてのセルフィーを渡します。 - 結果の照会 — プロセスの取得を呼び出してケイパビリティの結果を取得します。
- ビジネスルールの適用 — レスポンスフィールドを評価して承認、拒否、またはエスカレーションを行います。
エラー処理
| コード | 説明 |
|---|---|
20807 | HD規格外の画像（最小640×480）。 |
20506 | Base64ファイルがサポートされている最大制限（800 KB）を超えています。 |
20507 | subject.code フィールドが無効です。 |
20510 | clientReference フィールドが無効です。 |
10201 | APIKEY ヘッダーが無効か、認証情報にリスクレイヤーの権限がありません。 |