cryptographicが付与されます。これは、IDプロバイダーが本人を認証し、返却した属性に署名したことを意味します。このレベルが示すのはそれだけです。他の2つのレベルと比べた順位づけではありません。他の2つのレベルは、同じものの多寡ではなく、異なる種類の証拠を表します。また、サインインにかかる時間はウォレット独自のフローによるもので、Diditが管理することも保証することもありません。
連携方法を選ぶ
アプリケーション側でインターフェースと認証ステップを管理する場合は、デジタルIDウォレットAPIを使用します。 各ウォレットには専用の開始エンドポイントがあり、結果取得、ポーリング、キャンセルのエンドポイントは共通です。 ワークフローを作成する必要はありません。 Diditのホスト型ウォレットジャーニー、ワークフローのルール、設定済みの書類によるフォールバックを利用する場合は、Sessions APIを使用します。 ウォレットの利用可否、必要なユーザーの承認、検証済みの本人属性は、どちらの連携方法にも適用されます。前提条件
各ウォレットを利用するには、以下に記載する発行者で有効なIDを保有し、その認証方法を利用できる必要があります。アカウントは要求された属性を取得できる必要があり、ユーザーはそれらの属性の共有に同意する必要があります。署名は発行者と返却されたクレームを検証するものであり、要求したすべての属性が含まれていること、最新であること、または貴社のコンプライアンスポリシーを満たすのに十分であることを保証するものではありません。顔写真を含まないウォレットでは、セルフィーとの照合は行われません。 カタログに登録されている25件すべてのウォレットを以下に記載しています。これにはBankIDを利用できる両国、ConnectID、Estonian ID-card、eParaksts mobileが含まれます。 設定済みの書類によるフォールバックでは、別途書類チェックが実行されます。 提供開始日は確約されていません。 これらはIDウォレットです。暗号資産ウォレットスクリーニングはブロックチェーンアドレスを金融リスクの観点でチェックするもので、別の製品です。料金
✅ 提供中は、本番環境で有効になっていることを意味します。 ⏳ 近日公開は、連携テストが始まっている場合でも、本番環境ではまだ有効になっていないことを意味します。 提供中のウォレットを先に表示しています。 料金列の要問い合わせは、ウォレットは利用可能であるものの公開されている一般向け料金がないことを意味します。無料で認証できるという意味ではありません。 以下の本人確認プロダクトについて、Diditの標準料金を完了したウォレット認証1件あたりのUSDで示しています。記載の料金にはウォレットによる本人確認が含まれており、公的eIDの取引手数料が別途加算されることはありません。組織ごとに合意した料金がある場合は、そちらが優先されます。
料金列の「近日公開」は、そのウォレットが提供予定であり、顧客向けの料金がまだ公開されていないことを意味します。認証が無料という意味ではありません。国旗はウォレットのカタログ上の対応範囲を示し、別にある提供状況の列は、現在有効化できるかどうかを示します。
料金が公開されていても、ウォレットが有効になるわけではありません。 上記の提供状況は本番環境のカタログに基づいています。近日公開と表示されたウォレットは、まだワークフローで選択できません。これらの料金は、提供開始時に適用されます。
- 認証済みのウォレットサインインは、ワークフロー内の本人確認ノードごとに1回、またはスタンドアロンのウォレットAPIでは認証リクエストごとに1回課金されます。 コールバックやステータス確認を繰り返しても、追加の課金は発生しません。
- キャンセル、期限切れ、拒否、または未完了のサインインには、ウォレット認証の料金は発生しません。
- ウォレットの料金は定価です。他のすべてのチェックと同様に、プランの割引が適用されます。
- 書類によるフォールバックは別のチェックであり、書類認証の料金に基づいて請求されます。ワークフロー内で完了したその他の機能については、別途請求されます。
ユーザーが行うこと
- IDステップで国を選び、貴社が許可したウォレットの中から1つを選択します。
- 銀行や政府ポータルにサインインするのと同じ方法で、そのウォレットでサインインします。
- 本人の属性情報を貴社と共有することを承認します。
- 認証が完了した状態で戻ります。
ウォレットは許可リスト
wallet.providersは、その国で提供できるウォレットのリストです。ランキングではありません。送信した順序には意味がなく、保存時にカタログの順序に正規化され、エンドユーザーは貴社が許可したウォレットの中から選択します。その国のウォレットを1つだけ有効にすることも、すべてを有効にすることもできます。どれを使うかはユーザーが選びます。
APIは、その国でカタログが提供していないウォレット、またはまだ近日公開のウォレットを有効にするワークフローを拒否します。
以下の各ウォレットの属性リストには、署名付きアサーションが含まれます。Diditはその署名を検証し、結果をセッションの
wallet_verification.signature_validとして報告します。アサーション自体は返されないため、取得または保存する参照はありません。On the sessionの列には、各属性についてどちらが得られるかが記載されています。対応ウォレット
利用可能なウォレットは、MitID、BankID Sweden、iDIN、Finnish Trust Network、Smart-ID、Mobile-IDです。 iDINは、オランダでの完全な本人確認に利用できます。 Smart-IDとMobile-IDは、以下のカタログに記載された国で利用できます。 Smart-IDとMobile-IDの対象国と要求される入力情報は実装済みの連携に基づくものであり、本番環境での提供可否は別途管理されています。 実装済みのSmart-IDとMobile-IDのルートについては、連携ガイドを参照してください。利用可否は機能カタログで管理されており、ここで手動管理されているものではありません。近日提供予定は、ウォレットがコンソールに表示されているものの、まだ有効にできないことを意味します。確定した提供日はありません。
エストニアIDカードとeParaksts mobile
両方式ともウォレットカタログに統合済みですが、本番環境では引き続き近日公開です。 本番環境のカタログで対応可能とされるまで、本番環境のワークフローで有効にすることはできません。 APIの識別子は、エストニア(EST)がidcard_ee、ラトビア(LVA)がeparaksts_mobileです。
利用可能になった場合の料金はいずれも完了した認証1件あたり$0.55です。ただし、料金が公開されていても本番環境へのアクセスが有効になるわけではありません。
- エストニアIDカード: ユーザーはスマートカードリーダーが接続されたコンピューターのブラウザで続行し、カードソフトウェアを通じてカードとPINで認証します。
- eParaksts mobile: ユーザーは本人認証用のサインインサービスに進み、有効なeParaksts mobileアカウントで承認します。 デスクトップのユーザーはQRコードをスキャンしてスマートフォンで続行でき、スマートフォンのユーザーはそのまま続行します。
ホワイトラベルはDiditの認証画面に適用されます。
これら2つの方式の外部認証画面では、各サービスのブランディングがそのまま維持されます。
カスタムロゴ、サービス名、ホワイトラベルのスタイル設定は、これらの外部画面には引き継がれません。
APIでこれらのウォレットを利用する
両方式とも、workflow_idを使わないスタンドアロンのAPI認証にも対応しています。
本番環境での利用可否はスタンドアロンAPIとワークフローで同じです。いずれかの方式をユーザーに提供する前にGET /v3/id-verification/wallets/を確認してください。
x-api-keyはバックエンドで保持し、アプリケーションの復帰先ホストをallowed_return_hosts設定に登録してください。
認証を開始する際は、そのホスト上のHTTPSのreturn_urlを送信します。
開始時のレスポンスでは、request_idと、ユーザーのブラウザ向けのwallet_verification.next_action.urlが返されます。
ユーザーをそのURLにリダイレクトし、カードまたはアプリで認証できるようにします。
ユーザーが戻ったら、バックエンドからGET /v3/id-verification/wallets/verifications/{request_id}/を取得して検証済みの結果を確認するか、署名付きのstatus.updatedのWebhookを処理してください。
ブラウザのリダイレクトだけを認証成功の証明として扱わないでください。
同じ料金と、完了した認証に対する請求ルールが、どちらの連携方法にも適用されます。
Google Wallet
Google Walletを使うと、W3C Digital Credentials APIを通じて、政府発行の身分証明書をスマートフォンからお客様のページやアプリに共有できます。 本番環境では近日公開です。サンドボックスのアプリケーションとステージングは現在利用でき、本番環境はGoogleの承認待ちです。- 対象国: 米国、英国、ブラジル、シンガポール、台湾。
- クレデンシャル: パスポートから作成されたGoogle Wallet IDパス、および対応している米国の州のモバイル運転免許証。
- 返される情報: 氏名、生年月日、書類番号、書類の有効期限、発行国と発行機関、およびIDパスの場合は国籍。
結果には、クレデンシャルの
signature_valid判定も含まれます。 顔写真は共有されません。 - プライバシー: Diditは必要なフィールドのみをリクエストし、ウォレットから送信されるのはそれらのフィールドのみです。 共有の承認は、本人が自分のデバイス上のGoogle Walletで行います。
allow属性にdigital-credentials-getを追加してください。追加しないと、ブラウザはiframe内でのウォレットリクエストを拒否します。
その他の今後対応予定のウォレット
ConnectID(オーストラリア)はサンドボックスでのテスト用に統合されており、ウォレットカタログにはconnectidとして表示されます。
本人はConnectIDセレクターで参加しているテスト銀行を選択し、その銀行でサインインして共有リクエストを確認します。
初期の本人情報バンドルでは、名、姓、生年月日に加え、認証用の取引参照番号をリクエストします。
住所、電話番号、メールアドレス、口座残高、取引履歴はリクエストしません。
共有通知には、Diditと、検証済みの本人情報を受け取る企業が明示されます。
銀行の認証情報は銀行側に保持されます。
本番環境へのアクセスは引き続き近日公開です。サンドボックスでのテストによって本番環境の本人確認が有効になることはありません。
有効化の前に、承認された本番環境のユースケース、顧客オンボーディング、必要な規約、認定を完了する必要があります。
表で近日公開とされているその他のウォレットも、本番環境では引き続き利用できません。
提供開始日は未定です。
保証レベル
ウォレットがeIDASの保証レベル(low、substantialまたはhigh)を提供する場合、Diditは実際に表明されたレベルを結果に記録します。
ConnectIDのようにeIDASレベルが指定されていないウォレットは、Not specifiedと表示されます。その連携はeIDAS保証を示すものではありません。
ウォレットが要求されたレベルより低いレベルを返した場合、サインインは暗黙のうちにレベルを下げることなく失敗します。
コンプライアンスルールが保証レベルに依存する場合は、セッションのwallet_verification.level_of_assuranceを確認してください。
ウォレット別リファレンス
MitID
mitid · 利用可能
Didit上で入力される情報: 氏名 · 生年月日 · CPRエイリアス(仮名化済み)
BankID
bankid_se · 利用可能
Didit上で入力される情報: 氏名 · 個人識別番号
iDIN
idin · 利用可能
Didit上で入力される情報: 氏名 · 生年月日 · 住所
Finnish Trust Network
ftn · 利用可能
Didit上で入力される情報: 氏名 · 個人識別コード
Smart-ID
smart_id · 利用可能
Diditで入力する情報: 個人識別コード
Mobile-ID
mobile_id · 利用可能
Diditで入力する情報: 個人識別コード · Mobile-IDの電話番号
BankID
bankid_no · 近日対応予定
Diditで入力する情報: 氏名 · 生年月日 · 国民識別番号
Vipps
vipps · 近日対応予定
Diditで入力する情報: 氏名 · 生年月日 · 国民識別番号
Buypass ID
buypass · 近日対応予定
Diditで入力する情報: 氏名 · 生年月日 · 国民識別番号
itsme
itsme · 近日対応予定
Diditに入力される情報: 氏名 · 生年月日 · 国民登録番号
Personalausweis
personalausweis · 近日提供予定
Diditに入力される情報: 氏名 · 生年月日 · 国籍 · 住所
Freja eID
frejaid · 近日提供予定
Diditに入力される情報: 氏名 · 生年月日 · 個人番号
UAE PASS
uae_pass · 近日提供予定
Diditに入力される情報: 氏名 · Emirates ID番号 · 国籍 · 顔写真
gov.br
govbr · 近日提供予定
Diditに入力される情報: 氏名 · CPF
OneID
oneid · 近日提供予定
Didit上で入力する情報: 氏名・生年月日
Google Wallet
google_wallet · 近日提供
Didit上で入力する情報: Didit上で入力する本人情報はありません
GOV.UK Wallet
govuk_wallet · 近日提供
Didit上で入力する情報: 氏名・生年月日・顔写真
エストニアIDカード
idcard_ee · 近日提供
Didit上で入力する情報: 氏名・生年月日・個人識別コード
eParaksts mobile
eparaksts_mobile · 近日提供
Diditに入力される情報: 氏名 · 生年月日 · 個人識別コード
Bank iD
bankid_cz · 近日対応予定
Diditに入力される情報: 氏名 · 生年月日
MojeID
mojeid · 近日対応予定
Diditに入力される情報: 氏名 · 生年月日
Diia
diia · 近日対応予定
Diditに入力される情報: 氏名 · 生年月日 · 顔写真
FranceConnect
franceconnect · 近日対応予定
Diditに入力される情報: 氏名 · 生年月日
Auðkenni
audkenni · 近日対応予定
Diditで入力する情報: 氏名・Kennitala
ConnectID
connectid · 近日提供予定
Diditで入力する情報: Diditでは本人情報を入力しません
EUDI Wallet
eudi · 近日提供予定
Diditに入力される情報: PID (個人識別データ)
失敗とフォールバック
verified以外の結果はすべて、その国のwallet.on_failureスイッチに従います。fallback_to_documentはユーザーを書類撮影に進め、declineは本人確認が却下となった状態でセッションを終了します。その国で書類撮影が無効になっている場合、fallback_to_documentはフォールバック先がないため、代わりに却下となります。
ウォレットのサインインに失敗した後にのみ書類撮影を表示する方法は、書類撮影をフォールバックとしてのみ提供するを参照してください。
請求対象となるのは完了したサインインのみです。放棄、キャンセル、タイムアウト、失敗したサインインには料金はかかりません。
セッションに記録される内容
attributesには検証済みのウォレットのクレームが格納され、その名前はウォレットによって異なります。
正規化された本人情報のフィールドには、本人確認結果のfull_nameとdate_of_birthを使用してください。
ウォレットごとの表では、これらの正規化されたフィールドとウォレット固有の属性を区別しています。portraitは顔写真を共有するウォレットの場合にのみ含まれます。signature_validは、ウォレットが返した署名付きアサーションの検証結果です。完了したサインインではtrueになります。検証に通らないアサーションはサインインを失敗させ、承認済みの結果を生成する代わりにwallet.on_failureに従って処理されます。
フィールドの型の詳細は本人確認のデータモデルにあります。
ウォレットの設定
これは、選択した国で、ご利用の環境のカタログにより選択したすべてのウォレットがavailableとされている場合にのみ使用する設定の一部です。
利用できないウォレットを送信すると、同じリクエスト内の他の方法も含め、ワークフロー全体の保存が拒否されます。
Smart-IDとMobile-IDの例については、連携ガイドを参照してください。
wallet.enabledがtrueの場合は少なくとも1つのウォレットを有効にしてください。そうしないと保存が拒否されます。詳細なリファレンスについては、ワークフロー機能の設定を参照してください。
関連ページ
- Finnish Trust Networkとの連携: フィンランド、銀行認証、書類によるフォールバック
- Smart-IDとMobile-IDとの連携: 対応国、照合コード、ワークフローの設定
- 本人確認の方法: 3つの方法、フォールバック、請求
- 書類を使わない照合: データ照合による方法
- コンソールでの本人確認の方法: 国ごとのウォレットの有効化