本人確認方法：書類・データ照会・デジタルIDウォレット

本人確認は1つの機能で、3つの方法があります。どの国でどの方法を使用できるかはお客様が選択します。エンドユーザーには、エンドユーザーが選択した国に適用される方法が提示され、セッションには実際に結果を生成した方法が記録されます。

方法	ユーザーが行うこと	保証レベル
書類の撮影	パスポート、身分証明書、運転免許証、または在留許可証を撮影する	書類ベース
書類なし照会	国民ID番号といくつかの個人情報を入力し、政府機関またはその他の信頼できる情報源と照合される	データ照合
ウォレット	MitID、BankID、itsmeなど、政府または銀行が提供するデジタルIDでサインインする	暗号学的

書類の撮影は従来から変わりません。documents_allowedで設定済みの内容（受け付ける書類の種類、サブタイプ、撮影ルール、しきい値、警告）はすべてこれまでどおり動作し、方法について何も指定していないワークフローは引き続き書類の撮影のみとなります。

各方法の仕組み

書類の撮影

このセクションの以降で説明する方法です。ユーザーが書類を撮影し、Diditがそれを読み取って真正性を確認し、抽出したフィールドを返します。Diditが対応するすべての国で利用でき、料金はチェック1件あたり$0.15です。まずは本人確認の概要をご覧ください。

書類なし照会

ユーザーが国民ID番号といくつかの個人情報を入力し、Diditがその国の信頼できる情報源と照合します。書類の撮影は一切ありません。ほとんどの国ではその情報源は政府の登録簿ですが、すべての国がそうではありません。カナダ、フランス、インドネシア、オランダ、ノルウェー、シンガポール、英国、米国では、代わりに信用情報機関、金融サービス、公共料金、または居住記録に関するファイルが情報源となります。情報の出所と適用される同意の制度は情報源によって異なるため、正確な情報源は下の表と書類なし照会に国ごとに明記しており、一般化はしていません。情報源が顔写真を返す場合（現時点では南アフリカ、ナイジェリア、アルゼンチン、パナマで、4か国とも政府の登録簿）は、ユーザーにセルフィーも求められます。そのセルフィーに対してパッシブライブネス検知が実行され、登録簿の顔写真との顔照合が行われます。これらはすべて照会の中で行われ、照会の料金に含まれます。情報源がデータのみを返す場合は顔照合の対象がないため、セルフィーは撮影されません。必要な場合は、ライブネス検知と顔照合を独立したワークフローステップとして実行してください。国ごとのリクエストフィールド、形式ルール、同意の制度の詳細は書類なし照会を参照してください。

ウォレット

ユーザーは、国のeIDや銀行のIDなど、すでに保有しているデジタルIDでサインインします。ウォレットがユーザーを認証し、署名済みの本人属性をDiditに共有します。ウォレットによっては、ユーザーが個人識別コードや電話番号を入力する場合があります。ウォレットによるチェックでは書類の撮影は不要です。サインインの流れはウォレットによって異なり、アプリへの切り替え、QRコード、またはユーザーのスマートフォンで確認する照合コードのいずれかになります。 Smart-IDとMobile-IDは照合コードを使用します。ウォレットごとの属性、本番環境での利用可否、失敗時の挙動はデジタルIDウォレットを参照してください。

保証レベル

本人確認のすべての結果には、その結果を生成した方法から導かれる保証レベルが付与されます。このレベルは実際に何が証明されたかをありのままに示すもので、ランキングではありません。

レベル	セッションの値	意味
書類ベース	`documentary`	物理的な書類が撮影され、読み取られ、真正性が確認されました。
データ照合	`data_match`	ユーザーが入力した情報が、照会先の情報源が保持する記録と一致しました。書類は検査されていません。
暗号学的	`cryptographic`	デジタルIDプロバイダーがユーザーを認証し、共有した属性に署名しました。

保証レベルは管理者向けのラベルです。セッションのペイロード、コンソール、エクスポートに表示されます。エンドユーザーには、レベル、料金、照会した情報源の名前は一切表示されません。

国ごとの方法の設定

