Roles y permisos
Última actualización:
Lo que aprenderás
- Permisos que resuelve cada rol al emitir la sesión.
- Dónde se aplica cada permiso (menú, ruta, servidor).
- Reglas de asignación, revocación y licencia.
RolePermissionResolver traduce el rol en un conjunto de permisos al emitir la sesión. Los permisos
viajan como claim del JWT (lista separada por espacios). La autorización se evalúa sobre el claim,
sin consulta a base de datos.
- Loginrol → conjunto de permisos → claim permissions del JWT
- presentaciónClientemenú, bloqueo de ruta y controles de escritura desde la misma tabla de áreas
- aplicaciónServidor[RequirePermission] por endpoint; 403 si falta
La aplicación efectiva es la del servidor. La del cliente sólo evita ofrecer acciones no autorizadas.
Permisos
Sección titulada «Permisos»| Código | Alcance |
|---|---|
org.read / org.manage |
organización: datos, marca, 2FA obligatorio, acceso de soporte |
users.read / users.manage |
usuarios: listado; invitación, rol, estado, reset de 2FA |
inventory.read / inventory.write |
StaticSite, Face, DisplayUnit, importaciones |
campaigns.read / campaigns.write |
campañas garantizadas y estáticas, reservas, CRM |
programmatic.read / programmatic.write |
configuración de subasta, deals, aprobación de demanda |
devices.read / devices.pair |
estado de players; emparejar, liberar, desconectar |
settings.read / settings.write |
ajustes de plataforma |
billing.read / billing.write |
subledger, rentabilidad; factura, disputa, costos de estructura |
operations.read / operations.write |
órdenes de trabajo, producción, testigos |
● = concedido.
| Permiso | super_admin | admin | manager | sales | operations | field_tech | finance | viewer |
|---|---|---|---|---|---|---|---|---|
org.read |
● | ● | ● | ● | ● | ● | ● | ● |
org.manage |
● | ● | ||||||
users.read |
● | ● | ● | ● | ● | ● | ||
users.manage |
● | ● | ||||||
inventory.read |
● | ● | ● | ● | ● | ● | ● | |
inventory.write |
● | ● | ● | |||||
campaigns.read |
● | ● | ● | ● | ● | ● | ● | |
campaigns.write |
● | ● | ● | ● | ||||
programmatic.read |
● | ● | ● | ● | ● | ● | ||
programmatic.write |
● | ● | ● | |||||
devices.read |
● | ● | ● | ● | ● | ● | ||
devices.pair |
● | ● | ● | |||||
settings.read |
● | ● | ● | ● | ||||
settings.write |
● | ● | ||||||
billing.read |
● | ● | ● | ● | ||||
billing.write |
● | ● | ||||||
operations.read |
● | ● | ● | ● | ● | |||
operations.write |
● | ● | ● | ● | ● |
- Asignación: un usuario sólo puede otorgar un rol cuyo conjunto de permisos es subconjunto del
suyo (
CanGrant).super_adminno es asignable desde el CMS. - Autoprotección: nadie modifica su propio rol ni su propio estado. La organización conserva siempre al menos un administrador activo.
- Revocación: cambio de rol, desactivación o reset de contraseña incrementan
User.TokenVersiony revocan las sesiones. El claimtvse valida por petición con caché de 30 s: la revocación es efectiva en ≤ 30 s. - Licencia:
[RequireFeature]se evalúa además del permiso. Sin el módulo,403 feature_not_enabledpara cualquier rol. - Fallback: todo endpoint exige usuario autenticado salvo
[AllowAnonymous]explícito.