Autenticação Moderna em 2026: JWT, Sessions, OAuth e Passkeys

// Criação simplificada de sessão
import { randomBytes } from "crypto";
import { cookies } from "next/headers";
 
interface Session {
  userId: string;
  createdAt: Date;
  expiresAt: Date;
  ipAddress: string;
  userAgent: string;
}
 
async function createSession(userId: string, request: Request): Promise<string> {
  const sessionId = randomBytes(32).toString("hex");
 
  const session: Session = {
    userId,
    createdAt: new Date(),
    expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000), // 24 horas
    ipAddress: request.headers.get("x-forwarded-for") ?? "unknown",
    userAgent: request.headers.get("user-agent") ?? "unknown",
  };
 
  // Armazenar na sua base de dados ou Redis
  await redis.set(`session:${sessionId}`, JSON.stringify(session), "EX", 86400);
 
  const cookieStore = await cookies();
  cookieStore.set("session_id", sessionId, {
    httpOnly: true,
    secure: true,
    sameSite: "lax",
    maxAge: 86400,
    path: "/",
  });
 
  return sessionId;
}

import { SignJWT, jwtVerify } from "jose";
 
const secret = new TextEncoder().encode(process.env.JWT_SECRET);
 
async function createAccessToken(userId: string, role: string): Promise<string> {
  return new SignJWT({ sub: userId, role })
    .setProtectedHeader({ alg: "HS256" })
    .setIssuedAt()
    .setExpirationTime("15m")
    .setIssuer("https://example.com")
    .setAudience("https://example.com")
    .sign(secret);
}
 
async function verifyAccessToken(token: string) {
  try {
    const { payload } = await jwtVerify(token, secret, {
      issuer: "https://example.com",
      audience: "https://example.com",
    });
    return payload;
  } catch {
    return null;
  }
}

{
  "alg": "RS256",
  "typ": "JWT"
}

{
  "sub": "user_123", // Subject (sobre quem é)
  "iss": "https://auth.example.com", // Issuer (quem criou)
  "aud": "https://api.example.com", // Audience (quem deve aceitar)
  "iat": 1709312000, // Issued At (timestamp Unix)
  "exp": 1709312900, // Expiration (timestamp Unix)
  "role": "admin" // Claim personalizada
}

import { SignJWT, jwtVerify, importPKCS8, importSPKI } from "jose";
 
// RS256 — use isto quando múltiplos serviços verificam tokens
const privateKeyPem = process.env.JWT_PRIVATE_KEY!;
const publicKeyPem = process.env.JWT_PUBLIC_KEY!;
 
async function signWithRS256(payload: Record<string, unknown>) {
  const privateKey = await importPKCS8(privateKeyPem, "RS256");
 
  return new SignJWT(payload)
    .setProtectedHeader({ alg: "RS256", typ: "JWT" })
    .setIssuedAt()
    .setExpirationTime("15m")
    .sign(privateKey);
}
 
async function verifyWithRS256(token: string) {
  const publicKey = await importSPKI(publicKeyPem, "RS256");
 
  const { payload } = await jwtVerify(token, publicKey, {
    algorithms: ["RS256"], // CRÍTICO: restringir sempre os algoritmos
  });
 
  return payload;
}

// VULNERÁVEL — nunca faça isto
function verifyJwt(token: string) {
  const [headerB64, payloadB64, signature] = token.split(".");
  const header = JSON.parse(atob(headerB64));
 
  if (header.alg === "none") {
    // "Sem assinatura necessária" — CATASTRÓFICO
    return JSON.parse(atob(payloadB64));
  }
 
  // ... verificar assinatura
}

// SEGURO — o algoritmo é hardcoded, não lido do token
const { payload } = await jwtVerify(token, key, {
  algorithms: ["RS256"], // Aceitar apenas RS256 — ignorar o header
});

import { randomBytes } from "crypto";
 
interface RefreshTokenRecord {
  tokenHash: string;
  userId: string;
  familyId: string; // Agrupa tokens relacionados
  used: boolean;
  expiresAt: Date;
  createdAt: Date;
}
 
