Google OAuth 2.0 senza NextAuth su TypeScript: PKCE, state, nonce e secure next
Cosa stiamo costruendo
Accedi tramite Google senza NextAuth: due gestori di percorsi in Next.js 15, codice di autorizzazione con PKCE. Start inserisce state, nonce e code_verifier nel cookie httpOnly; la richiamata controlla state, modifica code in token, controlla id_token e porta a un next sicuro.
Modulo generale
// 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;
}Trappola con next e //evil.com
Un buco comune nell'OAuth autoprodotto è un reindirizzamento aperto dopo l'accesso. Il controllo next.startsWith("/") non riesce a //evil.com: il browser lo considera un indirizzo senza schema e va a un dominio esterno (/\evil.com è normalizzato allo stesso modo). Il collegamento https://example.com/login?next=//evil.com assomiglia al tuo sito web, ma dopo aver effettivamente effettuato l'accesso, la vittima viene indirizzata a una copia di phishing.
safeNext analizza il valore tramite new URL(raw, origin) e confronta origin: //evil.com, /\evil.com e javascript: diventano /. Controlla next sia all'avvio che nel callback.
Inizia
[[VB_1_CODICE]]
SameSite=Lax è obbligatorio: il ritorno da Google è la navigazione tra siti, i cookie con Strict non verranno inviati. Il prefisso __Host- impedisce ai sottodomini di sovrascriverlo.
Richiamata
[[VB_2_CODICE]]
Il cookie viene eliminato tramite set con maxAge: 0 e gli stessi attributi: Set-Cookie per __Host- senza Secure e Path=/ verranno rifiutati dal browser.
email_verificata vs email_verificata
In id_token l'attestazione è chiamata email_verified e verified_email è un campo del vecchio endpoint userinfo v2. Mescolando i nomi si ottiene un controllo verified_email === false che non funziona mai: il campo è undefined. Pertanto, il codice ha un === true rigoroso.
La chiave utente è sub, non e-mail. Non collegare silenziosamente il login a un account con una password basata sullo stesso indirizzo: chiedi di accedere alla vecchia maniera e conferma il collegamento.
Diagnostica
redirect_uri_mismatch: l'URI non corrisponde alla console di Google carattere per carattere.invalid_grant: il codice è già stato utilizzato, è scaduto oppurecode_verifiernon è lo stesso.- Errore
stateper alcuni utenti: il cookie è stato impostato suwwwe la richiamata è arrivata a un dominio nudo.
Regola dell'agente
[[VB_3_CODICE]]
Qual è il momento migliore per prendere in prestito una biblioteca?
Cinque fornitori, che collegano account e token di aggiornamento per l'API di Google, gonfiano rapidamente la loro implementazione, quindi prendono la libreria. Anche in questo caso le regole su next, sub e email_verified rimangono di tua responsabilità.