> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# ID認証方式をDiditコンソールで設定する

> Diditコンソールでは、国ごとに使える3つのID認証方式を選び、フォールバックのスイッチを設定できます。セッションで実際に使われた方式も確認できます。

ワークフロー内の[本人確認](https://docs.didit.me/ja/core-technology/id-verification/verification-methods.md)ステップには**Countries**タブがあります。ここでは、国ごとに3つの方法のうちどれをユーザーが利用できるか、また書類を使わない方法が成功しなかった場合にどうするかを設定します。このタブでの設定はすべて、本人確認ノードの[`methods`](https://docs.didit.me/ja/management-api/workflows/feature-configs#ocr-/-本人確認)キーに書き込まれます。コンソールとManagement APIは、同じオブジェクトを2通りに表示しているだけです。

## 国と利用可能なID確認方法

ワークフローを開き、**本人確認**ノードを選択して、**国**を開きます。各国の行には、その国で受け付ける方法が表示されます。国を選ぶと、その国のエディターが開きます。

| セクション | 設定内容 | 書き込まれる設定 |
| - | - | - |
| **書類の撮影** | 撮影した書類を受け付けるかどうか、およびその国で使える書類の種類、サブタイプ、撮影ルール | `document.enabled`, `documents_allowed` |
| **Non-doc lookup** | 書類なし照会を提供するかどうか、ユーザーが回答を送信できる回数、顔写真で裏付けられた一致の後にワークフローの以降のライブネス検知ステップと顔照合ステップをスキップするかどうか | `id_lookup.enabled`, `id_lookup.max_attempts`, `id_lookup.skip_liveness_and_face_match` |
| **受け入れるウォレット** | その国で提供するデジタルIDウォレット。優先順位ではなく許可リストです。エンドユーザーは、チェックを入れたものの中から選びます | `wallet.enabled`, `wallet.providers` |
| **Fall back to document capture when…** | 失敗の種類ごとに1つのスイッチ | `id_lookup.on_partial_match`, `id_lookup.on_no_match`, `id_lookup.on_provider_error`, `wallet.on_failure` |

その国で書類の撮影が無効な場合、**Fall back to document capture when…**のスイッチは常にオフになります。切り替え先がないためです。
これらのスイッチを使うには、その国で**書類の撮影**をオンにしてください。

すべての方法をオフにした国は、保存時に**No method enabled — nobody can verify here**というエラーで拒否されます。その設定では誰も認証できないためです。

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

**Fall back to document capture when…**(ウォレットと書類なし照会の設定と一緒に表示されます)の下にある**Offer document capture only as the fallback**スイッチを使うと、最初の画面に書類の撮影が表示されなくなります。
ユーザーはまずその国のウォレットまたは書類なし照会から始め、サインインに失敗した、サインインをキャンセルした、またはサインインがタイムアウトしたユーザーと、照会で一致しなかったユーザーだけが書類の撮影に進みます。
ウォレットが1つだけの場合、ユーザーはそのウォレットに直接移動します。
ウォレットや照会を書類の撮影と並べて表示する場合は、オフのままにしてください。

その国で書類の撮影がオフの間、またはどのフォールバックスイッチも書類の撮影にフォールバックするよう設定されていない間は、このスイッチは使用できません。
このスイッチをオンにすると、`document.fallback_only`が設定されます。

### 利用可否はサーバー側で決まります

このタブは、APIが検証に使うのと同じ機能カタログを参照します。そのため、プラットフォームが実際にサポートしているものだけが表示されます。

* その国でカタログが提供していない方法は、選択肢として表示されません。
* カタログで**近日公開**とされているソースやウォレットは、ロードマップを確認できるよう一覧に表示されますが、オンにはできません。
* ウォレットでのサインインは環境ごとに有効化されます。無効の間は、カタログの内容にかかわらず、すべてのウォレットが**近日公開**と表示されます。

### Smart-IDまたはMobile-IDを有効にする

Smart-IDとMobile-IDは、それぞれの対応国で利用できます。
対応国については[ウォレットカタログ](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md)を参照してください。
ワークフローを変更する前に、現在の環境に表示されている利用可否を確認してください。

1. **Workflows**を開き、対象のワークフローとその**本人確認**ノードを選択して、**国**を開きます。
2. 国のエディターを開き、**受け入れるウォレット**を探します。
3. **Smart-ID**または**Mobile-ID**は、利用可能な場合にのみ選択します。フォールバックを用意する場合は、書類の撮影を有効のままにしてください。
4. ウォレットでのサインインが失敗した場合の動作を選び、ワークフローを保存して公開します。
5. そのワークフローで新しい認証セッションを開始し、完了したセッションの**Credential**カードを確認します。

[Smart-IDとMobile-IDの連携ガイド](https://docs.didit.me/ja/core-technology/id-verification/smart-id-mobile-id.md)には、対応する国コードと、ユーザーに表示される照合コードのフローが記載されています。
ステージング環境やサンドボックスでのテストに成功しても、本番環境でウォレットが有効になるわけではありません。

### 想定されるリクエストとレスポンス

照会ソースまたはウォレットの**See details**を選ぶと、想定されるリクエストとレスポンスが表示されます。エンドユーザーに何を求めるかがわかりやすい言葉で示され、ソースが何を返すかも確認できます。各照会ソースは正確な名称で示されます。ほとんどの国では公的登録簿であり、一部の国では信用情報機関または居住記録のファイルです。ソースによってデータの出所と同意に関する要件が決まるためです。エンドユーザーには、レスポンスのフィールド、ソース名、料金は表示されません。

### 一括スイッチ

**Global settings**を使うと、ある方法をサポートしているすべての国でその方法をオンにできるため、36か国を1つずつ設定する必要はありません。ただし、国ごとのエディターの設定が優先されます。ある方法をグローバルでオンにしてから、使いたくない国だけでオフにできます。

## タブに表示される料金

書類の撮影の料金が表示されます。チェック1件あたり\$0.15です。書類なし照会には国ごとの料金が表示されます。料金カタログでまだ公開されていない料金は、見積もりとして示されるのではなく、タブ上でプレースホルダーと表示されます。ウォレットの行には、ウォレット、その対応範囲、利用可否が表示されます。

また、このタブには照会の各フォールバックスイッチが請求にどう影響するかも明記されるため、保存する前に設定のコストを確認できます。

* 登録簿が応答した場合は照会が請求されます。一致した場合も一致しなかった場合も対象です。さらにユーザーが書類の撮影に切り替えた場合は、その分も追加で請求されます。
* 照会の結果が返ってこなかった場合は請求されないため、障害時にかかるのは書類の料金だけです。
* フォールバックをオフにすると、該当するユーザーは却下され、それ以上の請求は発生しません。

## セッションの確認

セッション詳細の**ID検証**ブロックには、その結果を生成した方法を示すチップと、その方法の[保証レベル](https://docs.didit.me/ja/core-technology/id-verification/verification-methods.md#保証レベル)を示す2つ目のチップが表示されます。表示は**書類 / Documentary**、**書類なし照会 / Data match**、またはウォレット名と**Cryptographic**のいずれかです。

> [!NOTE]
>
> 書類以外の方法から書類撮影にフォールバックしたセッションは、**書類 / Documentary**のセッションとして表示されます。フォールバックが成功した場合に最初に試行された方法を、APIはまだ記録していません。[`fallback_from`](https://docs.didit.me/ja/reference/data-models#本人確認)に値が入るのは、その国の切り替え設定が`decline`で、かつセッションが却下された場合のみです。そのため、コンソールには「この方法を試し、次にあの方法を試した」という経緯を表示するための情報がありません。どの書類以外の方法が試行されたかを確認するには、セッションのチェック一覧を使用してください。

チップの下には、方法ごとにそれぞれの根拠が表示されます。

* **書類**：従来どおり、表面・裏面・セルフィーの画像、品質スコア、抽出されたフィールド、警告が表示されます。
* **書類なし照会**：**公的登録との照合**に、照合したすべてのフィールドについて、ユーザーが入力した値、照会先が保持していた値、**一致**・**部分一致**・**不一致**の結果が一覧表示されます。あわせて照会先の名称、照会日時、試行回数も表示されます。応答しなかった照会先は、フィールドの判定ではなくエラーとして独立した行に表示されます。照会先が顔写真を返した場合は、その顔写真とユーザーのセルフィーが顔スコアとともに並べて表示されます。
* **ウォレット**：**認証情報**カードに、ウォレット、その発行機関、認証情報の種類、ウォレットが示した保証レベル、検証日時、署名検証に成功したかどうか、ウォレットが共有した属性が表示されます。

照会先やウォレットが顔写真を共有しない場合、パネルは空の枠を表示する代わりにその旨を表示します。顔照合の対象となるものはなく、ワークフローにライブネス検知と顔照合が含まれている場合は、それぞれ独立したステップとして実行されます。

## 関連情報

* [本人確認の方法](https://docs.didit.me/ja/core-technology/id-verification/verification-methods.md)：3つの方法、フォールバック、請求
* [書類なし照会](https://docs.didit.me/ja/core-technology/id-verification/non-doc-lookup.md)：国ごとのフィールドと同意
* [デジタルIDウォレット](https://docs.didit.me/ja/core-technology/id-verification/digital-id-wallets.md)：ウォレットごとの属性と保証レベル
* [ワークフロー](https://docs.didit.me/ja/console/workflows.md)：ワークフローの作成と公開
* [ワークフロー機能の設定](https://docs.didit.me/ja/management-api/workflows/feature-configs.md#ocr-/-本人確認)：APIを使って同じ設定を行う


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.