0025. Autenticación: naming godexerp, claims nuevos y dos tokens de autorización¶
Estado: Aceptado
Fecha: 2026-10-22
Autor: Duval Alcivar
Módulo(s) afectado(s): svc-identidad (core_sigfa), todos los servicios que validan tokens y claims
Modifica a: ADR 0010, ADR 0011, ADR 0018, ADR 0020
Origen: ADR 0030 de implementación, ADR 0040 de implementación, ADR 0042 de implementación, ADR 0045 de implementación, ADR 0046 de implementación, ADR 0047 de implementación, ADR 0048 de implementación, ADR 0049 de implementación
Contexto¶
Los ADR 0010, 0011, 0018 y 0020 describen el flujo de acceso correcto, pero fijaron el espacio de nombres com.sigfa.* y un conjunto de claims que la implementación amplió. Un servicio que valide tokens con la especificación vieja rechaza los tokens reales.
Decisión¶
- El namespace pasa a
com.godexerp.*:iss = com.godexerp.identidad,aud = com.godexerp.plataforma, reemplazando lo fijado en 0011, 0018 y 0020. - Access token de 15 minutos (antes 30); refresh de 30 días y pre-token de 5 minutos se confirman; Argon2id 64 MiB,
t=3,p=1se confirman. - Claims nuevos en el access:
usuario_id(mismo valor quesub),empresa_nombre(presentación,nullsi la empresa no existe o está borrada, nunca autoriza) yentidad_id(entidad party del usuario). permisosse omite pararoot(acceso implícito).- El refresh opaco pasa a
{empresa_id}.{128 hex}para resolver la RLS antes de autenticar; se sigue guardando solo su SHA-256. POST /auth/cambiar-empresareemplaza/auth/login/empresapara cambiar de empresa dentro de la sesión.- El login administrativo es un
POSTexclusivo derootque emite un token conscope=admin, separado del token de tenant; la administración global usa ese token con poolBYPASSRLS.
Alternativas descartadas¶
- Mantener
com.sigfa.*— los tokens reales ya se emiten comocom.godexerp.*; un validador con la spec vieja los rechaza. - Refresh sin prefijo de empresa — obliga a resolver la empresa después de autenticar, justo cuando la RLS ya debería estar activa.
- Un solo token con doble rol — mezcla dos superficies de autorización y permite que un token de tenant alcance la administración global.
Consecuencias¶
Los consumidores deben revalidar iss, aud y los claims antes de desplegar; el cambio es incompatible con tokens ya emitidos. La separación de tokens deja la administración global explícitamente acotada, a costa de dos flujos de login y dos pools que mantener.
Se incorporó a este sitio el 2026-11-09. La fecha del ADR corresponde a la última decisión de implementación que resume, no a la fecha de publicación en este sitio.