--- title: Human Token description: セルフィーから安定した不透明な humanToken を導出します — 本人確認はユーザーの入力ではなく呼び出しの出力です。ユーザーが識別子を申告する必要はありません。 canonical: https://developer.unico.io/ja/human-token/ locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - Human Token **このページの内容Human Token 顔写真 1 枚だけで、ユーザーを唯一無二の人間として識別できます。シンプルで直感的、そして安全です。 **1 人の人間。1 つのトークン。常に。** Human Token は、政府発行書類を必要とせず、1 枚のセルフィーから各顔に固有のアイデンティティを作成します。そうした関係が存在しない場面でも、顧客が書類番号の共有を望まない場面でも役立ちます。必要なときはいつでも新たな認証を依頼し、トークンを比較してください。同じトークンは同じ人間を意味します。 これにより、次のことが可能になります： **リピートユーザーの検出と重複アカウントの防止**：1 つの顔に 1 つのトークン。公式書類なしで、登録・ログイン・アカウント復旧の各場面で重複アカウントや不正アカウントを特定します。 **Web、ネイティブ、または API 経由での統合**：セルフィー画像のみを入力として使用し、追加の書類データは不要です。 **他のシグナルとの組み合わせ**：必要に応じて、Human Token を他の capabilities と併用できます。 代表的なシナリオには、ディープフェイク攻撃（CAPTCHA や SMS を使わずに、各操作の背後に実在する本人がいることを確認）、複数アカウント、プロモーションや紹介制度の悪用、パスワードの復旧、新しいデバイスの認証、貸し倒れの削減があります。損失が出てからではなく、判断の前にリスクを確認してください。 ### 機能概要​ キャプチャされたセルフィーから、Human Token はその顔を一意に表す安定した不透明な生体認証識別子（`humanToken`）を生成します。ユーザーは識別子を申告する必要はありません — 本人確認は呼び出しの出力であり入力ではありません。照合が成功するたびに同じ `humanToken` が返されるため、将来のプロセスで、どのデバイスやセッションでも同じユーザーを認識することができます。 **Privacy by Design：** 事前のデータは一切不要で、顔写真は処理後に破棄できます。システムに残るのは顔ではなくトークンです。これにより、貴社と顧客の生体情報の露出を大幅に削減できます。 ### 入力​ 入力はセルフィーのみです。API Only フローでは、バックエンドがセルフィーを[プロセスの作成](/ja/human-token/api-reference/post-processes)のリクエストボディに `imageBase64` として送信します。Human Token Journey フロー（`humantoken` または `humantoken+revalidation`）では、セルフィーはジャーニー内でキャプチャされます。 品質キャプチャには SDK が必要ですAPI 経由で送信される画像が生体認証要件を満たすことを保証するには、お使いのプラットフォーム向けの [Unico SDK](/ja/human-token/integrations) を使用するか、[キャプチャ標準](/ja/human-token/additional-resources/capture-standard)に従ってください。Human Token はキャプチャ品質管理なしの任意の画像は受け付けません。 ### 想定されるレスポンス​ 結果は `data.humanToken` で返されます。`value` は識別子で、`state` はプロセスの進行状況を示します — 結果の準備ができると `PROCESS_STATE_FINISHED` になります。[プロセスの作成 › 結果の解釈](/ja/human-token/api-reference/post-processes#interpreting-the-result)を参照してください。 `humanToken` を生成できない場合Human Token が `humanToken` を生成しないシナリオは 1 つだけです。送信された画像から顔を識別できない場合 — 顔が検出されない、画像品質が低すぎる、または顔がキャプチャ標準の範囲外である（傾いている、横を向いている）場合です。[キャプチャ標準](/ja/human-token/additional-resources/capture-standard)に従うことがこれを防ぎます。 `humanToken` は安定した不透明な識別子です — 同じユーザーは常に同じ値に解決されます。後続の Human Token 呼び出しで同一人物を認識するために、ユーザーレコードと並べて保存してください。 ### API インテグレーション​ Human Token は Human API 上で動作します。バックエンドは[プロセスの作成](/ja/human-token/api-reference/post-processes)でプロセスを作成します。API Only フロー（`api+humantoken`、`api+liveness+humantoken` または `api+liveness+humantoken+revalidation`）では、同じレスポンスで `humanToken` が返されます。Human Token Journey フロー（`humantoken` または `humantoken+revalidation`）では、ユーザーがジャーニーを進め、バックエンドが[プロセスの取得](/ja/human-token/api-reference/get-process)で結果を取得します。 はじめに: [認証](/ja/human-token/get-started/authentication)を設定します — すべての呼び出しで、アクセスキーを `x-unico-accesskey` ヘッダーで送信します。 [プロセスの作成](/ja/human-token/api-reference/post-processes)でプロセスを作成し、`data.humanToken` を読み取ります。 必要に応じて、[プロセスの取得](/ja/human-token/api-reference/get-process)でプロセスを再取得します。 ### 利用可能な環境​ 必要な統合コンポーネントAPI Web最終更新 2026年10月21日**に