TEC-019 (Fase 2) — Sesión en cookie HttpOnly + CSRF y móvil con almacén seguro
· 3 min de lectura
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
| RF | Entregable |
|---|---|
| RF-TEC-019-03 | Sesión en cookie HttpOnly+Secure+SameSite (web, con CSRF) y almacén seguro (móvil) |
| RF-TEC-019-04 | Algoritmo 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) yccf_csrf(legible por JS). - El navegador envía la cookie en cada petición (
withCredentials); el cliente añadeX-CSRF-Token(leído deccf_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.
JwtStrategyextrae el token de la cabecera o de la cookie (doble canal);GET /auths/medevuelve 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ón | Por qué |
|---|---|
Cookie HttpOnly para la sesión | Inmune a XSS (JavaScript no la lee) |
Cookie CSRF (no HttpOnly) + cabecera | Double-submit: el atacante no puede leer la cookie ni fijar la cabecera |
| CSRF solo en canal cookie | El canal cabecera (móvil) no se auto-envía: es inmune |
| Doble canal | No rompe la app móvil ni clientes antiguos |
SameSite/Secure configurables | Cubre same-site (Lax) y cross-site (None+HTTPS) |
🖥️ API, Web y Móvil
- API:
cookie-parser,cookies.config/util,csrf.middleware, extractor dual enJwtStrategy/guards,GET /auths/me, gateways concredentials. - Web:
withCredentials, sinAuthorization(se limpian losBearer nullheredados), interceptor CSRF, hidratación por/me,sesiones-paneldesde el contexto. - Móvil (
mobile-app): token enexpo-secure-store; sigue con cabecera. - Configuración:
COOKIE_SESION_NOMBRE,COOKIE_CSRF_NOMBRE,COOKIE_SECURE,COOKIE_SAMESITE,COOKIE_DOMINIO.
🧪 Verificación
| Prueba | Resultado |
|---|---|
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 → 200 | Pendiente de entorno con BD |
| POST mutante sin CSRF → 403; con CSRF → 200 | Pendiente de entorno |
📎 Documentación
- Especificación: TEC-019
- Manual: Sesión en cookie y CSRF
- Validación de origen: Validación REQ-SEC-14
