メインコンテンツへスキップ
このガイドでは、本番環境におけるDidit Authenticationの連携が、最初のリダイレクトから本番稼働チェックリストまでどのように組み合わさるかを説明します。 まだユーザーのサインインを実装していない場合は、クイックスタートから始めてください。各SDKのコードについては、プラットフォームごとのクイックスタートを参照してください。

アーキテクチャ

関係する要素は4つあります。 DiditのAPIキーもシークレットも、決してアプリに含めてはなりません。公開可能キーは公開される前提のキーであり、コード交換はクライアントシークレットではなくPKCEによって保護されます。

ホステッドページか独自の画面か

メールアドレス、パスワード、コードを入力する場所を選択します。 設定は sign_in_ui で、既定値は hosted です。own を指定することもできます。設定はいつでも変更できます。 パスキーは、アプリケーションのサインインオリジンに紐づきます。 SDKのパスキーメソッドは、そのオリジンから配信されたページでのみ動作します。そのため、別のドメインにある独自の画面でパスキーを使う場合は、ユーザーをホステッドページに誘導してください。

SDKの選び方

SDKを使わない場合は、PKCE付きの認可コードフローを自前で実装してください。JavaScriptクイックスタートに、仕様全体が示されています。

バックエンドを保護する

フロントエンドでのセッション確認が制御できるのは、表示する内容だけです。 バックエンドは、すべての判断を検証済みのトークンに基づいて行います。
  1. すべてのリクエストでアクセストークンを検証してください。 発行者のJWKSに対してES256署名を確認したうえで、iss、aud、exp、typ: at+jwt を確認してください。act が null ではないトークンは、そのルートがAIエージェントを受け付ける場合を除き、拒否してください。詳しくはサーバーでトークンを検証するをご覧ください。
  2. 機密性の高い操作の前に、現在有効なセッションを確認してください。 アクセストークンは、期限が切れるまで有効です。その有効期間は最長5分間です。セッションが失効した場合、アイドル状態になった場合、期限切れになった場合、本人がブロックされた場合、またはセッションがMFAポリシーの要件を満たさなくなった場合、GET /session/ は直ちに失敗します。詳しくはセッションを確認するをご覧ください。
  3. 操作にリスクがある場合は、ステップアップ認証を要求してください。 支払い、新しい銀行口座の登録、メールアドレスや電話番号の変更の前に、本人が再検証を必要とするかどうかをDiditに問い合わせてください。バックエンドが自ら読み取った、approved のステップアップ結果に基づいてのみ処理を進めてください。詳しくは機密操作の前のステップアップをご覧ください。
  4. vendor_data は、検証済みのトークンから取得してください。 ブラウザが送信したフィールドから取得してはいけません。本人の認証と取引には、その値を使用してください。

セッション

有効期間はAuthentication > Security and sessionsで変更するか、アプリケーション設定からAPIで変更できます。
Didit Business ConsoleのActive sessions画面です。サインイン中のセッションを、デバイス、所在地、開始時刻、最終アクティビティ、終了時刻、Revokeボタンとともに一覧表示しています

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 で登録してください。
アプリでパスキーを使う場合は、アプリケーションのパスキーを共有するアプリを 認証管理API の 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に切り替えるまで、ユーザーにとって変わることはありません。

本番運用前のチェックリスト

  1. Productsページで、Liveアプリケーションの認証が有効になっていること。
  2. 本番用のhttps://リダイレクトURLと許可するオリジンが、Liveアプリケーションに登録されていること。Liveアプリケーションはhttp://のアドレスを受け付けません。
  3. 各ソーシャルサインインの方法で、お客様自身のアプリのクライアントIDとシークレットを使用していること。Diditのテスト用認証情報は、サンドボックスでのみ動作します。
  4. 本番環境の設定に、Liveの公開キー(pk_live_)とLiveの発行者が含まれていること。
  5. MFAポリシー、セッションの有効期間、アイドルタイムアウト、パスワードの長さ、サインアップポリシーが、希望どおりに設定されていること。アプリケーション設定を参照してください。
  6. ボット対策が有効になっており、漏洩パスワードチェックも有効になっていること。
  7. バックエンドがすべてのアクセストークンを検証し、重要な操作の前にGET /session/を呼び出していること。
  8. ブランディング、ページのテキスト、利用規約とプライバシーポリシーのリンクが設定されていること。カスタムドメインを使用する予定がある場合は、ユーザーがパスキーを追加し始める前に有効化してください。
  9. 処理するauth.*タイプについて、Webhookの送信先が購読していること。
  10. Liveアプリケーションで、サインアップ、再訪時のサインイン、キャンセル、パスワードを忘れた場合の再設定、MFA、セッションの有効期限切れ、サインアウト、取り消されたセッションをテスト済みであること。

トラブルシューティング

最終更新日 2026年11月22日