アーキテクチャ
関係する要素は4つあります。
DiditのAPIキーもシークレットも、決してアプリに含めてはなりません。公開可能キーは公開される前提のキーであり、コード交換はクライアントシークレットではなくPKCEによって保護されます。
ホステッドページか独自の画面か
メールアドレス、パスワード、コードを入力する場所を選択します。 設定はsign_in_ui で、既定値は hosted です。own を指定することもできます。設定はいつでも変更できます。
パスキーは、アプリケーションのサインインオリジンに紐づきます。
SDKのパスキーメソッドは、そのオリジンから配信されたページでのみ動作します。そのため、別のドメインにある独自の画面でパスキーを使う場合は、ユーザーをホステッドページに誘導してください。
SDKの選び方
SDKを使わない場合は、PKCE付きの認可コードフローを自前で実装してください。JavaScriptクイックスタートに、仕様全体が示されています。
バックエンドを保護する
フロントエンドでのセッション確認が制御できるのは、表示する内容だけです。 バックエンドは、すべての判断を検証済みのトークンに基づいて行います。- すべてのリクエストでアクセストークンを検証してください。 発行者のJWKSに対してES256署名を確認したうえで、
iss、aud、exp、typ: at+jwtを確認してください。actがnullではないトークンは、そのルートがAIエージェントを受け付ける場合を除き、拒否してください。詳しくはサーバーでトークンを検証するをご覧ください。 - 機密性の高い操作の前に、現在有効なセッションを確認してください。 アクセストークンは、期限が切れるまで有効です。その有効期間は最長5分間です。セッションが失効した場合、アイドル状態になった場合、期限切れになった場合、本人がブロックされた場合、またはセッションがMFAポリシーの要件を満たさなくなった場合、
GET /session/は直ちに失敗します。詳しくはセッションを確認するをご覧ください。 - 操作にリスクがある場合は、ステップアップ認証を要求してください。 支払い、新しい銀行口座の登録、メールアドレスや電話番号の変更の前に、本人が再検証を必要とするかどうかをDiditに問い合わせてください。バックエンドが自ら読み取った、
approvedのステップアップ結果に基づいてのみ処理を進めてください。詳しくは機密操作の前のステップアップをご覧ください。 vendor_dataは、検証済みのトークンから取得してください。 ブラウザが送信したフィールドから取得してはいけません。本人の認証と取引には、その値を使用してください。
セッション
有効期間はAuthentication > Security and sessionsで変更するか、アプリケーション設定からAPIで変更できます。

Authentication > Sign-ins > Active sessionsの画面です。各セッションにRevokeボタンがあります。
ネイティブアプリ
Didit はネイティブアプリへのリダイレクトを HTTPS リダイレクトでのみ行い、カスタムURLスキームは受け付けません。- iOS: リダイレクトを関連付けられたドメインにし、
apple-app-site-associationにwebcredentialsを記載してください。 - Android: リダイレクトを App Link にし、
assetlinks.jsonを用意してください。 - すべてのリダイレクトURLは、Web のコールバックと同様に Authentication > Security and sessions で登録してください。
PUT native-apps/ で登録してください。
Didit は、登録されたアプリを、サインインのオリジンで配信する apple-app-site-association と assetlinks.json に一覧として記載します。
MANAGEMENT_BASE はアプリケーションの管理APIのアドレスです。authentication スコープで write 権限を持つAPIキーで、この呼び出しを行えます。
この呼び出しは両方のリストを置き換えるため、両方を必ず送信してください。
アプリ側の設定は、iOS と Android のクイックスタートで確認できます。
本人確認とトランザクションモニタリングの連携
ユーザーごとにvendor_dataの値が1つあり、その値はトークンとセッションに含まれます。本人確認セッションを作成するとき、または取引を送信するときは、この値をvendor_dataとして使用してください。コンソールには、サインイン、本人確認、取引が同じユーザーとして表示されます。
- 登録時や支払いの前に再度、本人確認フローを構築せずに本人確認を行うには、検証済みの本人情報を使用します。
- サインインイベントは、イベントルールと不正対策の画面に自動的に送られます。同じサインインについて、独自に
auth.loginイベントを送信しないでください。 - サインインが成功しても、本人確認や取引が承認されることはありません。各製品の判定は、それぞれ個別に処理してください。
サインインイベントを受信する
Webhookの送信先を、必要なauth.*タイプ(auth.new_deviceやauth.account_lockedなど)に登録してください。
auth_event.event_idで重複を排除し、すべてのDiditのWebhookと同様に署名を検証してください。
すべてのタイプとペイロードについては、イベントとWebhookを参照してください。
既存ユーザーの移行
ユーザーがすでに別の ID プラットフォームや自社データベースにアカウントを持っている場合は、サインインを切り替える前にユーザーをインポートしてください。 提供元がパスワードハッシュを提供している場合は、それもインポートしてください。ソーシャルアカウントの連携はそのまま維持し、自社のユーザーIDはexternal_idとして保持します。これが各ユーザーのvendor_dataになります。
アプリのサインインをDiditに切り替えるまで、ユーザーにとって変わることはありません。
本番運用前のチェックリスト
- Productsページで、Liveアプリケーションの認証が有効になっていること。
- 本番用の
https://リダイレクトURLと許可するオリジンが、Liveアプリケーションに登録されていること。Liveアプリケーションはhttp://のアドレスを受け付けません。 - 各ソーシャルサインインの方法で、お客様自身のアプリのクライアントIDとシークレットを使用していること。Diditのテスト用認証情報は、サンドボックスでのみ動作します。
- 本番環境の設定に、Liveの公開キー(
pk_live_)とLiveの発行者が含まれていること。 - MFAポリシー、セッションの有効期間、アイドルタイムアウト、パスワードの長さ、サインアップポリシーが、希望どおりに設定されていること。アプリケーション設定を参照してください。
- ボット対策が有効になっており、漏洩パスワードチェックも有効になっていること。
- バックエンドがすべてのアクセストークンを検証し、重要な操作の前に
GET /session/を呼び出していること。 - ブランディング、ページのテキスト、利用規約とプライバシーポリシーのリンクが設定されていること。カスタムドメインを使用する予定がある場合は、ユーザーがパスキーを追加し始める前に有効化してください。
- 処理する
auth.*タイプについて、Webhookの送信先が購読していること。 - Liveアプリケーションで、サインアップ、再訪時のサインイン、キャンセル、パスワードを忘れた場合の再設定、MFA、セッションの有効期限切れ、サインアウト、取り消されたセッションをテスト済みであること。