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

ワークフロー内の本人確認ステップにはCountriesタブがあります。ここでは、国ごとに3つの方法のうちどれをユーザーが利用できるか、また書類を使わない方法が成功しなかった場合にどうするかを設定します。このタブでの設定はすべて、本人確認ノードのmethodsキーに書き込まれます。コンソールとManagement APIは、同じオブジェクトを2通りに表示しているだけです。

​

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

ワークフローを開き、本人確認ノードを選択して、国を開きます。各国の行には、その国で受け付ける方法が表示されます。国を選ぶと、その国のエディターが開きます。 その国で書類の撮影が無効な場合、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は、それぞれの対応国で利用できます。 対応国についてはウォレットカタログを参照してください。 ワークフローを変更する前に、現在の環境に表示されている利用可否を確認してください。

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

Smart-IDとMobile-IDの連携ガイドには、対応する国コードと、ユーザーに表示される照合コードのフローが記載されています。 ステージング環境やサンドボックスでのテストに成功しても、本番環境でウォレットが有効になるわけではありません。

​

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

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

​

一括スイッチ

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

​

タブに表示される料金

書類の撮影の料金が表示されます。チェック1件あたり$0.15です。書類なし照会には国ごとの料金が表示されます。料金カタログでまだ公開されていない料金は、見積もりとして示されるのではなく、タブ上でプレースホルダーと表示されます。ウォレットの行には、ウォレット、その対応範囲、利用可否が表示されます。 また、このタブには照会の各フォールバックスイッチが請求にどう影響するかも明記されるため、保存する前に設定のコストを確認できます。

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

​

セッションの確認

セッション詳細のID検証ブロックには、その結果を生成した方法を示すチップと、その方法の保証レベルを示す2つ目のチップが表示されます。表示は書類 / Documentary、書類なし照会 / Data match、またはウォレット名とCryptographicのいずれかです。 チップの下には、方法ごとにそれぞれの根拠が表示されます。

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

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

​

関連情報

• 本人確認の方法：3つの方法、フォールバック、請求
• 書類なし照会：国ごとのフィールドと同意
• デジタルIDウォレット：ウォレットごとの属性と保証レベル
• ワークフロー：ワークフローの作成と公開
• ワークフロー機能の設定：APIを使って同じ設定を行う