Human Plugin の仕組み
一度デプロイすれば、あとはバックエンドから呼び出すだけです。
- アクセスキーと PostgreSQL データベースを用意して、お客様のインフラストラクチャに Human Plugin をデプロイします。これで Unico のネットワークに接続されます。詳しくは お客様のインフラストラクチャで Human Plugin を実行する を参照してください。
- バックエンドから、いずれかのフロー、
clientId、一意のcorrelationId、そしてcredentialに本人のドキュメントを指定してプロセスを作成します。 - 結果を取得します。Human Token は本人が誰であるかを示し、インテリジェンスは、その人物がお客様の環境でこれまでに何を行ったかを示します。
すべてのレスポンスに含まれるもの
| フィールド | 意味 |
|---|---|
id | プロセス ID。GET /v1/processes/{id} で使用します |
state | PROCESS_STATE_CREATED、PROCESS_STATE_FINISHED、または PROCESS_STATE_FAILED |
data.humanToken | 本人が誰であるか。再検証の場合は data.humanTokenMatch |
data.ndocs | 本人のインテリジェンス |
ドキュメントは
credential で送信してください本人のドキュメントは credential にのみ指定します。Human Plugin はここに指定された値をお客様のインフラストラクチャ内に保持し、インテリジェンスの集計に使用します。
知っておくべきこと
- Human Plugin は呼び出し元を認証しません。バックエンドからのみ到達できるようにしてください。詳しくは ネットワークとセキュリティ を参照してください。
- プロセスの一覧取得、検索、削除を行うエンドポイントはなく、Webhook もありません。保留中のプロセ スは、読み取ったときに更新されます。