async function issueTokenPair(userId: string) {
  const familyId = randomBytes(16).toString("hex");
 
  const accessToken = await createAccessToken(userId);
  const refreshToken = randomBytes(64).toString("hex");
  const refreshTokenHash = await hashToken(refreshToken);
 
  // Armazenar registo do refresh token
  await db.refreshToken.create({
    data: {
      tokenHash: refreshTokenHash,
      userId,
      familyId,
      used: false,
      expiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
      createdAt: new Date(),
    },
  });
 
  return { accessToken, refreshToken };
}

async function rotateTokens(incomingRefreshToken: string) {
  const tokenHash = await hashToken(incomingRefreshToken);
  const record = await db.refreshToken.findUnique({
    where: { tokenHash },
  });
 
  if (!record) {
    // Token não existe — possível roubo
    return null;
  }
 
  if (record.expiresAt < new Date()) {
    // Token expirado
    await db.refreshToken.delete({ where: { tokenHash } });
    return null;
  }
 
  if (record.used) {
    // ESTE TOKEN JÁ FOI USADO.
    // Alguém está a fazê-lo replay — ou o utilizador legítimo
    // ou um atacante. De qualquer forma, matar toda a família.
    await db.refreshToken.deleteMany({
      where: { familyId: record.familyId },
    });
 
    console.error(
      `Reutilização de refresh token detetada para utilizador ${record.userId}, família ${record.familyId}. Todos os tokens da família invalidados.`,
    );
 
    return null;
  }
 
  // Marcar token atual como usado (não apagar — precisamos para deteção de reutilização)
  await db.refreshToken.update({
    where: { tokenHash },
    data: { used: true },
  });
 
  // Emitir novo par com o mesmo ID de família
  const newRefreshToken = randomBytes(64).toString("hex");
  const newRefreshTokenHash = await hashToken(newRefreshToken);
 
  await db.refreshToken.create({
    data: {
      tokenHash: newRefreshTokenHash,
      userId: record.userId,
      familyId: record.familyId, // Mesma família
      used: false,
      expiresAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
      createdAt: new Date(),
    },
  });
 
  const newAccessToken = await createAccessToken(record.userId);
 
  return { accessToken: newAccessToken, refreshToken: newRefreshToken };
}

import { randomBytes, createHash } from "crypto";
 
// Passo 1: Gerar valores PKCE e redirecionar o utilizador
function initiateOAuthFlow() {
  // Code verifier: string aleatória de 43-128 caracteres
  const codeVerifier = randomBytes(32).toString("base64url").slice(0, 43);
 
  // Code challenge: hash SHA256 do verifier, codificado em base64url
  const codeChallenge = createHash("sha256").update(codeVerifier).digest("base64url");
 
  // State: valor aleatório para proteção CSRF
  const state = randomBytes(16).toString("hex");
 
  // Armazenar ambos na sessão (server-side!) antes de redirecionar
  // NUNCA colocar o code_verifier num cookie ou parâmetro de URL
  session.codeVerifier = codeVerifier;
  session.oauthState = state;
 
  const authUrl = new URL("https://accounts.google.com/o/oauth2/v2/auth");
  authUrl.searchParams.set("client_id", process.env.GOOGLE_CLIENT_ID!);
  authUrl.searchParams.set("redirect_uri", "https://example.com/api/auth/callback/google");
  authUrl.searchParams.set("response_type", "code");
  authUrl.searchParams.set("scope", "openid email profile");
  authUrl.searchParams.set("state", state);
  authUrl.searchParams.set("code_challenge", codeChallenge);
  authUrl.searchParams.set("code_challenge_method", "S256");
 
  return authUrl.toString();
}

