メインコンテンツへスキップ

概要

ライブネスレポートには、カメラの前にいるのが印刷された写真、画面の再生映像、ディープフェイクではなく、実在する生身の人物であることを検証する過程でDiditが確認したすべての情報が記録されます。レポートには、ライブネス検知の方式、0〜100の信頼度スコア、基準となるセルフィーと撮影動画、オプションの年齢推定、パッシブライブネスの品質指標、そしてアプリケーションの履歴およびブロックリストに対するセッション横断の顔照合結果が含まれます。 レポートは、ユーザーがワークフロー内のライブネスステップを完了した後(またはスタンドアロンの顔エンドポイントを呼び出した後)に生成されます。Diditは3つのライブネス検知方式(アクティブ3D、フラッシュ、パッシブ)のいずれかを実行し、撮影データをスコアリングし、既知のなりすましパターンをスクリーニングしたうえで、その顔をアプリケーションでこれまでに確認した他のすべての顔と生体認証により照合します。 各レポートには、セッション全体のステータスとは独立した独自のstatusがあり、ライブネスステップ単体の判定結果を表します。
  • 承認済み:顔が検出され、ライブネススコアがレビューのしきい値を上回り、自動却下の警告が発生していない状態です。
  • レビュー中:レビューに振り分けられる警告が1つ以上発生したか、スコアがレビューのしきい値以下で却下のしきい値を上回っている状態です。
  • 却下:自動却下の条件(NO_FACE_DETECTED、LIVENESS_FACE_ATTACK、FACE_IN_BLOCKLIST、または年齢推定フローにおける年齢関連のリスク)が発生したか、設定可能な警告が却下に振り分けられたか、スコアが却下のしきい値以下である状態です。
  • 未完了:ユーザーがライブネスステップを完了していない状態です。

APIレスポンスでの表示箇所

ライブネスレポートは、GET /v3/session/{sessionId}/decision/のレスポンスにliveness_checks[]として含まれます。これは常にJSON配列であり、単一のlivenessオブジェクトになることはありません。ワークフローでライブネス検知が複数回実行される場合(たとえば最初のチェックと再撮影)には、複数のエントリーが含まれます。
  • セッション判定API:GET /v3/session/{sessionId}/decision/はトップレベルでliveness_checks[]を返します。セッション判定の取得を参照してください。
  • Webhook:ステップがデータを生成すると、session.status.updatedのペイロードに同じliveness_checks[]配列が含まれます。Webhookを参照してください。
  • スタンドアロンのライブネスAPI:ライブネスのスタンドアロンAPIを参照してください。
response.liveness_checks[0]を読み取り、配列を反復処理してください。一部の古いチュートリアルで言及されている単一のliveness形式は、v3の判定エンドポイントには存在しません。

スキーマ

フィールドごとの正式なスキーマは、データモデルリファレンスページに掲載されています。以下のフィールドは、その正式なスキーマと同じ内容です。

セッション横断の顔一致

matches[]には、アプリケーションの履歴にある顔のうち、このセルフィーとの生体認証による類似度がしきい値を超えたものが一覧表示されます。最大5件で、ブロックリストと許可リストに登録された顔が先に並び、その後は類似度の高い順に並びます。照合対象となるのは、ブロックリストに登録された顔、許可リストに登録された顔、Approvedのセッションの顔、およびベンダーユーザーに対してインポートされた顔です。同一ユーザーに属する顔(同じvendor_data、または利用可能な場合は同じベンダーユーザー)は、重複検出とブロックリストスクリーニングの両方を含む検索全体から除外されます。 各エントリには以下が含まれます。

ステータス値

ステータスは、共通の機能ステータス列挙型(FeatureStatusChoices)に基づきます。

例

承認済み: 問題のないACTIVE_3Dキャプチャ

レビュー中: パッシブライブネス、低品質なキャプチャと重複の可能性

この例では、顔画像品質(12.4)がデフォルトのレビューしきい値(15)を下回り、輝度(18.7)がデフォルトの最小値(20)を下回っています。さらに、ワークフローで重複する顔が検出された場合のアクションがReviewに設定されています。そのため、3つの警告すべてがlog_type: "warning"となり、レポートはIn Reviewになります。

セキュリティに関する注意

ライブネス動画とセルフィーは生体データです。署名付きURLは一時的なもので、有効期限があります(デフォルトでは4時間後に失効します)。短期間のみ有効なものとして扱い、キャッシュしたり公開したりしないでください。通常、アプリケーションに必要なのはstatus、score、および警告のみです。サーバー上の生体データを最小限に抑えるため、保存するデータはできる限り少なくしてください。

関連情報

最終更新日 2026年11月1日