elwin@sytadel:~$ ▋

sytadel-suite

Control plane de seguridad e identidad para equipos que construyen con agentes de IA.

# nota: Producto en desarrollo activo: el repo contiene servicios y prototipos funcionando, no un runtime hosteado production-ready. Las métricas de escala no aplican todavía — lo honesto es mostrar el modelo de seguridad y la arquitectura.

## problema

Los equipos que construyen software y automatizaciones con agentes de IA tienen que reconstruir desde cero la infraestructura de confianza: identidad y multi-tenancy, enforcement de políticas, secretos y vault, auditoría a prueba de manipulación, identidad de los agentes, MCP y aprobación humana de acciones sensibles.

  • Es trabajo de seguridad caro, fácil de hacer mal, y que distrae del dominio real del negocio.
  • Hacerlo mal no se nota hasta que es tarde: fuga entre tenants, un log alterado, un secreto expuesto.

## arquitectura

Monorepo de servicios desplegables de forma independiente, orquestados con docker-compose. Cada request se autentica en el borde, se autoriza contra política por tenant, y solo llega al vault como llamada server-to-server firmada.

  • auth-api — identidad, tenants y memberships; única fuente de verdad del plano de identidad.
  • zerotrust-api — gateway de enforcement: valida el JWT, resuelve política por tenant y firma la llamada downstream.
  • securechain-vault — documentos, cifrado, auditoría tamper-evident y notaría.
  • billing-api — planes, medición y sincronización de entitlements.
  • sytadel-mcp-server — expone herramientas tipadas sobre el plano de identidad para clientes MCP.
  • Sin foreign keys cross-service: los servicios resuelven tenants/memberships contra el directorio interno de auth-api.

## decisiones técnicas

  • Auditoría tamper-evident: hash-chain SHA-256, append-only forzado en la DB (trigger + REVOKE), seguro ante concurrencia (pg_advisory_xact_lock) y checkpoints anti-truncamiento anclados con timestamps RFC 3161.
  • Notarización de documentos: árbol de Merkle real (RFC 6962) + timestamps RFC 3161; fallback honesto SIMULATED cuando no hay TSA configurada — nunca una prueba falsa.
  • Cifrado en reposo: envelope encryption AES-256-GCM, data keys por tenant (DEK) e IV aleatorio por operación.
  • Zero-trust service-to-service: ningún servicio confía en un request no autenticado o sin firmar; la identidad se re-deriva de un JWT verificado y se lleva en un request canónico firmado.
  • IA como compilador de políticas: un LLM traduce lenguaje natural → RBAC, revisa accesos y clasifica anomalías de sesión — todo con evals (precisión/recall, costo, latencia).
  • MCP + human-in-the-loop: un agente LangGraph propone decisiones de acceso que una persona aplica.

## resultados

Regla rectora del proyecto: el MVP puede estar incompleto, pero no debe violar aislamiento de tenants, control de acceso, integridad de documentos ni auditabilidad.

  • Aislamiento de tenants forzado server-side desde el token verificado, nunca desde input del cliente.
  • Smoke tests que recorren el flujo auth → zerotrust → vault, incluyendo un caso negativo (la creación de tenant en el vault devuelve 409 porque es propiedad de auth-api).
  • Base común que habilitó extraer @elwinernst/nest-auth, el paquete npm de verificación de JWT compartido entre servicios.