Saltar a contenido

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=1 se confirman.
  • Claims nuevos en el access: usuario_id (mismo valor que sub), empresa_nombre (presentación, null si la empresa no existe o está borrada, nunca autoriza) y entidad_id (entidad party del usuario).
  • permisos se omite para root (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-empresa reemplaza /auth/login/empresa para cambiar de empresa dentro de la sesión.
  • El login administrativo es un POST exclusivo de root que emite un token con scope=admin, separado del token de tenant; la administración global usa ese token con pool BYPASSRLS.

Alternativas descartadas

  • Mantener com.sigfa.* — los tokens reales ya se emiten como com.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.