13. Autenticación Stateful para SPAs (React/Vue/Next) con Cookies y Protección CSRF
Configura Sanctum para aplicaciones web en el mismo dominio o subdominio utilizando cookies HttpOnly seguras y la ruta /sanctum/csrf-cookie.
¿Bearer Tokens vs Cookies de Sesión en el Navegador?
Guardar Bearer Tokens en el localStorage del navegador expone la aplicación a ataques de Cross-Site Scripting (XSS): si una librería externa o paquete npm malicioso inyecta código JavaScript, puede leer el token del localStorage y enviarlo a un servidor atacante.
Para aplicaciones frontend tipo SPA (React, Vue, Nuxt, Next) que comparten dominio o subdominio con la API (ej: app.kilopolis.com y api.kilopolis.com), Laravel Sanctum ofrece el modo Stateful Authentication:
- Utiliza cookies HttpOnly y
SameSite=Lax/Strict(JavaScript no puede leerlas). - Protege automáticamente contra ataques CSRF mediante tokens criptográficos
XSRF-TOKEN.
El Flujo de Inicialización CSRF con /sanctum/csrf-cookie
Antes de que la SPA envíe la petición de login, debe inicializar la protección CSRF:
- El cliente envía un
GET /sanctum/csrf-cookie. - Laravel responde emitiendo una cookie cifrada llamada
XSRF-TOKEN. - Librerías como Axios leen automáticamente esa cookie y la envían en la cabecera
X-XSRF-TOKENen las siguientes llamadas POST/PUT/DELETE. - El cliente envía
POST /loginusando la sesión normal de Laravel sin exponer ningún token manual.
⚡ Configuración de Sanctum Stateful en config/sanctum.php y .env
Variables y configuraciones para habilitar dominios con estado en Laravel:
# Archivo .env
SANCTUM_STATEFUL_DOMAINS="app.kilopolis.com,localhost:3000,127.0.0.1:3000"
SESSION_DOMAIN=".kilopolis.com"
// -----------------------------------------------------------------
// En el Frontend (JavaScript con Axios):
// -----------------------------------------------------------------
// import axios from 'axios';
//
// axios.defaults.withCredentials = true; // Permite el envío de cookies HttpOnly
// axios.defaults.baseURL = 'https://api.kilopolis.com';
//
// // 1. Inicializar cookie CSRF obligatoria
// await axios.get('/sanctum/csrf-cookie');
//
// // 2. Enviar login con sesión protegida
// await axios.post('/api/v1/login', {
// email: '[email protected]',
// password: 'MiPasswordSeguro123'
// });
//
// // 3. Consultar perfil autenticado
// const res = await axios.get('/api/v1/perfil');
// console.log(res.data);
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué la autenticación basada en cookies HttpOnly de Sanctum es más segura en navegadores que guardar un Bearer Token en localStorage?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.