// Passo 2: Tratar o callback
async function handleOAuthCallback(request: Request) {
  const url = new URL(request.url);
  const code = url.searchParams.get("code");
  const state = url.searchParams.get("state");
  const error = url.searchParams.get("error");
 
  // Verificar erros do provedor
  if (error) {
    throw new Error(`Erro OAuth: ${error}`);
  }
 
  // Verificar que state corresponde (proteção CSRF)
  if (state !== session.oauthState) {
    throw new Error("State não corresponde — possível ataque CSRF");
  }
 
  // Trocar o código de autorização por tokens
  const tokenResponse = await fetch("https://oauth2.googleapis.com/token", {
    method: "POST",
    headers: { "Content-Type": "application/x-www-form-urlencoded" },
    body: new URLSearchParams({
      grant_type: "authorization_code",
      code: code!,
      redirect_uri: "https://example.com/api/auth/callback/google",
      client_id: process.env.GOOGLE_CLIENT_ID!,
      client_secret: process.env.GOOGLE_CLIENT_SECRET!,
      code_verifier: session.codeVerifier, // PKCE: prova que nós iniciámos este fluxo
    }),
  });
 
  const tokens = await tokenResponse.json();
  // tokens.access_token — para chamadas API ao Google
  // tokens.id_token — JWT com identidade do utilizador (OIDC)
  // tokens.refresh_token — para obter novos access tokens
 
  // Passo 3: Verificar o ID token e extrair info do utilizador
  const idTokenPayload = await verifyGoogleIdToken(tokens.id_token);
 
  return {
    googleId: idTokenPayload.sub,
    email: idTokenPayload.email,
    name: idTokenPayload.name,
    picture: idTokenPayload.picture,
  };
}

// src/lib/auth.ts
import NextAuth from "next-auth";
import Google from "next-auth/providers/google";
import GitHub from "next-auth/providers/github";
import Credentials from "next-auth/providers/credentials";
import { PrismaAdapter } from "@auth/prisma-adapter";
import { prisma } from "@/lib/prisma";
import { verifyPassword } from "@/lib/password";
 
export const { handlers, auth, signIn, signOut } = NextAuth({
  adapter: PrismaAdapter(prisma),
 
  // Usar sessões de base de dados (não JWT) para melhor segurança
  session: {
    strategy: "database",
    maxAge: 30 * 24 * 60 * 60, // 30 dias
    updateAge: 24 * 60 * 60, // Estender sessão a cada 24 horas
  },
 
  providers: [
    Google({
      clientId: process.env.GOOGLE_CLIENT_ID!,
      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
      // Solicitar scopes específicos
      authorization: {
        params: {
          scope: "openid email profile",
          prompt: "consent",
          access_type: "offline", // Obter refresh token
        },
      },
    }),
 
    GitHub({
      clientId: process.env.GITHUB_CLIENT_ID!,
      clientSecret: process.env.GITHUB_CLIENT_SECRET!,
    }),
 
    // Login por email/senha (usar com cuidado)
    Credentials({
      credentials: {
        email: { label: "Email", type: "email" },
        password: { label: "Senha", type: "password" },
      },
      authorize: async (credentials) => {
        if (!credentials?.email || !credentials?.password) {
          return null;
        }
 
        const user = await prisma.user.findUnique({
          where: { email: credentials.email as string },
        });
 
        if (!user || !user.passwordHash) {
          return null;
        }
 
        const isValid = await verifyPassword(credentials.password as string, user.passwordHash);
 
        if (!isValid) {
          return null;
        }
 
        return {
          id: user.id,
          email: user.email,
          name: user.name,
          image: user.image,
        };
      },
    }),
  ],
 
  callbacks: {
    // Controlar quem pode fazer login
    async signIn({ user, account }) {
      // Bloquear login de utilizadores banidos
      if (user.id) {
        const dbUser = await prisma.user.findUnique({
          where: { id: user.id },
          select: { banned: true },
        });
        if (dbUser?.banned) return false;
      }
      return true;
    },
 
    // Adicionar campos personalizados à sessão
    async session({ session, user }) {
      if (session.user) {
        session.user.id = user.id;
        // Buscar role da base de dados
        const dbUser = await prisma.user.findUnique({
          where: { id: user.id },
          select: { role: true },
        });
        session.user.role = dbUser?.role ?? "user";
      }
      return session;
    },
  },
 
  pages: {
    signIn: "/login",
    error: "/auth/error",
    verifyRequest: "/auth/verify",
  },
});

// src/app/api/auth/[...nextauth]/route.ts
import { handlers } from "@/lib/auth";
 
export const { GET, POST } = handlers;

// src/middleware.ts
import { auth } from "@/lib/auth";
import { NextResponse } from "next/server";
 