方法は、本人確認（OCR）機能設定のmethodsキーの下に、ISO 3166-1 alpha-3の国コードをキーとして設定します。キーを省略した場合、国を省略した場合、または国の中で方法を省略した場合、その国は書類の撮影のみになります。

{
  "feature": "OCR",
  "config": {
    "methods": {
      "ZAF": {
        "document": { "enabled": true },
        "id_lookup": {
          "enabled": true,
          "max_attempts": 2,
          "skip_liveness_and_face_match": true,
          "on_partial_match": "fallback_to_document",
          "on_no_match": "fallback_to_document",
          "on_provider_error": "fallback_to_document"
        },
        "wallet": { "enabled": false, "providers": [], "on_failure": "fallback_to_document" }
      },
      "DNK": {
        "document": { "enabled": true },
        "id_lookup": { "enabled": true, "on_no_match": "decline" }
      }
    }
  }
}

上記の両国は、公開カタログで照会するとavailableになっています。この例では、お使いの環境でウォレットが有効になっていることに依存しないよう、ウォレットを無効のままにしています。 近日公開と表示されたウォレットを有効にするワークフローは拒否され、その保存に含まれるほかの設定も拒否されます。カタログで、ある国のウォレットがavailableになると、その国のウォレットブロックは次のようになります。

{
  "DNK": {
    "document": { "enabled": true },
    "wallet": { "enabled": true, "providers": ["mitid"], "on_failure": "fallback_to_document" }
  }
}

送信する前にカタログを確認してください。前提条件として、そのウォレットがデジタルIDウォレットでその国についてAvailableと表示されている必要があります。保存時にAPIが適用する2つのルールは次のとおりです。

利用可否はサーバー側で決まります。 機能カタログでその国に対してavailableとされていない方法やウォレットは拒否されます。まずカタログを確認してください。コンソールのCountriesタブ、またはdidit_workflow_get_id_verification_methods_catalogのMCPツールで確認できます。
ウォレットは許可リストであり、ランキングではありません。 providersは、その国で提示できるウォレットを指定します。送信する順序には意味がなく、正規化されて失われます。選択するのはエンドユーザーです。

デフォルト値や検証を含むフィールドごとの完全なリファレンスは、ワークフロー機能設定を参照してください。

フォールバック: 書類以外の方法が成功しなかった場合

その後の動作は4つのスイッチで決まります。各スイッチの値はfallback_to_document(ユーザーを書類撮影に進める)またはdecline(本人確認を却下し、セッションを終了する)のいずれかです。4つすべてのデフォルトはfallback_to_documentです。

スイッチ	発動する条件
`id_lookup.on_partial_match`	登録機関から応答があったものの、一部のフィールドが一致しなかった場合。
`id_lookup.on_no_match`	登録機関から応答があり、一致するレコードが見つからなかった場合。
`id_lookup.on_provider_error`	登録機関に接続できなかった、または応答がなかった場合。
`wallet.on_failure`	ウォレットでのサインインがキャンセルされた、タイムアウトした、または失敗した場合。

id_lookup.max_attempts(1〜5、デフォルトは1)は、スイッチが発動するまでにユーザーに許可される、応答のあった照会の回数です。クライアント側の形式チェックで不合格となった番号は登録機関に送信されないため、試行回数を消費しません。ユーザーには番号の修正を求めるだけです。ウォレットやID照会から書類撮影へフォールバックできるのは、その国で書類撮影が有効になっており、かつ1種類以上の書類が受け付けられている場合に限られます。書類撮影が無効な場合、またはその国で受け付ける書類の種類がない場合は、スイッチがfallback_to_documentであっても、失敗したサインインや一致しなかった照会によってセッションは却下されます。フォールバック先が存在しないためです。却下された場合は、却下された本人確認にfallback_fromが記録され、失敗した方法とその理由が示されます。現在のステージング環境の実装では、フォールバック後に作成される書類認証にもこの証跡が引き継がれます。この追加の証跡を前提にする前に、本番環境への展開状況を確認してください。登録機関が応答しない場合(タイムアウトや障害)は例外で、それだけを理由にユーザーが却下されることはありません。その照会は請求されず、試行回数も消費されません。ユーザーには再試行を求めます。そのステップで応答のない照会が3回続くと、id_lookup.on_provider_errorが適用されます。declineの場合は却下され、fallback_to_documentの場合はユーザーが書類撮影に進みます。このスイッチがfallback_to_documentであっても、その国にフォールバック先の書類がない場合は、照会は開いたままとなり、ユーザーは引き続き試すことができます。セッションは却下されません。

