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 elAuthorization: Bearer, verifica el token y devuelve unaIdentidad(usuario_id,username,tipo_usuario,empresa_id,permisos). - Sólo RS256:
JWT_ALGORITHMesLiteral["RS256"]; la cabecera debe traeralg=RS256y unkid, ydecoderecibealgorithms=["RS256"]. - Del JWKS sólo se aceptan claves
kty=RSAde firma: nunca se usa el código EC de python-jose. Nunca JWE. - Se exigen
iss,aud,exp,iatysub, con tolerancia de relojJWT_CLOCK_SKEW_SEC. Elsubes un UUID yempresa_idun entero positivo. - El pre-token del login (
scope=pre-auth) se rechaza. ClienteJwksdescarga el JWKS en el primer uso (no al arrancar), lo cachea porkidy vuelve a descargar ante unkiddesconocido, 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
kidinventados 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.