export default auth((req) => {
  const isLoggedIn = !!req.auth;
  const isAuthPage = req.nextUrl.pathname.startsWith("/login") || req.nextUrl.pathname.startsWith("/register");
  const isProtectedRoute =
    req.nextUrl.pathname.startsWith("/dashboard") ||
    req.nextUrl.pathname.startsWith("/settings") ||
    req.nextUrl.pathname.startsWith("/admin");
  const isAdminRoute = req.nextUrl.pathname.startsWith("/admin");
 
  // Redirecionar utilizadores autenticados para fora das páginas de auth
  if (isLoggedIn && isAuthPage) {
    return NextResponse.redirect(new URL("/dashboard", req.nextUrl));
  }
 
  // Redirecionar utilizadores não autenticados para login
  if (!isLoggedIn && isProtectedRoute) {
    const callbackUrl = encodeURIComponent(req.nextUrl.pathname);
    return NextResponse.redirect(new URL(`/login?callbackUrl=${callbackUrl}`, req.nextUrl));
  }
 
  // Verificar role de admin
  if (isAdminRoute && req.auth?.user?.role !== "admin") {
    return NextResponse.redirect(new URL("/dashboard", req.nextUrl));
  }
 
  return NextResponse.next();
});
 
export const config = {
  matcher: ["/dashboard/:path*", "/settings/:path*", "/admin/:path*", "/login", "/register"],
};

// src/app/dashboard/page.tsx
import { auth } from "@/lib/auth";
import { redirect } from "next/navigation";
 
export default async function DashboardPage() {
  const session = await auth();
 
  if (!session?.user) {
    redirect("/login");
  }
 
  return (
    <div>
      <h1>Bem-vindo, {session.user.name}</h1>
      <p>Role: {session.user.role}</p>
    </div>
  );
}

"use client";
 
import { useSession } from "next-auth/react";
 
export function UserMenu() {
  const { data: session, status } = useSession();
 
  if (status === "loading") {
    return <div>A carregar...</div>;
  }
 
  if (status === "unauthenticated") {
    return <a href="/login">Entrar</a>;
  }
 
  return (
    <div>
      <img
        src={session?.user?.image ?? "/default-avatar.png"}
        alt={session?.user?.name ?? "Utilizador"}
      />
      <span>{session?.user?.name}</span>
    </div>
  );
}

// Server-side: Registo
import { generateRegistrationOptions, verifyRegistrationResponse } from "@simplewebauthn/server";
import type { GenerateRegistrationOptionsOpts, VerifiedRegistrationResponse } from "@simplewebauthn/server";
 
const rpName = "example.com";
const rpID = "example.com";
const origin = "https://example.com";
 
async function startRegistration(userId: string, userEmail: string) {
  // Obter passkeys existentes do utilizador para excluí-las
  const existingCredentials = await db.credential.findMany({
    where: { userId },
    select: { credentialId: true, transports: true },
  });
 
  const options: GenerateRegistrationOptionsOpts = {
    rpName,
    rpID,
    userID: new TextEncoder().encode(userId),
    userName: userEmail,
    attestationType: "none", // Não precisamos de attestation para a maioria das apps
    excludeCredentials: existingCredentials.map((cred) => ({
      id: cred.credentialId,
      transports: cred.transports,
    })),
    authenticatorSelection: {
      residentKey: "preferred",
      userVerification: "preferred",
    },
  };
 
  const registrationOptions = await generateRegistrationOptions(options);
 
  // Armazenar o desafio temporariamente — precisamos para verificação
  await redis.set(
    `webauthn:challenge:${userId}`,
    registrationOptions.challenge,
    "EX",
    300, // 5 minutos de expiração
  );
 
  return registrationOptions;
}
 
async function finishRegistration(userId: string, response: unknown) {
  const expectedChallenge = await redis.get(`webauthn:challenge:${userId}`);
 
  if (!expectedChallenge) {
    throw new Error("Desafio expirado ou não encontrado");
  }
 
  let verification: VerifiedRegistrationResponse;
  try {
    verification = await verifyRegistrationResponse({
      response: response as any,
      expectedChallenge,
      expectedOrigin: origin,
      expectedRPID: rpID,
    });
  } catch (error) {
    throw new Error(`Falha na verificação de registo: ${error}`);
  }
 
  if (!verification.verified || !verification.registrationInfo) {
    throw new Error("Falha na verificação de registo");
  }
 
  const { credential } = verification.registrationInfo;
 
  // Armazenar a credencial na base de dados
  await db.credential.create({
    data: {
      userId,
      credentialId: credential.id,
      publicKey: Buffer.from(credential.publicKey),
      counter: credential.counter,
      transports: credential.transports ?? [],
    },
  });
 
  // Limpar
  await redis.del(`webauthn:challenge:${userId}`);
 
  return { verified: true };
}