書類撮影をフォールバックとしてのみ提供する

デフォルトでは、ウォレットまたはID照会と書類撮影の両方を提供する国では、最初の画面にそれらが並べて表示されます。 document.fallback_onlyをtrueに設定すると、その国で書類撮影を有効にしたまま、最初の画面では提示しないようにできます。ユーザーはその国のウォレットまたはID照会から開始します。ウォレットが1つだけの場合、ユーザーはそのウォレットに直接進みます。ウォレットでのサインインが失敗した、キャンセルされた、もしくはタイムアウトしたユーザー、または照会が一致しなかったユーザーのみが書類撮影に進みます。これらの結果のうちどれが書類撮影につながるかは引き続き上記のスイッチで決まるため、少なくとも1つはfallback_to_documentである必要があります。

{
  "FIN": {
    "document": { "enabled": true, "fallback_only": true },
    "wallet": { "enabled": true, "providers": ["ftn"], "on_failure": "fallback_to_document" }
  }
}

fallback_onlyは任意で、デフォルトはfalseです。 document.enabledがtrueであり、かつその国の少なくとも1つのウォレットまたはID照会が書類撮影にフォールバックする設定でない限り、この設定は拒否されます。フォールバックで提示する書類の種類をdocuments_allowedで有効にしてください。たとえばフィンランドであれば、パスポートとIDカードです。

各方法の料金

方法	料金
書類撮影	1回のチェックあたり$0.15
書類以外の照会	国と識別子ごとの公開USD料金

これらは定価であり、プランの割引は両方の方法に適用されます。照会には、実行するサービスに応じたデータベース検証の公開小売料金が使われ、1回の試行に複数のサービスが関わることもあります。ナイジェリアではNINまたはBVNのいずれかを選択します。国別の表には、設定された1回の試行の総額が記載されており、応答のあった再試行はそれぞれ別途請求されます。

請求ルール

登録機関から応答があった照会は請求されます。 一致、部分一致、不一致のいずれも対象です。照会が実行され、その応答自体が提供される成果だからです。
登録機関から一度も応答がなかった照会は請求されません。 プロバイダーエラーには料金は発生しません。
クライアント側の形式チェックで不合格となった番号は請求されず、max_attemptsの回数にも数えられません。登録機関に送信されていないためです。
ユーザーがフォールバックした場合、書類撮影の料金が追加で請求されます。 応答のあった照会の後に書類へフォールバックした場合は、2つのチェックが実行されたため、2件の請求となります。

対応範囲

書類撮影はDiditが対応するすべての国で利用でき、以下の表では繰り返し記載していません。料金はチェック1件あたり$0.15です。この表には、書類以外の方法が存在する国のみを記載しています。表に記載のない国、または「予定なし」と記載されたセルは、書類撮影のみの対応です。

