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
- User, IdentityProviderAccount, OrganizationMembership y Role son conceptos distintos.
- Autorizar todos los recursos desde backend mediante policy por objeto y contexto; el route guard es insuficiente.
- Roles iniciales: platform_admin, sales, project_manager, finance, support, client_owner, client_member; matriz detallada en brief.
- Invitaciones verificadas para vincular un User a Organization, verificación de email y prevención de account takeover por enlace automático de identidades.
- 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.