Saltar al contenido principal

TEC-019 (Fase 2) — Sesión en cookie HttpOnly + CSRF y móvil con almacén seguro

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Cierra el criterio «las cookies de sesión están protegidas» de REQ-SEC-14. La web deja de guardar el JWT en localStorage: el API lo emite en una cookie HttpOnly; Secure; SameSite con CSRF double-submit, y el usuario se hidrata con GET /api/auths/me. El móvil sigue con cabecera y mueve el token a expo-secure-store.


📋 Alcance​

RFEntregable
RF-TEC-019-03Sesión en cookie HttpOnly+Secure+SameSite (web, con CSRF) y almacén seguro (móvil)
RF-TEC-019-04Algoritmo del JWT fijado en HS256 (el resto del payload, pendiente)

⚙️ Cómo funciona​

  • Login/2FA/refresh → el API devuelve el token en el body (móvil) y setea dos cookies: ccf_sesion (HttpOnly) y ccf_csrf (legible por JS).
  • El navegador envía la cookie en cada petición (withCredentials); el cliente añade X-CSRF-Token (leído de ccf_csrf) en los métodos mutantes.
  • El API valida el CSRF solo cuando la petición se autentica por cookie; el canal cabecera (móvil) es inmune.
  • JwtStrategy extrae el token de la cabecera o de la cookie (doble canal); GET /auths/me devuelve el perfil para rehidratar la web.
POST /api/auths/login → Set-Cookie: ccf_sesion=…; HttpOnly; Secure; SameSite=Lax + ccf_csrf=…
GET /api/auths/me (con cookie) → 200
POST /api/categorias (con cookie, sin X-CSRF-Token) → 403 CSRF_INVALIDO
POST /api/categorias (con cookie y X-CSRF-Token) → 200

🔐 Decisiones de seguridad​

DecisiónPor qué
Cookie HttpOnly para la sesiónInmune a XSS (JavaScript no la lee)
Cookie CSRF (no HttpOnly) + cabeceraDouble-submit: el atacante no puede leer la cookie ni fijar la cabecera
CSRF solo en canal cookieEl canal cabecera (móvil) no se auto-envía: es inmune
Doble canalNo rompe la app móvil ni clientes antiguos
SameSite/Secure configurablesCubre same-site (Lax) y cross-site (None+HTTPS)

🖥️ API, Web y Móvil​

  • API: cookie-parser, cookies.config/util, csrf.middleware, extractor dual en JwtStrategy/guards, GET /auths/me, gateways con credentials.
  • Web: withCredentials, sin Authorization (se limpian los Bearer null heredados), interceptor CSRF, hidratación por /me, sesiones-panel desde el contexto.
  • Móvil (mobile-app): token en expo-secure-store; sigue con cabecera.
  • Configuración: COOKIE_SESION_NOMBRE, COOKIE_CSRF_NOMBRE, COOKIE_SECURE, COOKIE_SAMESITE, COOKIE_DOMINIO.

🧪 Verificación​

PruebaResultado
npx tsc --noEmit (API y web)EXIT 0
Specs API (csrf.middleware, cookies.util, guards)13/13 verde
Login → Set-Cookie HttpOnly; /me con cookie → 200Pendiente de entorno con BD
POST mutante sin CSRF → 403; con CSRF → 200Pendiente de entorno

📎 Documentación​