Tema 13 · Autenticación SPA

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:

  1. El cliente envía un GET /sanctum/csrf-cookie.
  2. Laravel responde emitiendo una cookie cifrada llamada XSRF-TOKEN.
  3. Librerías como Axios leen automáticamente esa cookie y la envían en la cabecera X-XSRF-TOKEN en las siguientes llamadas POST/PUT/DELETE.
  4. El cliente envía POST /login usando 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:

config/sanctum.php
Solo lectura
# 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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.