メインコンテンツへスキップ
POST
Unico IDCloudの生体認証による検証では、ユーザーのセルフィーをそのCPFに登録されている顔と照合し、同一人物である、同一人物ではない、判定不能のいずれかを返します。DiditはこのサービスをPOST /v3/database-validation/で提供しているため、送信されたデータを公式の情報源と照合し、正規化された照合結果を受け取ることができます。

カバレッジ

  • カバレッジ: 96%
  • 国: ブラジル
  • サービスID: bra_unico_idcloud
  • データ領域: 本人情報
  • カテゴリ: BiometricRiskScore
ブラジルのCPF保有者の約96%が、Unicoのレジストリにある生体認証レコードに該当します。これは、政府の顔照合ソースであるDatavalidのカバレッジ(約50%)のおよそ2倍です。

入力

  • 必須の入力: tax_number、selfie
  • 任意の入力: first_name、last_name、full_name、date_of_birth、vendor_data
  • 同意: 必須
  • ワークフローでの利用: ワークフローで利用可能
  • カバレッジ: 96%
  • 料金: 成功したクエリ1件あたり$0.20

ボディパラメーター

string
デフォルト:"BRA"
必須
このデータベースサービスのISO 3166-1 alpha-3国コード。例:BRA
string
デフォルト:"bra_unico_idcloud"
必須
このサービスIDを含む配列。サービスを固定することで、リクエストの対象をこのデータベースだけに限定できます。例:bra_unico_idcloud
このサービスに対するエンドユーザーの明示的な同意。例:true
string
デフォルト:"11111111111"
必須
税務上の識別番号。例:11111111111
file
必須
生体認証によるデータベース検証のためにアップロードするセルフィー画像ファイル。対応形式:JPEG、PNG、WebP。例:@./selfie.jpg
string
検証する名。例:John
string
検証する姓。例:Doe
string
検証する法的な氏名。例:John Doe
string
YYYY-MM-DD形式の生年月日。例:1990-01-01
string
デフォルト:"user-1234"
この人物を示す、永続的なユーザー参照(社内のユーザーIDなど)。Diditはこれを使って単体のチェックを同じエンドユーザーに紐付け、重複検出のノイズを減らします。例:user-1234

入力ルールと検証に関する注意事項

  • ブラジルのCPF(11桁)
  • tax_numberは数字のみで構成する必要があります。リクエストを送信する前に、スペース、ハイフン、句読点を取り除いてください。
  • tax_numberはちょうど11文字である必要があります。

呼び出し方法

返されるデータ

source_dataに含まれる具体的なフィールドは、レジストリが返す内容によって異なります。bra_unico_idcloudの生成済みの例では、現在、次の正規化された形式が記載されています。
  • unico_face_match

料金とSLA

BRA - Unico IDCloud(CPF+セルフィー)のクエリは、Diditが検証ソースから確定的な結果を受け取った場合にのみ課金されます。
  • 呼び出し1件あたりの料金: $0.20 USD。
  • 請求: 成功したクエリごと。レジストリに接続できない場合、必須フィールドが欠けている場合、またはリクエストがソースに届く前に拒否された場合は課金されません。
  • レイテンシ: 通常、p95で2秒未満。
  • 可用性: Didit側で四半期あたり99.9%。下流のソースの可用性は国やデータセットによって異なります。

このデータソースについて

Unicoは、ブラジル最大の民間顔生体認証データベースを運営するブラジルのIDテック企業です。同社のIDCloudプラットフォームは10億件を超える顔エンベディングを保有し、毎月約3,500万件の新しい顔が追加されています。これらのデータは、ブラジルの5大銀行のうち4行を含む800社以上のブラジル企業のオンボーディングおよび再認証フローから提供されています。この規模が上記のカバー率を支えており、CPFで照会すると、ブラジルの成人の約96%について生体認証記録が見つかります。 DiditはUnicoと直接提携しているため、標準のデータベース検証APIを通じてIDCloudに照会できます。呼び出しごとの従量課金で、Unicoとの個別契約、最低利用量、オンボーディング手続きはいずれも不要です。 政府の登録データベースとの違い。 Diditはブラジル - CPF + 顔照合(Datavalid)も提供しています。これはSERPROの公式ソースであり、政府の登録データベースを信頼できる情報源として特に必要とする場合に適した選択肢です。それ以外のすべての用途では、確認可能な2つの観点からIDCloudの方が優れています。Datavalidのカバー率が成人の約50%であるのに対し、IDCloudは約96%に達します。また、ユーザーから提出された書類の顔写真ではなく、IDCloudが自ら管理する生体認証記録と照合するため、書類偽造とCPF盗用による不正の両方に強い耐性があります。さらに、1回の照会あたりの料金は半額未満です。

ブラジル向けの推奨フロー