// Server-side: Autenticação
import { generateAuthenticationOptions, verifyAuthenticationResponse } from "@simplewebauthn/server";
 
async function startAuthentication(userId?: string) {
  let allowCredentials;
 
  // Se sabemos quem é o utilizador (ex.: introduziu o email), limitar às suas passkeys
  if (userId) {
    const credentials = await db.credential.findMany({
      where: { userId },
      select: { credentialId: true, transports: true },
    });
    allowCredentials = credentials.map((cred) => ({
      id: cred.credentialId,
      transports: cred.transports,
    }));
  }
 
  const options = await generateAuthenticationOptions({
    rpID,
    allowCredentials,
    userVerification: "preferred",
  });
 
  // Armazenar desafio para verificação
  const challengeKey = userId ? `webauthn:auth:${userId}` : `webauthn:auth:${options.challenge}`;
 
  await redis.set(challengeKey, options.challenge, "EX", 300);
 
  return options;
}
 
async function finishAuthentication(response: any, expectedChallenge: string, userId: string) {
  const credential = await db.credential.findUnique({
    where: { credentialId: response.id },
  });
 
  if (!credential) {
    throw new Error("Credencial não encontrada");
  }
 
  const verification = await verifyAuthenticationResponse({
    response,
    expectedChallenge,
    expectedOrigin: origin,
    expectedRPID: rpID,
    credential: {
      id: credential.credentialId,
      publicKey: credential.publicKey,
      counter: credential.counter,
      transports: credential.transports,
    },
  });
 
  if (!verification.verified) {
    throw new Error("Falha na verificação de autenticação");
  }
 
  // IMPORTANTE: Atualizar o contador para prevenir ataques de replay
  await db.credential.update({
    where: { credentialId: response.id },
    data: {
      counter: verification.authenticationInfo.newCounter,
    },
  });
 
  return { verified: true, userId: credential.userId };
}

// Client-side: Registo
import { startRegistration as webAuthnRegister } from "@simplewebauthn/browser";
 
async function registerPasskey() {
  // Obter opções do seu servidor
  const optionsResponse = await fetch("/api/auth/webauthn/register", {
    method: "POST",
  });
  const options = await optionsResponse.json();
 
  try {
    // Isto aciona a UI de passkey do navegador (prompt biométrico)
    const credential = await webAuthnRegister(options);
 
    // Enviar a credencial ao seu servidor para verificação
    const verifyResponse = await fetch("/api/auth/webauthn/register/verify", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(credential),
    });
 
    const result = await verifyResponse.json();
    if (result.verified) {
      console.log("Passkey registada com sucesso!");
    }
  } catch (error) {
    if ((error as Error).name === "NotAllowedError") {
      console.log("Utilizador cancelou o registo de passkey");
    }
  }
}

import { createHmac, randomBytes } from "crypto";
 
// Gerar um segredo TOTP para um utilizador
function generateTOTPSecret(): string {
  const buffer = randomBytes(20);
  return base32Encode(buffer);
}
 
function base32Encode(buffer: Buffer): string {
  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
  let result = "";
  let bits = 0;
  let value = 0;
 
  for (const byte of buffer) {
    value = (value << 8) | byte;
    bits += 8;
    while (bits >= 5) {
      result += alphabet[(value >>> (bits - 5)) & 0x1f];
      bits -= 5;
    }
  }
 
  if (bits > 0) {
    result += alphabet[(value << (5 - bits)) & 0x1f];
  }
 
  return result;
}
 
