$ cd ../proyectos ⌃O / -
elwin@sytadel:~$ ▋
auth-api
Proveedor de identidad multi-tenant: el plano de confianza de Sytadel, usable también de forma standalone.
- NestJS
- TypeORM
- PostgreSQL
- WebAuthn
- JWT
## 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.