テスト用APIサーバの用意

ここからハンズオン本編に入ります。本章はフロントエンド側の実装に集中したいので、認証API側は動作確認用の最小構成で用意します。実運用ではJWTなどでトークン発行・検証を行う専用のバックエンドサーバがある想定で、本章のAPIはそのサーバの代わりとして振る舞います。JWTの発行・検証といった認証サーバ側の内部実装は本章のスコープ外なので、APIコードはコピー&ペーストで動く形にとどめて、詳細解説は最小限にします。

1. サンプルプロジェクトの準備

本章専用のNext.jsプロジェクトを新規作成します。前章のプロジェクトに追記する方式ではなく、ログイン機能の実装だけに集中できる新しいプロジェクトを用意します。

任意の場所に frontend-login-demo フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した frontend-login-demo フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。

frontend-login-demo  ← このフォルダを作成

以下のコマンドを実行して、npm がインストールされていることを確認します。npx は npm に同梱されているため、npm のバージョンが確認できれば npx も利用できます。

npm --version

以下のように npm のバージョンが表示されれば、インストールは確認できています。

11.x.x

バージョンが表示されない場合は、Node.jsをインストールしよう を先に実施してください。

インストールが確認できたら、以下のコマンドを実行して、Next.jsプロジェクトの雛形をいま開いているカレントフォルダに生成します。

npx create-next-app@latest .

npx はローカルにインストールされていないコマンドをその場でダウンロードして実行するNode.js標準のツールで、create-next-app@latest の部分でNext.js公式スキャフォールディングツールの最新版を実行しています。直後の . は「カレントフォルダ(いま開いている frontend-login-demo)に生成する」ことを指定しています。

実行すると、create-next-app パッケージをその場で取得するために、以下のような確認が表示されることがあります。y を入力して Enter を押します。

Need to install the following packages:
create-next-app@16.x.x
Ok to proceed? (y)

続けて、以下の質問が表示されます。

  • Would you like to use the recommended Next.js defaults? → Yes, use recommended defaults を選択して Enter

Yes を選ぶと、TypeScript / ESLint / Tailwind CSS / App Router / Turbopack など、本章のハンズオンに必要な構成が一括で揃った状態で雛形が生成されます。

回答が終わると、依存パッケージのインストール・型生成・Gitリポジトリの初期化が自動で行われ、以下のような実行結果が表示されれば成功です(途中のインストールログは省略しています)。

✔ Would you like to use the recommended Next.js defaults? › Yes, use recommended defaults
Creating a new Next.js app in /path/to/frontend-login-demo.

Using npm.

Initializing project with template: app-tw

Installing dependencies:
- next
- react
- react-dom

...

Success! Created frontend-login-demo at /path/to/frontend-login-demo

Visual Studio Codeのサイドバーには、以下のような構成が表示されます。

frontend-login-demo/
├── app/
│   ├── favicon.ico
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx
├── public/
├── .gitignore
├── eslint.config.mjs
├── next-env.d.ts
├── next.config.ts
├── package-lock.json
├── package.json
├── postcss.config.mjs
├── README.md
└── tsconfig.json

続けて、以下のコマンドを実行して、開発サーバを起動し、初期状態の画面を確認します。

npm run dev

ブラウザで http://localhost:3000 を開き、以下のようなNext.jsの初期ページ(page.tsx の編集を促す案内が表示された画面)が確認できれば準備完了です。

開発サーバは以降のハンズオンの間も起動したままにしておきます。

2. 認証APIの実装

本章のフロントエンド実装から呼び出す先として、/api/login(ログイン)、/api/logout(ログアウト)、/api/me(現在のユーザ取得)の3つのRoute Handlerを用意します。冒頭で述べたとおり、このAPI側のコードは本章の学習対象ではありません。認証サーバがすでにある想定でフロント側の実装に入るための土台なので、以下のコードはそのままコピーして動作させれば問題ありません。

ユーザ情報とトークンを保持するモジュールを、app/lib/session-store.ts として作成します。Visual Studio Codeのエクスプローラーで app フォルダを右クリックして「新しいフォルダー」で lib を作り、その中に session-store.ts を作ります。

frontend-login-demo/
├── app/
│   ├── lib/                       ← このフォルダを作成
│   │   └── session-store.ts       ← このファイルを作成
│   └── ...
└── ...

作成した app/lib/session-store.ts に以下の内容を記述して保存します。

import { randomUUID } from "crypto";

export type User = {
  id: string;
  email: string;
  role: "user" | "admin";
};

type StoredUser = User & { password: string };

const USERS: StoredUser[] = [
  { id: "1", email: "alice@example.com", password: "password123", role: "user" },
  { id: "2", email: "admin@example.com", password: "adminpass", role: "admin" },
];

const globalForSessions = globalThis as unknown as {
  __sessions?: Map<string, User>;
};

const sessions =
  globalForSessions.__sessions ?? new Map<string, User>();

if (process.env.NODE_ENV !== "production") {
  globalForSessions.__sessions = sessions;
}

export function login(email: string, password: string): { token: string; user: User } | null {
  const found = USERS.find((u) => u.email === email && u.password === password);
  if (!found) return null;
  const { password: _pw, ...user } = found;
  const token = randomUUID();
  sessions.set(token, user);
  return { token, user };
}

export function getSession(token: string): User | null {
  return sessions.get(token) ?? null;
}

export function destroySession(token: string): void {
  sessions.delete(token);
}