// Gerar o URI TOTP para código QR
function generateTOTPUri(secret: string, userEmail: string, issuer: string = "example.com"): string {
  const encodedIssuer = encodeURIComponent(issuer);
  const encodedEmail = encodeURIComponent(userEmail);
  return `otpauth://totp/${encodedIssuer}:${encodedEmail}?secret=${secret}&issuer=${encodedIssuer}&algorithm=SHA1&digits=6&period=30`;
}

// Verificar um código TOTP
function verifyTOTP(secret: string, code: string, window: number = 1): boolean {
  const secretBuffer = base32Decode(secret);
  const now = Math.floor(Date.now() / 1000);
 
  // Verificar o passo de tempo atual e os adjacentes (tolerância de desvio de relógio)
  for (let i = -window; i <= window; i++) {
    const timeStep = Math.floor(now / 30) + i;
    const expectedCode = generateTOTPCode(secretBuffer, timeStep);
 
    // Comparação em tempo constante para prevenir timing attacks
    if (timingSafeEqual(code, expectedCode)) {
      return true;
    }
  }
 
  return false;
}
 
function generateTOTPCode(secret: Buffer, timeStep: number): string {
  // Converter passo de tempo em buffer big-endian de 8 bytes
  const timeBuffer = Buffer.alloc(8);
  timeBuffer.writeBigInt64BE(BigInt(timeStep));
 
  // HMAC-SHA1
  const hmac = createHmac("sha1", secret).update(timeBuffer).digest();
 
  // Truncação dinâmica
  const offset = hmac[hmac.length - 1] & 0x0f;
  const code =
    ((hmac[offset] & 0x7f) << 24) |
    ((hmac[offset + 1] & 0xff) << 16) |
    ((hmac[offset + 2] & 0xff) << 8) |
    (hmac[offset + 3] & 0xff);
 
  return (code % 1_000_000).toString().padStart(6, "0");
}
 
function timingSafeEqual(a: string, b: string): boolean {
  if (a.length !== b.length) return false;
  const bufA = Buffer.from(a);
  const bufB = Buffer.from(b);
  return createHmac("sha256", "key").update(bufA).digest().equals(createHmac("sha256", "key").update(bufB).digest());
}

import { randomBytes, createHash } from "crypto";
 
function generateBackupCodes(count: number = 10): string[] {
  return Array.from(
    { length: count },
    () => randomBytes(4).toString("hex").toUpperCase(), // Códigos hex de 8 caracteres
  );
}
 
async function storeBackupCodes(userId: string, codes: string[]) {
  // Hashear os códigos antes de armazenar — tratá-los como senhas
  const hashedCodes = codes.map((code) => createHash("sha256").update(code).digest("hex"));
 
  await db.backupCode.createMany({
    data: hashedCodes.map((hash) => ({
      userId,
      codeHash: hash,
      used: false,
    })),
  });
 
  // Retornar os códigos em texto plano UMA VEZ para o utilizador guardar
  // Depois disto, só temos os hashes
  return codes;
}
 
async function verifyBackupCode(userId: string, code: string): Promise<boolean> {
  const codeHash = createHash("sha256").update(code.toUpperCase().replace(/\s/g, "")).digest("hex");
 
  const backupCode = await db.backupCode.findFirst({
    where: {
      userId,
      codeHash,
      used: false,
    },
  });
 
  if (!backupCode) return false;
 
  // Marcar como usado — cada código de backup funciona exatamente uma vez
  await db.backupCode.update({
    where: { id: backupCode.id },
    data: { used: true, usedAt: new Date() },
  });
 
  return true;
}

async function initiateAccountRecovery(email: string) {
  const user = await db.user.findUnique({ where: { email } });
  if (!user) {
    // Não revelar se a conta existe
    return { message: "Se esse email existir, enviámos instruções de recuperação." };
  }
 
  const recoveryToken = randomBytes(32).toString("hex");
  const tokenHash = createHash("sha256").update(recoveryToken).digest("hex");
 
  await db.recoveryRequest.create({
    data: {
      userId: user.id,
      tokenHash,
      expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000), // 24 horas
      status: "pending",
    },
  });
 
  // Enviar email com link de recuperação
  await sendEmail(email, {
    subject: "Pedido de Recuperação de Conta",
    body: `
      Foi feito um pedido para desativar MFA na sua conta.
      Se foi você, clique no link abaixo após 24 horas: ...
      Se NÃO foi você, por favor mude a sua senha imediatamente.
    `,
  });
 
  return { message: "Se esse email existir, enviámos instruções de recuperação." };
}