ブラジルのほとんどのユースケースでは、書類の撮影はまったく必要ありません。ユーザーがCPFを入力し、ライブネス検知済みのセルフィーによって、そのCPFの本人であることを確認します。
1

CPFを収集する

テキスト入力は11桁のCPFのみです。書類の写真も、氏名や生年月日の手入力も必要ありません。このフローでは書類を読み取らないため、CPFの取得元を指定しない限り、DiditにはCPFを取得する手段がありません。セッション作成時にセッションのmetadataでCPFを送信し、それをデータベース検証ステップのtax_number入力にマッピングしてください。Business Consoleではステップの入力マッピング、ワークフローAPIではノードのdatabase_validation_field_sourcesで設定します。
そのうえで、各セッションをそのキーに値を入れて作成します。
マッピングがない場合もステップ自体は実行されますが、tax_numberが欠落していると報告され、レジストリへの照会は一切行われません。料金は発生せず、セッションのdatabase_validationsエントリにその理由が記録されます。
2

ライブネス検知付きでセルフィーを撮影する

同じワークフローにライブネス検知ステップを追加し、リスク許容度に合った方式を選択します。パッシブライブネス(ユーザーの操作は一切不要)、3Dフラッシュ、3Dアクション&フラッシュ(光のパターンを投影するアクティブ方式で、後者はさらにランダムなアクションを加えます)から選べます。Business ConsoleまたはワークフローAPIで、face_liveness_method(PASSIVE、FLASHING、ACTIVE_3D)を使って設定します。どの方式を選んでも、Diditが撮影ステップを表示し、実在する本人がその場にいることを確認します。これにより、保存済みの写真や画面の再生映像が送信されるのを防ぎます。
3

Unico IDCloudでCPFとセルフィーを検証する

セッションフロー内では、Diditがライブネス検知のセルフィーを自動的に再利用するため、画像を扱う必要はありません。CPFは上記のマッピングから読み取られます。続いてIDCloudが、その顔がCPFの持ち主のものかどうかを確認します。このステップに必要な入力はこの2つだけです。metadataでfull_nameやdate_of_birthも送信してマッピングした場合は、照合用としてUnicoに渡されますが、必須ではありません。
このCPFのみのフローは、Diditが撮影を行い、ライブネス検知のセルフィーをこのサービスに渡すセッションおよびワークフロー連携に適用されます。POST /v3/database-validation/を直接呼び出す場合、selfieは必須のファイル入力となり、画像はご自身で用意する必要があります。両方のモードについてはデータベース検証の概要を参照してください。
コスト: パッシブライブネスの場合、認証済みユーザー1人あたり約$0.30です(IDCloudへの照会が$0.20、ライブネス検知が$0.10)。アクティブ方式ではライブネス検知が$0.15となるため、約$0.35です。これらは定価であり、それぞれにプランの割引が適用されます。詳しくは料金を参照してください。 カバー対象外となる約4%へのフォールバック。 IDCloudがINCONCLUSIVEを返した場合、レジストリはそのCPFを利用可能な生体情報レコードに結び付けられなかったことを意味します。通常は、その人物がレジストリに登録されていないことが原因です。これは検証の失敗ではなく「回答なし」として扱い、完全な本人確認(書類の撮影と、書類の顔写真に対する顔照合)にフォールバックしてください。これにより全員を検証可能な状態に保ちつつ、書類検証の料金はごく一部の残りのユーザーにのみ発生します。 却下への対応。 BIOMETRIC_NO_MATCHは、レジストリが明確に不一致と判断したことを意味します。つまり、その顔はそのCPFの持ち主のものではありません。これは再試行を促すものではなく、強い否定的結果として扱ってください。ユーザーをそのまま書類撮影に誘導するのは、まさになりすましを図る者が望む経路です。書類は彼らが手元で用意できるものだからです。とはいえ、外見の変化、古いレジストリ写真、撮影品質の低さなどにより、本当の偽陰性も発生します。そのため、自動承認したりユーザーを行き止まりにしたりするのではなく、手動レビューに回してください。BIOMETRIC_IMAGE_UNUSABLEはこれとは異なり、セルフィーを読み取れなかっただけなので、新しいセルフィーを依頼してください。各結果がセッションにどう影響するかは部分一致・不一致時のアクションで設定でき、全一覧は結果コードを参照してください。 リピーターユーザー。 レジストリへの照会料金は一度だけで済みます。ユーザーがこのフローを通過すると、ライブネス検知のセルフィーがそのユーザーのvendor_dataに紐付けて保存されるため、後から生体認証(ライブネス検知と、保存された顔に対する顔照合)を使って$0.10で再検証できます。ライブネス検知の方式も同じく選択できます。なお、これはリピーターユーザー専用です。生体認証セッションには保存済みの顔(またはご自身で用意したportrait_image)が必要で、どちらもない場合はセッション作成時に失敗します。そのため、初回のユーザーは引き続き上記のフローを経由します。

関連情報

最終更新日 2026年11月1日