TypeScript で NextAuth を使用しない Google OAuth 2.0: PKCE、state、nonce、secure next
私たちが構築しているもの
NextAuth を使用しない Google 経由のログイン: Next.js 15 の 2 つのルート ハンドラー、PKCE を使用した認証コード。 Start は state、nonce、および code_verifier を httpOnly Cookie に書き込みます。コールバックは state をチェックし、code をトークンに変更し、id_token をチェックして安全な next を導きます。
一般モジュール
// lib/oauth/google.ts
import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
import { createRemoteJWKSet, jwtVerify } from "jose";
export const AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth";
export const TOKEN_URL = "https://oauth2.googleapis.com/token";
const JWKS = createRemoteJWKSet(new URL("https://www.googleapis.com/oauth2/v3/certs"));
export const FLOW_COOKIE = "__Host-g_oauth";
const rnd = () => randomBytes(32).toString("base64url");
export function newFlow() {
const verifier = rnd();
const challenge = createHash("sha256").update(verifier).digest("base64url");
return { state: rnd(), nonce: rnd(), verifier, challenge };
}
export function safeEqual(a: string, b: string) {
const x = Buffer.from(a), y = Buffer.from(b);
return x.length === y.length && timingSafeEqual(x, y);
}
export function safeNext(raw: string | null | undefined, origin: string) {
if (!raw) return "/";
try {
const url = new URL(raw, origin);
return url.origin === origin ? url.pathname + url.search + url.hash : "/";
} catch {
return "/";
}
}
export async function verifyIdToken(idToken: string) {
const { payload } = await jwtVerify(idToken, JWKS, {
issuer: ["https://accounts.google.com", "accounts.google.com"],
audience: process.env.GOOGLE_CLIENT_ID!,
});
return payload;
}next および //evil.com を使用したトラップ
自作 OAuth の一般的なホールは、ログイン後のオープン リダイレクトです。 next.startsWith("/") チェックは //evil.com でミスします。ブラウザはこれをスキームのないアドレスと見なし、外部ドメインに移動します (/\evil.com は同じ方法で正規化されます)。 https://example.com/login?next=//evil.com リンクは Web サイトのように見えますが、実際にログインすると、被害者はフィッシング コピーに誘導されます。
safeNext は new URL(raw, origin) を通じて値を解析し、origin を比較します。 //evil.com、/\evil.com、および javascript: は / になります。開始時とコールバック時の両方で next を確認してください。
開始
// app/api/auth/google/route.ts
import { NextResponse, type NextRequest } from "next/server";
import { AUTH_URL, FLOW_COOKIE, newFlow, safeNext } from "@/lib/oauth/google";
export async function GET(req: NextRequest) {
const origin = process.env.APP_ORIGIN!; // не из заголовка Host
const { state, nonce, verifier, challenge } = newFlow();
const next = safeNext(req.nextUrl.searchParams.get("next"), origin);
const url = new URL(AUTH_URL);
url.search = new URLSearchParams({
client_id: process.env.GOOGLE_CLIENT_ID!,
redirect_uri: `${origin}/api/auth/google/callback`,
response_type: "code",
scope: "openid email profile",
state,
nonce,
code_challenge: challenge,
code_challenge_method: "S256",
}).toString();
const res = NextResponse.redirect(url);
res.cookies.set(FLOW_COOKIE, JSON.stringify({ state, nonce, verifier, next }), {
httpOnly: true, secure: true, sameSite: "lax", path: "/", maxAge: 600,
});
return res;
}SameSite=Lax は必須です。Google からの戻り値はクロスサイト ナビゲーションであり、Strict を含む Cookie は送信されません。 __Host- プレフィックスは、サブドメインによる上書きを防ぎます。
コールバック
// app/api/auth/google/callback/route.ts
import { NextResponse, type NextRequest } from "next/server";
import { FLOW_COOKIE, TOKEN_URL, safeEqual, safeNext, verifyIdToken } from "@/lib/oauth/google";
import { upsertGoogleUser, attachSession } from "@/lib/auth";
export async function GET(req: NextRequest) {
const origin = process.env.APP_ORIGIN!;
const clear = (res: NextResponse) => {
res.cookies.set(FLOW_COOKIE, "", { httpOnly: true, secure: true, sameSite: "lax", path: "/", maxAge: 0 });
return res;
};
const fail = (why: string) => clear(NextResponse.redirect(new URL(`/login?error=${why}`, origin)));
const raw = req.cookies.get(FLOW_COOKIE)?.value;
const q = req.nextUrl.searchParams;
const code = q.get("code"), state = q.get("state");
if (!raw || !code || !state) return fail("oauth");
const flow = JSON.parse(raw) as { state: string; nonce: string; verifier: string; next: string };
if (!safeEqual(flow.state, state)) return fail("state");
const tokenRes = await fetch(TOKEN_URL, {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
code,
client_id: process.env.GOOGLE_CLIENT_ID!,
client_secret: process.env.GOOGLE_CLIENT_SECRET!,
redirect_uri: `${origin}/api/auth/google/callback`,
grant_type: "authorization_code",
code_verifier: flow.verifier,
}),
});
if (!tokenRes.ok) return fail("token");
const { id_token } = (await tokenRes.json()) as { id_token?: string };
if (!id_token) return fail("token");
let claims;
try { claims = await verifyIdToken(id_token); } catch { return fail("token"); }
if (claims.nonce !== flow.nonce) return fail("nonce");
if (claims.email_verified !== true || typeof claims.email !== "string") return fail("email");
const user = await upsertGoogleUser({ sub: claims.sub!, email: claims.email.toLowerCase() });
const res = clear(NextResponse.redirect(new URL(safeNext(flow.next, origin), origin)));
await attachSession(res, user.id);
return res;
}Cookie は、maxAge: 0 を含む set を介して削除され、Secure と Path=/ のない __Host- の同じ属性である Set-Cookie はブラウザによって拒否されます。
email_verified とverified_email
id_token では、クレームは email_verified と呼ばれ、verified_email は古いエンドポイント userinfo v2 のフィールドです。名前を混同すると、決して機能しない verified_email === false チェックが実行されます。フィールドは undefined です。したがって、コードには厳密な === true があります。
ユーザーキーは電子メールではなく sub です。同じアドレスに基づくパスワードを持つアカウントにログインを暗黙的にリンクしないでください。古い方法でログインするよう求め、リンクを確認してください。
診断
redirect_uri_mismatch: URI は Google コンソールと文字ごとに一致しません。invalid_grant: コードはすでに使用されているか、有効期限が切れているか、code_verifierが同じではありません。- 一部のユーザーのエラー
state: Cookie がwwwに設定され、コールバックがベア ドメインに到達しました。
エージェントルール
--- description: Ревью OAuth и редиректов после входа globs: ["app/api/auth/**", "lib/oauth/**"] --- - next/returnTo только через safeNext (new URL + сравнение origin). - id_token: jwtVerify с issuer и audience, nonce сверять с cookie. - Идентификатор — sub; email только при email_verified === true.
図書館を借りるのに最適な時期はいつですか?
5 つのプロバイダー、アカウントのリンク、Google API のリフレッシュ トークンの実装はすぐに肥大化し、ライブラリが使用されます。 next、sub、email_verified に関するルールも、あなたの責任となります。