メインコンテンツへスキップ
このクイックスタートでは、約10分でDidit Authenticationをエンドツーエンドで動作させることができます。 サンドボックスアプリケーションにコールバックを登録し、サインイン方法を有効にして、ホスト型サインインページでユーザーをサインインさせます。その後、お使いのサーバーでアクセストークンを検証し、コンソールでサインインを確認します。

前提条件

  • Diditアカウントと、サンドボックスアプリケーション。アカウントの作成は無料で、すべてのサンドボックスアプリケーションでは認証が有効になっています。
  • Node.js20以降と、http://localhost:3000で実行できるWebアプリ。

手順

1

サンドボックスアプリケーションを開く

Business Consoleで、アプリケーション切り替え機能を使ってSandboxアプリケーションを選択し、Authenticationを開きます。Sandboxアプリケーションでは、http://localhost のコールバックと、ソーシャルサインイン用のDiditテスト用認証情報を使用できます。また、一切課金されません。 Liveアプリケーションでは、代わりにProductsページからAuthenticationを有効にします。アプリケーションの準備を参照してください。
2

コールバックとオリジンを登録する

Authentication > Security and sessions > Redirect URLs and allowed originsを開き、次を追加します:Diditは、登録済みのリダイレクトURLと文字単位で完全に一致する場合にのみ、ユーザーをそのURLに戻します。 許可するオリジンにより、ブラウザーはアプリケーションのDiditオリジンとの間でコードを交換できます。
Didit Business Consoleにある「リダイレクトURLと許可するオリジン」カード。許可リスト、ブロックリスト、サインインURLの隣に表示されています。

Authentication > Security and sessionsの下にあるリダイレクトURLと許可するオリジン。

3

サインイン方法を有効にする

Authentication > Sign-in methodsを開き、Email codeを有効にします。 新しいアプリケーションでは、すべての方法が最初はオフになっており、ホスト型ページには有効にした方法のみが表示されます。必要に応じてPasskeysも追加できます。また、Didit test credentialsを使ったソーシャルサインイン方法も追加できます。これは、独自のアプリがなくてもSandboxで動作します。 各方法の詳細はサインイン方法を参照してください。
Didit Business Consoleのサインイン方法ページ。ホスト型サインインページのカード、パスワードレスとパスワードの各方法、ホスト型ページのライブプレビューを表示しています。

Authentication > Sign-in methods。ホスト型ページのライブプレビューを表示しています。

4

公開可能キーをコピーする

Authentication > Developersを開き、Publishable keyをコピーします。 Sandboxアプリケーションでは、pk_test_から始まります。公開可能キーは公開されており、アプリケーションのDiditサインインオリジンを指定します。 Secret keyをブラウザーやモバイルのコードに決して含めないでください。
5

SDKをインストールしてサインインする

auth.ts
ボタンをクリックすると、ホスト型ページでメールアドレスの入力を求められ、6桁のコードが送信されます。 コードを入力すると、Diditがユーザーをコールバックに戻し、コールバック側でワンタイムコードをセッションのトークンと交換します。 アカウントのないアドレスでの初回サインインでは、デフォルトのサインアップポリシーで誰でもサインアップできるため、アカウントが作成されます。
パスキーボタンとメールアドレス・パスワード入力欄があるスマートフォン上のホスト型サインインページ

スマートフォンで表示されるホスト型のサインインページです。有効にした方法のみが表示されます。

6

サーバーでトークンを検証する

auth.getToken()が返すアクセストークンをAuthorizationヘッダーでバックエンドに送信し、保護されたリクエストのたびにバックエンド側で検証してください:
server.ts
verifyTokenは、発行者が公開している鍵を使ってES256署名を検証し、発行者と有効期限も確認します。 アクセストークンの有効期間は最長5分で、auth.getToken()が自動的に更新します。 他の言語では、サーバーSDKまたは任意のJWTライブラリを使って同じトークンを検証できます。トークンとJWKSに示すとおりです。
7

コンソールでサインインを確認する

Authentication > Sign-insを開きます。 サインインは、結果、方法、デバイス、場所、リスクとともに一覧に表示されます。すべてのサンドボックスに最初から含まれているサンプルのサインインも並んで表示されます。 ユーザーはUsersに表示されます。
Didit Business Consoleのサインインページ。サインインの試行を、状態、ユーザー、方法、デバイス、場所、リスク、時刻とともに一覧表示しています。

Authentication > Sign-ins:すべての試行を表示します。状態、方法、リスクでフィルタリングできます。

サーバーでサインインのアクティビティを受け取るには、Webhookの送信先でauth.signupとauth.loginを購読してください。イベントとWebhookを参照してください。

本番公開前に確認すること

  1. Products ページで、本番環境のアプリケーションの Authentication を有効にします。
  2. 本番用の https:// リダイレクトURLとオリジンをここに登録します。本番環境のアプリケーションが受け付けるのは https:// のみです。
  3. Didit のソーシャルサインイン用テスト認証情報を、お使いのアプリのクライアントIDとクライアントシークレットに置き換えます。
  4. 本番環境の公開キー(pk_live_)を、本番環境の設定にコピーします。
  5. 本番公開前チェックリストを一つずつ確認します。

次のステップ

連携ガイド

ホスト型の画面または独自の画面、トークンの保存、セッション、ステップアップ認証、トラブルシューティング。

ReactとNext.js

コンポーネント、フック、HttpOnly Cookie、サーバー側のauth()。

iOS、Android、React Native、Flutter

システムブラウザーを使ったネイティブサインイン、パスキー、保護されたストレージ。

ボット対策

ボットやアカウント乗っ取りを防ぐポリシーを有効にします。
最終更新日 2026年11月22日