このモジュールは、ユーザ一覧(USERS)とトークン→ユーザの対応表(sessions)をメモリ上に持ちます。認証サーバ側の内部実装(本来はJWTの発行・検証を行うところ)を、動作確認用に最小のロジックで再現しています。

sessions を globalThis に紐付けているのは、開発サーバ(npm run dev)ではファイル保存のたびにRoute HandlerとServer Componentそれぞれのモジュールが別々に再評価されて sessions の中身が消え、ログイン後に /dashboard へアクセスしても getSession が空を返してログイン画面に戻される事象が起きるのを防ぐためです。Next.jsの開発モードでメモリ上の状態を保持したいときによく使う書き方で、本番ビルド(NODE_ENV=production)ではこの分岐は無効になり、通常の Map として動きます。開発サーバを再起動すると sessions の中身は初期化される点は、後の動作確認時に頭に入れておきましょう。

続いてログインAPI(/api/login)を作ります。エクスプローラーで app フォルダを右クリックして「新しいフォルダー」で api/login を作り、その中に route.ts を作ります。

frontend-login-demo/
├── app/
│   ├── api/
│   │   └── login/         ← このフォルダを作成
│   │       └── route.ts   ← このファイルを作成
│   ├── lib/
│   │   └── session-store.ts
│   └── ...
└── ...

作成した app/api/login/route.ts に以下の内容を記述して保存します。

import { NextResponse } from "next/server";
import { cookies } from "next/headers";
import { login } from "@/app/lib/session-store";

export async function POST(request: Request) {
  const { email, password } = await request.json();

  const result = login(email, password);
  if (!result) {
    return NextResponse.json(
      { error: "メールアドレスまたはパスワードが正しくありません" },
      { status: 401 }
    );
  }

  const cookieStore = await cookies();
  cookieStore.set("token", result.token, {
    httpOnly: true,
    secure: process.env.NODE_ENV === "production",
    sameSite: "lax",
    path: "/",
    maxAge: 60 * 60,
  });

  return NextResponse.json({ ok: true });
}

このAPIは、session-store の login にメールアドレスとパスワードを渡し、成功すれば新しいトークンを httpOnly Cookie としてレスポンスに載せます。Cookie属性の意味は「Cookieの属性」で整理したとおりで、httpOnly: true でJavaScriptから触れなくし、sameSite: "lax" で他サイトからのPOSTには送らないようにし、secure は本番環境(HTTPS)でのみ有効にしています。

次に、現在ログイン中のユーザを返すAPI(/api/me)を作ります。エクスプローラーで app/api フォルダを右クリックして「新しいフォルダー」で me を作り、その中に route.ts を作ります。

frontend-login-demo/
├── app/
│   ├── api/
│   │   ├── login/
│   │   │   └── route.ts
│   │   └── me/           ← このフォルダを作成
│   │       └── route.ts  ← このファイルを作成
│   └── ...
└── ...

作成した app/api/me/route.ts に以下の内容を記述して保存します。

import { NextResponse } from "next/server";
import { cookies } from "next/headers";
import { getSession } from "@/app/lib/session-store";

export async function GET() {
  const cookieStore = await cookies();
  const token = cookieStore.get("token")?.value;

  if (!token) {
    return NextResponse.json({ error: "unauthenticated" }, { status: 401 });
  }

  const user = getSession(token);
  if (!user) {
    return NextResponse.json({ error: "invalid session" }, { status: 401 });
  }

  return NextResponse.json({ user });
}

Cookieから token を取り出し、session-store の対応表にあれば { user: { id, email, role } } を返し、なければ 401 を返します。フロント側では、この 401 を「未ログイン」と判定して扱います。

最後にログアウトAPI(/api/logout)を作ります。エクスプローラーで app/api フォルダを右クリックして「新しいフォルダー」で logout を作り、その中に route.ts を作ります。

frontend-login-demo/
├── app/
│   ├── api/
│   │   ├── login/
│   │   │   └── route.ts
│   │   ├── logout/       ← このフォルダを作成
│   │   │   └── route.ts  ← このファイルを作成
│   │   └── me/
│   │       └── route.ts
│   └── ...
└── ...

作成した app/api/logout/route.ts に以下の内容を記述して保存します。

import { NextResponse } from "next/server";
import { cookies } from "next/headers";
import { destroySession } from "@/app/lib/session-store";

export async function POST() {
  const cookieStore = await cookies();
  const token = cookieStore.get("token")?.value;
  if (token) {
    destroySession(token);
  }
  cookieStore.delete("token");
  return NextResponse.json({ ok: true });
}

Cookieに入っているトークンを対応表から消し、続けてブラウザ側のCookieも削除します。これで完全にログアウト状態になります。

3つのAPIが揃ったので、フロントを繋ぐ前に curl で動作を確認しておきます。Visual Studio Codeで新しいターミナルを開き、まずログインを試します。

curl -i -X POST http://localhost:3000/api/login \
  -H "Content-Type: application/json" \
  -d '{"email":"alice@example.com","password":"password123"}'

以下のような実行結果が表示されます。

HTTP/1.1 200 OK
Set-Cookie: token=xxxx-xxxx-xxxx-xxxx; Path=/; Expires=...; HttpOnly; SameSite=lax
Content-Type: application/json

{"ok":true}

レスポンスヘッダに Set-Cookie が付き、その属性に HttpOnly と SameSite=lax が含まれていれば、ログインAPIが正しく動いています。{"ok":true} が返っていればログイン処理も成功しています。