> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証クイックスタート：10分で初めてのサインイン

> サンドボックスアプリでDidit認証を有効にし、ホスト型ページでユーザーをサインインさせて、サーバー側でアクセストークンを検証する手順を説明します。

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

## 前提条件

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

## 手順

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

[Business Console](https://business.didit.me)で、アプリケーション切り替え機能を使って**Sandbox**アプリケーションを選択し、**Authentication**を開きます。

Sandboxアプリケーションでは、`http://localhost` のコールバックと、ソーシャルサインイン用のDiditテスト用認証情報を使用できます。また、一切課金されません。
Liveアプリケーションでは、代わりに**Products**ページからAuthenticationを有効にします。[アプリケーションの準備](https://docs.didit.me/ja/authentication/overview.md#アプリケーションを準備する)を参照してください。

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

**Authentication > Security and sessions > Redirect URLs and allowed origins**を開き、次を追加します：

| 項目 | 値 |
| - | - |
| Redirect URL | `http://localhost:3000/auth/callback` |
| Allowed origin | `http://localhost:3000` |

Diditは、登録済みのリダイレクトURLと文字単位で完全に一致する場合にのみ、ユーザーをそのURLに戻します。
許可するオリジンにより、ブラウザーはアプリケーションのDiditオリジンとの間でコードを交換できます。

![Didit Business Consoleにある「リダイレクトURLと許可するオリジン」カード。許可リスト、ブロックリスト、サインインURLの隣に表示されています。](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-redirect-urls.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=8bf9cdacf97580097f4e8c6bd242af6f)

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

**3. サインイン方法を有効にする**

**Authentication > Sign-in methods**を開き、**Email code**を有効にします。
新しいアプリケーションでは、すべての方法が最初はオフになっており、ホスト型ページには有効にした方法のみが表示されます。

必要に応じて**Passkeys**も追加できます。また、**Didit test credentials**を使ったソーシャルサインイン方法も追加できます。これは、独自のアプリがなくてもSandboxで動作します。
各方法の詳細は[サインイン方法](https://docs.didit.me/ja/authentication/sign-in-methods.md)を参照してください。

![Didit Business Consoleのサインイン方法ページ。ホスト型サインインページのカード、パスワードレスとパスワードの各方法、ホスト型ページのライブプレビューを表示しています。](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-in-methods.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=4f71ad0125f22dd8184ad837854ec8db)

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

**4. 公開可能キーをコピーする**

**Authentication > Developers**を開き、**Publishable key**をコピーします。
Sandboxアプリケーションでは、`pk_test_`から始まります。

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

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

```bash theme={null}
npm install @didit-protocol/auth
```

```ts auth.ts theme={null}
import { createDiditAuth } from "@didit-protocol/auth";

export const auth = createDiditAuth({
  publishableKey: "pk_test_...",
  redirectUri: "http://localhost:3000/auth/callback",
});

// Your sign-in button
export async function onSignInClick() {
  await auth.signIn({ returnTo: "/dashboard" });
}

// Run once on http://localhost:3000/auth/callback
export async function onCallbackPage() {
  const { session, returnTo } = await auth.handleRedirectCallback();
  console.log(session.email, session.vendorData);
  window.location.replace(returnTo ?? "/");
}
```

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

![パスキーボタンとメールアドレス・パスワード入力欄があるスマートフォン上のホスト型サインインページ](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-phone.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=842077ff63a6dcffc50b0f0542ab07e4)

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

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

`auth.getToken()`が返すアクセストークンを`Authorization`ヘッダーでバックエンドに送信し、保護されたリクエストのたびにバックエンド側で検証してください：

```ts server.ts theme={null}
import { verifyToken } from "@didit-protocol/auth/server";

export async function authenticate(request: Request) {
  const header = request.headers.get("authorization") ?? "";
  const token = header.startsWith("Bearer ") ? header.slice(7) : "";
  try {
    const claims = await verifyToken(token, { publishableKey: process.env.DIDIT_PUBLISHABLE_KEY });
    return { personId: claims.sub, vendorData: claims.vendor_data };
  } catch {
    return null;
  }
}
```

`verifyToken`は、発行者が公開している鍵を使ってES256署名を検証し、発行者と有効期限も確認します。
アクセストークンの有効期間は最長5分で、`auth.getToken()`が自動的に更新します。
他の言語では、[サーバーSDK](https://docs.didit.me/ja/integration/server-sdks/overview.md)または任意のJWTライブラリを使って同じトークンを検証できます。[トークンとJWKS](https://docs.didit.me/ja/authentication/tokens-and-jwks.md#サーバーでトークンを検証する)に示すとおりです。

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

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

![Didit Business Consoleのサインインページ。サインインの試行を、状態、ユーザー、方法、デバイス、場所、リスク、時刻とともに一覧表示しています。](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-sign-ins.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=3c79b4e120c911b732d738e52d1687c8)

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

サーバーでサインインのアクティビティを受け取るには、[Webhookの送信先](https://docs.didit.me/ja/integration/webhooks.md)で`auth.signup`と`auth.login`を購読してください。[イベントとWebhook](https://docs.didit.me/ja/authentication/events-and-webhooks.md)を参照してください。

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

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

## 次のステップ

> [card] [連携ガイド](https://docs.didit.me/ja/authentication/integration-guide.md)
>
> ホスト型の画面または独自の画面、トークンの保存、セッション、ステップアップ認証、トラブルシューティング。

> [card] [ReactとNext.js](https://docs.didit.me/ja/authentication/quickstarts/nextjs.md)
>
> コンポーネント、フック、HttpOnly Cookie、サーバー側の`auth()`。

> [card] [iOS、Android、React Native、Flutter](https://docs.didit.me/ja/authentication/quickstarts/ios.md)
>
> システムブラウザーを使ったネイティブサインイン、パスキー、保護されたストレージ。

> [card] [ボット対策](https://docs.didit.me/ja/authentication/bot-protection.md)
>
> ボットやアカウント乗っ取りを防ぐポリシーを有効にします。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.