Saltar a contenido

0007. Validación del access token de svc-identidad con su JWKS

Estado: Aceptado Fecha: 2026-10-05 Autor: David Garcia Módulo(s) afectado(s): app/core/security.py, app/core/config.py, app/main.py

Contexto

svc-identidad es el único que firma tokens: RS256, publica sus claves en un JWKS y el access token dura 15 minutos (sus ADR 0030 y 0031). Este servicio sólo verifica. python-jose es obligatorio (ADR 0001) y tiene CVE sin corregir, sobre todo en su código de curvas elípticas y JWE.

Decisión

  • La dependencia obtener_identidad (IdentidadActual) lee el Authorization: Bearer, verifica el token y devuelve una Identidad (usuario_id, username, tipo_usuario, empresa_id, permisos).
  • Sólo RS256: JWT_ALGORITHM es Literal["RS256"]; la cabecera debe traer alg=RS256 y un kid, y decode recibe algorithms=["RS256"].
  • Del JWKS sólo se aceptan claves kty=RSA de firma: nunca se usa el código EC de python-jose. Nunca JWE.
  • Se exigen iss, aud, exp, iat y sub, con tolerancia de reloj JWT_CLOCK_SKEW_SEC. El sub es un UUID y empresa_id un entero positivo.
  • El pre-token del login (scope=pre-auth) se rechaza.
  • ClienteJwks descarga el JWKS en el primer uso (no al arrancar), lo cachea por kid y vuelve a descargar ante un kid desconocido, como mucho una vez cada 30 s y una sola vez para requests concurrentes.
  • Cualquier token inválido responde 401 sin motivo; si el JWKS no se puede descargar, 503: el token puede ser válido.

Alternativas descartadas

  • Consultar a identidad en cada request — acopla la disponibilidad de este servicio a la de identidad y pierde el sentido del JWT.
  • Descargar el JWKS al arrancar — si identidad no responde, el servicio no arranca y sus sondas fallan.
  • Clave pública fija en la configuración — una rotación de identidad obligaría a redesplegar.

Consecuencias

  • Un permiso revocado sigue en el token hasta que expire (15 min): aceptado.
  • Si identidad cae, los tokens con claves ya cacheadas siguen funcionando.
  • Los kid inventados no generan más de una descarga cada 30 s.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.