Identity and authorization

OIDC, RBAC and memberships (ADR-034).

Source: docs/adr/ADR-034-identity-and-authorization.md

ADR-034: Identidad, Google OIDC y autorización

Estado: Accepted — 2026-11-12. Ratificación humana explícita en aprobación de plataforma; conserva las decisiones Accepted previas.

Contexto

El producto requiere clientes externos, usuarios internos y pertenencia a organizaciones. Se propone OIDC con Google y login email verificado, sesiones seguras y mecanismos de recovery. El proveedor concreto queda abierto. No usar Google como única vía para cuentas corporativas.

Decisión

  1. User, IdentityProviderAccount, OrganizationMembership y Role son conceptos distintos.
  2. Autorizar todos los recursos desde backend mediante policy por objeto y contexto; el route guard es insuficiente.
  3. Roles iniciales: platform_admin, sales, project_manager, finance, support, client_owner, client_member; matriz detallada en brief.
  4. Invitaciones verificadas para vincular un User a Organization, verificación de email y prevención de account takeover por enlace automático de identidades.
  5. MFA para perfiles internos privilegiados; cookies HttpOnly/Secure/SameSite y CSRF según el flujo elegido; logs sin tokens ni PII.

Alternativas y trade-offs

  • Reutilizar conceptos validados de FoodHUB, sin trasplantar automáticamente su dominio restaurante, tenancy o código.
  • Mantener una solución modular y evolutiva antes de añadir servicios y proveedores.
  • El uso del proveedor concreto, sesiones y políticas de retention requiere spike de seguridad.

Consecuencias

Este ADR orienta briefs, specs, controles y pruebas. No autoriza implementar features sin DOC-012/DOC-013. Revisión de privacidad/seguridad/finanzas antes del release pertinente.

Referencias

DOC-001 v2.0 · DOC-002 · DOC-017 · DOC-018 · ADR-010/011/012/013/014/015/024/025/032/033.