国	コード	書類以外の照会	デジタルIDウォレット
アルゼンチン	`ARG`	提供中：RENAPER	予定なし
オーストラリア	`AUS`	予定なし	ConnectID（近日提供予定）
オーストリア	`AUT`	予定なし	EUDI Wallet（近日提供予定）
ベルギー	`BEL`	予定なし	itsme（近日提供予定）、Smart-ID（提供中）、EUDI Wallet（近日提供予定）
ボリビア	`BOL`	提供中：SEGIP	予定なし
ブラジル	`BRA`	提供中：Receita Federal	gov.br（近日提供予定）、Google Wallet（近日提供予定）
ブルガリア	`BGR`	予定なし	EUDI Wallet（近日提供予定）
カンボジア	`KHM`	提供中：内務省の有権者名簿	予定なし
カナダ	`CAN`	提供中：カナダの信用情報機関の記録（FINTRACデュアルプロセス）	予定なし
チリ	`CHL`	提供中：Servicio de Registro Civil e Identificación	予定なし
中国	`CHN`	提供中：NCIIC（National Citizen Identity Information Center）	予定なし
コロンビア	`COL`	提供中：Registraduría General de la Nación / ANI	予定なし
コスタリカ	`CRI`	提供中：Tribunal Supremo de Elecciones	予定なし
クロアチア	`HRV`	予定なし	EUDI Wallet（近日提供予定）
キプロス	`CYP`	予定なし	EUDI Wallet（近日提供予定）
チェコ	`CZE`	予定なし	Bank iD（近日提供予定）、MojeID（近日提供予定）、EUDI Wallet（近日提供予定）
デンマーク	`DNK`	提供中：CPR登録簿	MitID（提供中）、EUDI Wallet（近日提供予定）
ドミニカ共和国	`DOM`	提供中：Junta Central Electoral	予定なし
エクアドル	`ECU`	提供中：Registro Civil del Ecuador	予定なし
エルサルバドル	`SLV`	提供中：RNPN	予定なし
エストニア	`EST`	予定なし	Smart-ID（提供中）、Mobile-ID（提供中）、エストニアIDカード（近日提供予定）、EUDI Wallet（近日提供予定）
フィンランド	`FIN`	提供中：DVV人口登録簿	Finnish Trust Network（提供中）、EUDI Wallet（近日提供予定）
フランス	`FRA`	提供中：フランスの居住記録および公共料金記録	FranceConnect（近日提供予定）、EUDI Wallet（近日提供予定）
ドイツ	`DEU`	予定なし	Personalausweis（近日提供予定）、EUDI Wallet（近日提供予定）
ギリシャ	`GRC`	予定なし	EUDI Wallet（近日提供予定）
グアテマラ	`GTM`	提供中：SAT	予定なし
ホンジュラス	`HND`	提供中：CNE	予定なし
ハンガリー	`HUN`	予定なし	EUDI Wallet（近日提供予定）
アイスランド	`ISL`	予定なし	Auðkenni（近日対応）、EUDI Wallet（近日対応）
インド	`IND`	対応済み：UIDAI（Aadhaar）	予定なし
インドネシア	`IDN`	対応済み：住民記録を通じたインドネシアの住民登録	予定なし
アイルランド	`IRL`	予定なし	EUDI Wallet（近日対応）
イタリア	`ITA`	予定なし	EUDI Wallet（近日対応）
ケニア	`KEN`	対応済み：IPRS（Integrated Population Registration System）	予定なし
ラトビア	`LVA`	予定なし	Smart-ID（対応済み）、eParaksts mobile（近日対応）、EUDI Wallet（近日対応）
リヒテンシュタイン	`LIE`	予定なし	EUDI Wallet（近日対応）
リトアニア	`LTU`	予定なし	Smart-ID（対応済み）、Mobile-ID（対応済み）、EUDI Wallet（近日対応）
ルクセンブルク	`LUX`	予定なし	itsme（近日対応）、EUDI Wallet（近日対応）
マレーシア	`MYS`	対応済み：JPN（National Registration Department）	予定なし
マルタ	`MLT`	予定なし	EUDI Wallet（近日対応）
メキシコ	`MEX`	対応済み：RENAPO	予定なし
オランダ	`NLD`	対応済み：オランダの住民記録	itsme（近日対応）、iDIN（対応済み）、EUDI Wallet（近日対応）
ナイジェリア	`NGA`	対応済み：NIMC / NIBSS	予定なし
ノルウェー	`NOR`	対応済み：ノルウェーの住民記録	BankID（近日対応）、Vipps（近日対応）、Buypass ID（近日対応）、EUDI Wallet（近日対応）
パナマ	`PAN`	対応済み：Tribunal Electoral / SIB	予定なし
パラグアイ	`PRY`	対応済み：Registro del Estado Civil	予定なし
ペルー	`PER`	対応済み：RENIEC	予定なし
ポーランド	`POL`	予定なし	EUDI Wallet（近日対応）
ポルトガル	`PRT`	予定なし	EUDI Wallet（近日対応）
ルーマニア	`ROU`	予定なし	EUDI Wallet（近日対応）
シンガポール	`SGP`	対応済み：シンガポールの信用情報機関および公共料金の記録	Google Wallet（近日対応）
スロバキア	`SVK`	予定なし	EUDI Wallet（近日対応）
スロベニア	`SVN`	予定なし	EUDI Wallet（近日対応）
南アフリカ	`ZAF`	対応済み：Department of Home Affairs	予定なし
スペイン	`ESP`	予定なし	EUDI Wallet（近日対応）
スウェーデン	`SWE`	対応済み：Skatteverketの住民登録	BankID（対応済み）、Freja eID（近日対応）、EUDI Wallet（近日対応）
台湾	`TWN`	予定なし	Google Wallet（近日対応）
タイ	`THA`	対応済み：DOPAの住民登録	予定なし
ウクライナ	`UKR`	予定なし	Diia(近日公開)
アラブ首長国連邦	`ARE`	予定なし	UAE PASS(近日公開)
イギリス	`GBR`	利用可能:英国の信用情報機関および金融サービスの記録	OneID(近日公開)、Google Wallet(近日公開)、GOV.UK Wallet(近日公開)
アメリカ合衆国	`USA`	利用可能:米国の信用情報機関および金融サービスの記録	Google Wallet(近日公開)
ウルグアイ	`URY`	利用可能:Dirección Nacional del Registro de Estado Civil	予定なし
ベネズエラ	`VEN`	利用可能:CNE	予定なし
ザンビア	`ZMB`	利用可能:Zambia Revenue Authority	予定なし