// RBAC — verificações diretas de role
type Role = "user" | "editor" | "admin" | "super_admin";
 
const ROLE_PERMISSIONS: Record<Role, string[]> = {
  user: ["read:own_profile", "update:own_profile", "read:posts"],
  editor: ["read:own_profile", "update:own_profile", "read:posts", "create:posts", "update:posts"],
  admin: [
    "read:own_profile",
    "update:own_profile",
    "read:posts",
    "create:posts",
    "update:posts",
    "delete:posts",
    "read:users",
    "update:users",
  ],
  super_admin: ["*"], // Cuidado com wildcards
};
 
function hasPermission(role: Role, permission: string): boolean {
  const permissions = ROLE_PERMISSIONS[role];
  return permissions.includes("*") || permissions.includes(permission);
}
 
// Utilização numa rota API
export async function DELETE(request: Request, { params }: { params: Promise<{ id: string }> }) {
  const session = await auth();
  if (!session?.user) {
    return Response.json({ error: "Não autorizado" }, { status: 401 });
  }
 
  if (!hasPermission(session.user.role as Role, "delete:posts")) {
    return Response.json({ error: "Proibido" }, { status: 403 });
  }
 
  const { id } = await params;
  await db.post.delete({ where: { id } });
  return Response.json({ success: true });
}

// ABAC — quando RBAC não é suficiente
interface PolicyContext {
  user: {
    id: string;
    role: string;
    department: string;
    clearanceLevel: number;
  };
  resource: {
    type: string;
    ownerId: string;
    classification: string;
    department: string;
  };
  action: string;
  environment: {
    ipAddress: string;
    time: Date;
    mfaVerified: boolean;
  };
}
 
function evaluatePolicy(context: PolicyContext): boolean {
  const { user, resource, action, environment } = context;
 
  // Utilizadores podem sempre ler os seus próprios recursos
  if (action === "read" && resource.ownerId === user.id) {
    return true;
  }
 
  // Admins podem ler qualquer recurso no seu departamento
  if (action === "read" && user.role === "admin" && user.department === resource.department) {
    return true;
  }
 
  // Recursos classificados requerem MFA e clearance mínimo
  if (resource.classification === "confidential") {
    if (!environment.mfaVerified) return false;
    if (user.clearanceLevel < 3) return false;
  }
 
  // Ações destrutivas bloqueadas fora do horário de trabalho
  if (action === "delete") {
    const hour = environment.time.getHours();
    if (hour < 9 || hour > 17) return false;
  }
 
  return false; // Negação por defeito
}

// MAU — verificar apenas no componente
function DeleteButton({ post }: { post: Post }) {
  const { data: session } = useSession();
 
  // Isto esconde o botão, mas não previne a eliminação
  if (session?.user?.role !== "admin") return null;
 
  return <button onClick={() => deletePost(post.id)}>Apagar</button>;
}
 
// TAMBÉM MAU — verificar num server action mas não na rota API
async function deletePostAction(postId: string) {
  const session = await auth();
  if (session?.user?.role !== "admin") throw new Error("Proibido");
  await db.post.delete({ where: { id: postId } });
}
// Um atacante pode ainda chamar POST /api/posts/123 diretamente
 
// BOM — verificar em cada fronteira
// 1. Esconder o botão na UI (UX, não segurança)
// 2. Verificar no server action (defesa em profundidade)
// 3. Verificar na rota API (a fronteira de segurança real)
// 4. Opcionalmente, verificar no middleware (para proteção ao nível da rota)

// "Este utilizador tem permissão para aceder a esta secção?"
// Verificações granulares ("Este utilizador pode editar ESTE post?") pertencem ao route handler
// porque o middleware não tem acesso fácil ao corpo do pedido ou parâmetros de rota.
 
