v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:22:00.000Z▲ 0 upvotes

Google OAuth 2.0 بدون NextAuth على TypeScript: PKCE، وstate، وnonce، وsafe next

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

ما نبنيه

تسجيل الدخول عبر Google بدون NextAuth: معالجا الطريق في Next.js 15، رمز التفويض مع PKCE. البداية تضع state، nonce و code_verifier في ملف تعريف الارتباط httpOnly؛ يتحقق رد الاتصال من 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 مثل موقع الويب الخاص بك، ولكن بعد تسجيل الدخول فعليًا، يتم نقل الضحية إلى نسخة تصيدية.

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. البادئة __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;
}

يتم حذف ملف تعريف الارتباط عبر set مع maxAge: 0 وسيتم رفض نفس السمات: Set-Cookie لـ __Host- بدون Secure وPath=/ بواسطة المتصفح.

البريد الإلكتروني_الذي تم التحقق منه مقابل البريد الإلكتروني الذي تم التحقق منه

في id_token يُطلق على المطالبة اسم email_verified، وverified_email هو حقل لمعلومات مستخدم نقطة النهاية القديمة v2. من خلال خلط الأسماء، تحصل على فحص verified_email === false الذي لا يعمل أبدًا: الحقل هو undefined. ولذلك، فإن التعليمات البرمجية صارمة === true.

مفتاح المستخدم هو sub، وليس البريد الإلكتروني. لا تربط تسجيل الدخول بصمت بحساب بكلمة مرور تعتمد على نفس العنوان: اطلب تسجيل الدخول بالطريقة القديمة وقم بتأكيد الارتباط.

التشخيص

  • redirect_uri_mismatch: لا يتطابق URI مع وحدة تحكم Google حرفًا بحرف.
  • invalid_grant: تم استخدام الرمز بالفعل، أو انتهت صلاحيته، أو أن code_verifier ليس هو نفسه.
  • خطأ state لبعض المستخدمين: تم تعيين ملف تعريف الارتباط على 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.

ما هو أفضل وقت لاستعارة المكتبة؟

خمسة مقدمي خدمات، يربطون الحسابات ويحدثون الرموز المميزة لواجهة برمجة تطبيقات Google، وسرعان ما يضخمون تنفيذها - ثم يأخذون المكتبة. تظل القواعد المتعلقة بـ next وsub وemail_verified مسؤوليتك هناك أيضًا.

Обсуждение (0)

Ещё на vbcd4u.com