対応状況はバックエンドが提供する機能カタログから生成されるため、この表はコンソールとAPIが検証に使用するものと同じソースです。近日公開は、その項目がコンソールに表示されているものの、まだ有効にできないことを意味します。現在利用できる機能ではなく、提供日も確定していません。

セッションに記録される内容

すべての本人確認の結果には、それを生成した方式、その保証レベル、そして書類以外の方式が実行された場合は方式ごとの証拠ブロックが含まれます。書類によるセッションは従来とまったく同じ内容で、新しいキーはnullになります。

フィールド	型	説明
`verification_method`	string	`document`、`id_lookup`または`wallet`。
`assurance`	string	`documentary`、`data_match`または`cryptographic`。
`wallet_provider`	string \| null	ウォレットが結果を生成した場合の、カタログ上のウォレットID。
`id_lookup`	object \| null	レジストリの証拠:参照元、確認日時、試行回数、フィールドごとの比較、レジストリの顔写真。
`wallet_verification`	object \| null	クレデンシャルの証拠:プロバイダー、発行機関、保証レベル、署名の有効性、共有された属性。
`fallback_from`	object \| null	書類以外の方式が失敗し、その国のスイッチによってセッションが却下された場合の`{ "method": ..., "reason": ..., "action": ... }`。ステージングでは、書類へのフォールバック後もこの値が保持されます。

3つの方式すべてについて、フィールドごとの型と例は本人確認のデータモデルに記載されています。同じキーはstatus.updated Webhookでも届きます。

認証

検証

モニタリング

プラットフォーム

本人確認方法：書類・データ照会・デジタルIDウォレット

各方法の仕組み

書類の撮影

書類なし照会

ウォレット

保証レベル

国ごとの方法の設定

フォールバック: 書類以外の方法が成功しなかった場合

書類撮影をフォールバックとしてのみ提供する

各方法の料金

請求ルール

対応範囲

セッションに記録される内容

関連情報

​各方法の仕組み

​書類の撮影

​書類なし照会

​ウォレット

​保証レベル

​国ごとの方法の設定

​フォールバック: 書類以外の方法が成功しなかった場合

​書類撮影をフォールバックとしてのみ提供する

​各方法の料金

​請求ルール

​対応範囲

​セッションに記録される内容

​関連情報

各方法の仕組み

書類の撮影

書類なし照会

ウォレット

保証レベル

国ごとの方法の設定

フォールバック: 書類以外の方法が成功しなかった場合

書類撮影をフォールバックとしてのみ提供する

各方法の料金

請求ルール

対応範囲

セッションに記録される内容

関連情報