0040. Naming canónico de los claims JWT de plataforma: godexerp¶
Estado: Aceptado Fecha: 2026-10-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/core/config.py, app/core/security.py, tests/unit/core/, docs/adr/
Contexto¶
Los claims fijos de plataforma (iss y aud) estaban inconsistentes entre
el código y la documentación:
| Lugar | Valor que tenía |
|---|---|
app/core/config.py (default) |
com.godex.identidad / com.godex.plataforma |
docs/adr/0007 |
com.sigfa.identidad / com.sigfa.plataforma |
.env |
com.godexerp.identidad (a medias) |
Todos los servicios de la plataforma verifican iss y aud al validar un
token (ADR 0006 transversal), así que tienen que ser el mismo valor en todos.
Con tres valores circulando, un token emitido por un servicio no lo acepta otro,
y no queda claro cuál es el correcto.
Decisión¶
El naming canónico es godexerp:
iss = com.godexerp.identidad(lo emite este servicio)aud = com.godexerp.plataforma(lo consumen todos)
Se fijan como defaults en app/core/config.py, se corrigen los docstrings y
los tests, y se actualizan las referencias de valor en ADR 0007 y 0030.
Alternativas descartadas¶
- Mantener
com.godex.*— es el nombre viejo de la plataforma; ya hay servicios y.envcongodexerp. - Mantener
com.sigfa.*— sólo aparecía en la doc; nunca en el código. - No documentarlo — perpetúa la inconsistencia y el próximo servicio vuelve a inventar un prefijo.
Consecuencias¶
- Los cuatro servicios (
identidad,documents,workflow,notificaciones) y el gateway deben usar el mismoiss/auda la vez; si no, los tokens cruzados se rechazan. - Los tokens emitidos con el valor viejo quedan inválidos: todos re-loguean.
- El JWKS no cambia: sólo cambian los claims, no la clave de firma.
- Se actualizan los valores fijados en ADR 0007 y 0030.
Qué no cubre¶
- Rotar la clave de firma (eso sí cambiaría el JWKS): es otra decisión.
- RLS a nivel de base: sigue sin middleware en este servicio.