Ir al contenido

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.

  1. Loginrol → conjunto de permisos → claim permissions del JWT
  2. presentación
    Clientemenú, bloqueo de ruta y controles de escritura desde la misma tabla de áreas
  3. aplicación
    Servidor[RequirePermission] por endpoint; 403 si falta
Resolución y aplicación de permisos.

La aplicación efectiva es la del servidor. La del cliente sólo evita ofrecer acciones no autorizadas.

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_admin no 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.TokenVersion y revocan las sesiones. El claim tv se 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_enabled para cualquier rol.
  • Fallback: todo endpoint exige usuario autenticado salvo [AllowAnonymous] explícito.