export default auth((req) => {
  const path = req.nextUrl.pathname;
  const role = req.auth?.user?.role;
 
  // Controlo de acesso ao nível da rota
  const routeAccess: Record<string, Role[]> = {
    "/admin": ["admin", "super_admin"],
    "/editor": ["editor", "admin", "super_admin"],
    "/dashboard": ["user", "editor", "admin", "super_admin"],
  };
 
  for (const [route, allowedRoles] of Object.entries(routeAccess)) {
    if (path.startsWith(route)) {
      if (!role || !allowedRoles.includes(role as Role)) {
        return NextResponse.redirect(new URL("/unauthorized", req.nextUrl));
      }
    }
  }
 
  return NextResponse.next();
});

async function login(credentials: { email: string; password: string }, request: Request) {
  const user = await verifyCredentials(credentials);
  if (!user) throw new Error("Credenciais inválidas");
 
  // CRÍTICO: Apagar a sessão antiga e criar uma nova
  const oldSessionId = getSessionIdFromCookie(request);
  if (oldSessionId) {
    await redis.del(`session:${oldSessionId}`);
  }
 
  // Criar uma sessão completamente nova com um novo ID
  const newSessionId = await createSession(user.id, request);
  return newSessionId;
}

// SameSite=Lax cobre a maioria dos cenários CSRF:
// - Bloqueia cookies em POST, PUT, DELETE cross-origin
// - Permite cookies em GET cross-origin (navegação top-level)
//   Isto é aceitável porque pedidos GET não devem ter efeitos secundários
 
cookieStore.set("session_id", sessionId, {
  httpOnly: true,
  secure: true,
  sameSite: "lax", // Esta é a sua proteção CSRF
  maxAge: 86400,
  path: "/",
});

// VULNERÁVEL
async function handleCallback(request: Request) {
  const url = new URL(request.url);
  const redirectTo = url.searchParams.get("redirect_to") ?? "/";
  // ... autenticar o utilizador ...
  return Response.redirect(redirectTo); // Pode ser https://evil.com!
}
 
// SEGURO
async function handleCallback(request: Request) {
  const url = new URL(request.url);
  const redirectTo = url.searchParams.get("redirect_to") ?? "/";
 
  // Validar o URL de redirecionamento
  const safeRedirect = sanitizeRedirectUrl(redirectTo, request.url);
  // ... autenticar o utilizador ...
  return Response.redirect(safeRedirect);
}
 
function sanitizeRedirectUrl(redirect: string, baseUrl: string): string {
  try {
    const url = new URL(redirect, baseUrl);
    const base = new URL(baseUrl);
 
    // Permitir apenas redirecionamentos para a mesma origin
    if (url.origin !== base.origin) {
      return "/";
    }
 
    // Permitir apenas redirecionamentos de caminho (sem javascript: ou data: URIs)
    if (!url.pathname.startsWith("/")) {
      return "/";
    }
 
    return url.pathname + url.search;
  } catch {
    return "/";
  }
}

// No seu middleware ou layout do Next.js
const headers = new Headers();
headers.set("Referrer-Policy", "strict-origin-when-cross-origin");

// Este é o meu auth.ts típico para um novo projeto
import NextAuth from "next-auth";
import Google from "next-auth/providers/google";
import GitHub from "next-auth/providers/github";
import Passkey from "next-auth/providers/passkey";
import { PrismaAdapter } from "@auth/prisma-adapter";
import { prisma } from "@/lib/prisma";
 
export const { handlers, auth, signIn, signOut } = NextAuth({
  adapter: PrismaAdapter(prisma),
  session: { strategy: "database" },
  providers: [
    Google,
    GitHub,
    Passkey({
      // Auth.js v5 tem suporte nativo a passkeys
      // Usa SimpleWebAuthn por baixo
    }),
  ],
  experimental: {
    enableWebAuthn: true,
  },
});

import { hash, verify } from "@node-rs/argon2";
 
// Argon2id é o algoritmo recomendado
// Estes são padrões razoáveis para uma aplicação web
async function hashPassword(password: string): Promise<string> {
  return hash(password, {
    memoryCost: 65536, // 64 MB
    timeCost: 3, // 3 iterações
    parallelism: 4, // 4 threads
  });
}
 
async function verifyPassword(password: string, hashedPassword: string): Promise<boolean> {
  try {
    return await verify(hashedPassword, password);
  } catch {
    return false;
  }
}