elwin@sytadel:~$ ▋

auth-api

Proveedor de identidad multi-tenant: el plano de confianza de Sytadel, usable también de forma standalone.

## problema

Toda app que crece necesita identidad multi-tenant bien hecha: usuarios, tenants, roles, sesiones, rotación de tokens y passkeys. Reimplementarla por servicio lleva a inconsistencias y agujeros de seguridad.

  • En una suite de microservicios aparece una pregunta extra: ¿quién es el dueño de la verdad de identidad?
  • Si cada servicio guarda su propia copia de tenants y roles, tarde o temprano divergen.

## arquitectura

IdP autocontenido que solo necesita PostgreSQL. Modelo tenant → membership → rol (OWNER / ADMIN / MEMBER) con emisión de JWT tenant-scoped.

  • Única fuente de verdad de tenants y memberships: los demás servicios NO tienen foreign keys locales a identidad.
  • La consultan por un directorio interno server-to-server, protegido por secreto + HMAC compartido (no expuesto públicamente).
  • API pública (login / refresh / logout / logout-all / me) + endpoints internos (resolver tenants y memberships, provisioning).
  • Usable como el IdP de tu propia app aunque no adoptes el resto de la suite.

## decisiones técnicas

  • JWT HS256 fijado (sin alg:none ni algorithm confusion), con issuer, audience y expiración verificados y secretos separados para access y refresh.
  • Rotación de refresh tokens con detección de reuso: si se reusa un refresh, se revoca toda la familia de tokens.
  • Passkeys / WebAuthn resistentes a enumeración de cuentas.
  • Provisioning idempotente: recibe una idempotencyKey firmada; reintentos del mismo solicitante y clave devuelven el mismo resultado, y reusar la clave con datos distintos se rechaza.
  • El secreto de la service-account se cifra con AES-256-GCM en reposo.
  • El schema es propiedad de las migraciones (migrationsRun en el arranque, synchronize OFF).

## resultados

  • Es el único servicio de la suite que corre de forma totalmente independiente — portable a cualquier app como IdP.
  • Sirvió de base para extraer la lógica de verificación de JWT al paquete npm @elwinernst/nest-auth.