httpOnly Cookie のセッションまたは localStorage の JWT: Web アプリケーションに何を選択するか
質問は不正確です
Cookie と JWT の議論では、2 つの独立した解決策が混同されています。
- 1.クライアントがトークンを保存する場所: httpOnly Cookie (ブラウザ自体が送信する)、または
localStorage(JavaScript がそこから読み取り、Authorizationヘッダーに配置します)。 - 2.このトークンは何ですか: サーバーがデータベース内のエントリを検索するための、不透明なセッション ID、または自己完結型の署名付き JWT。
JWT は httpOnly Cookie に保存でき、セッション ID は localStorage に保存できます。したがって、各ソリューションを個別に分析します。
保存場所: XSS の結果
他の人のスクリプトがページ上で実行された場合 (脆弱な依存関係、エスケープされていないユーザー入力、侵害された分析スクリプト):
- `localStorage` のトークン。スクリプトは読み取ってサーバーに送信します。攻撃者は、被害者がタブを閉じた後でも、トークンが有効な間、自分のマシンからセッションを使用します。
- httpOnly cookie のトークンをスクリプトで読み取ることはできません。ページが開いている間、ユーザーに代わってリクエストを送信できます。XSS は依然として深刻な脆弱性です。ただし、セッションを盗んで持ち帰ることはできません。
違いは、Cookie が「XSS から保護する」かどうかではなく、被害の程度です。フロントエンドと API が同じサイト上にある Web アプリケーションの場合、Cookie を使用することで問題が解決されます。
クッキーの価格: CSRF
ブラウザは、別のサイトによって開始されたリクエストを含め、Cookie を自動的に送信します。複数の層による保護:
SameSite=Lax(Chromium ブラウザのデフォルトですが、明示的に設定) は、クロスサイト POST リクエストで Cookie を送信しません。- リクエストを変更する場合、サーバーは
Originヘッダーをチェックし、外部オリジンからのリクエストを拒否します。 - 状態の変更 - POST/PUT/PATCH/DELETE メソッドのみを使用し、GET は使用しません。
Next.js のサーバー アクションは Origin 自体をチェックします。独自のルート ハンドラーの場合は、チェックを書き込みます。
保存するもの: セッションのリコール
サーバーは、データベースにアクセスせずに、署名された JWT を検証します。欠点は、有効期限が切れる前に取り消すことができないことです。ユーザーが「すべてのデバイスでログアウト」をクリックし、管理者がアカウントをブロックし、盗まれたトークンが検出されました。JWT は引き続き機能します。回避策 (短い有効期間とリフレッシュ トークン、取り消されたリスト) により、JWT が欠落していることが選択されたストレージへのアクセスが戻ります。
サーバー セッションはテーブル内のエントリです。取り消し - 行を削除し、すぐに有効になります。リクエストごとにデータベースに 1 回アクセスすることは、ほとんどのアプリケーションでは認識されず、必要に応じてキャッシュされます。
サーバーセッションの実装
CREATE TABLE sessions ( id_hash bytea PRIMARY KEY, user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, expires_at timestamptz NOT NULL, created_at timestamptz NOT NULL DEFAULT now(), user_agent text ); CREATE INDEX sessions_user_idx ON sessions (user_id);
// lib/auth/sessions.ts
import "server-only";
import { createHash, randomBytes } from "node:crypto";
import { cookies } from "next/headers";
import { db } from "@/lib/db";
const COOKIE = "__Host-session";
const TTL_DAYS = 30;
const sha256 = (s: string) => createHash("sha256").update(s).digest();
export async function createSession(userId: string, userAgent?: string) {
const token = randomBytes(32).toString("base64url");
const expires = new Date(Date.now() + TTL_DAYS * 86_400_000);
await db.query(
"INSERT INTO sessions (id_hash, user_id, expires_at, user_agent) VALUES ($1, $2, $3, $4)",
[sha256(token), userId, expires, userAgent?.slice(0, 200) ?? null]
);
const jar = await cookies();
jar.set(COOKIE, token, {
httpOnly: true, secure: true, sameSite: "lax", path: "/", expires,
});
}
export async function currentUserId(): Promise<string | null> {
const token = (await cookies()).get(COOKIE)?.value;
if (!token) return null;
const { rows } = await db.query(
"SELECT user_id FROM sessions WHERE id_hash = $1 AND expires_at > now()",
[sha256(token)]
);
return rows[0]?.user_id ?? null;
}
export async function destroySession() {
const jar = await cookies();
const token = jar.get(COOKIE)?.value;
if (token) await db.query("DELETE FROM sessions WHERE id_hash = $1", [sha256(token)]);
jar.set(COOKIE, "", { httpOnly: true, secure: true, sameSite: "lax", path: "/", maxAge: 0 });
}主な詳細:
- データベースにはトークンではなくハッシュがあります。 ダンプのリークやテーブルへの読み取り専用アクセスでは、既製のセッションは提供されません。
- 暗号ジェネレーターからの 32 ランダム バイト - ブルート フォースは不可能で、署名は必要ありません。
- ログイン時の新しいセッション。古いセッションの権限を増やすのではありません。それ以外の場合、セッション固定が可能になります。攻撃者はログインする前に自分の識別子を被害者に伝えます。
- `cookies()` は Next.js 15 では非同期であるため、
awaitとなります。サーバー アクションとルート ハンドラーでは Cookie を設定できますが、サーバー コンポーネントのレンダリング時には設定できません。
「すべてのデバイスからログアウト」 - DELETE FROM sessions WHERE user_id = $1。 user_agent と日付を含むアクティブなセッションのリストは、このスキームの無料ボーナスです。
ヘッダー内のトークンが両端揃えの場合
- モバイル アプリケーションまたは CLI。 そこでは Cookie が不便です。トークンは
localStorageではなく、プラットフォームの安全なストレージ (キーチェーン、キーストア) に保存されます。 - サードパーティ クライアント用の API。 サードパーティ クライアントには、権限が制限された個別のキーまたは OAuth トークンが発行されます。
- サービス間呼び出し サービス間の有効期間の短い JWT は、共通の基盤なしで検証されるため、まさに便利です。
頻繁なエラー
- アクセストークンの有効期限が短い場合は、
localStorageのトークンを更新します。リフレッシュ トークンが盗まれると長期的なアクセスが可能になりますが、短期的なメリットはすべて失われます。 - セッションCookieの
Domain=.example.comは不必要です。脆弱なランディング ページを含むすべてのサブドメインがそれを受信します。__Host-接頭辞はDomain属性を無効にし、このオプションを閉じます。 - 署名検証なし、またはトークンヘッダーのアルゴリズムを使用して JWT の
expをチェックします。アルゴリズムをサーバーに記録します。
概要
独自のバックエンドを持つ Web アプリケーションの場合: httpOnly Cookie の不透明な識別子、データベース内のセッション レコード、SameSite=Lax、Origin を確認します。 JWT とヘッダー Authorization - 非ブラウザークライアントおよびサービス間の通信用。