跳到主要内容

菜单权限

本页展示了一个使用 jCasbin 进行基于菜单的访问控制的 Spring Boot 示例。同样的模式(策略 + 角色分配 + 菜单层级)可以应用于 Casbin 支持的其他语言。

1. 配置​

在 policy.csv 中定义角色–菜单权限、用户–角色分配以及菜单层级。完整示例:jCasbin menu permission。

1.1 概述​

策略文件定义了:(1) 哪些角色可以访问哪些菜单项,(2) 哪些用户拥有哪些角色,以及 (3) 菜单项之间的父–子关系。这些共同构成了基于角色的分层菜单可见性。

1.2 权限规则 (p)​

以 p 开头的行定义了某个角色 (sub) 是否可以对某个菜单项 (obj) 执行某个操作 (act)。效果 (eft) 为 allow 或 deny。

示例:

  • p, ROLE_ROOT, SystemMenu, read, allow 授予 ROLE_ROOT 对 SystemMenu 的读取权限。
  • p, ROLE_ROOT, UserMenu, read, deny 拒绝 ROLE_ROOT 对 UserMenu 的读取权限。

1.3 用户–角色分配 (g)​

以 g 开头的行将用户分配给角色并定义角色继承。用户获得其所有角色的权限并集。

示例:

  • g, user, ROLE_USER 将名为 user 的用户分配给 ROLE_USER。
  • g, ROLE_ADMIN, ROLE_USER 使 ROLE_ADMIN 继承 ROLE_USER 的所有权限。

1.4 菜单层级 (g2)​

以 g2 开头的行定义父–子菜单结构。

示例:

  • g2, UserSubMenu_allow, UserMenu 使 UserSubMenu_allow 成为 UserMenu 的子菜单。
  • g2, (NULL), SystemMenu 标记 SystemMenu 为没有父级的顶级菜单。

1.5 菜单权限继承​

  • 如果父菜单具有显式的 allow,除非子菜单有显式的 deny,否则其子菜单会继承 allow。因此,允许父菜单也会允许其子菜单。
  • 如果父菜单没有显式权限,但至少有一个子菜单具有 allow,则父菜单被视为 allow,以便用户可以访问该子菜单。

1.6 Deny 与角色继承​

  • 显式 deny 优先:如果一个角色被显式拒绝访问某个菜单,任何从该角色继承的角色也会被拒绝。Deny 不会被继承覆盖。
  • 隐式 deny(没有 allow 规则)是可以覆盖的:更高权限的角色可以为该菜单添加显式的 allow。

1.7 示例策略​

p, ROLE_ROOT, SystemMenu, read, allow
p, ROLE_ROOT, AdminMenu, read, allow
p, ROLE_ROOT, UserMenu, read, deny
p, ROLE_ADMIN, UserMenu, read, allow
p, ROLE_ADMIN, AdminMenu, read, allow
p, ROLE_ADMIN, AdminSubMenu_deny, read, deny
p, ROLE_USER, UserSubMenu_allow, read, allow

g, user, ROLE_USER
g, admin, ROLE_ADMIN
g, root, ROLE_ROOT
g, ROLE_ADMIN, ROLE_USER

g2, UserSubMenu_allow, UserMenu
g2, UserSubMenu_deny, UserMenu
g2, UserSubSubMenu, UserSubMenu_allow
g2, AdminSubMenu_allow, AdminMenu
g2, AdminSubMenu_deny, AdminMenu
g2, (NULL), SystemMenu
MenuNameROLE_ROOTROLE_ADMINROLE_USER
SystemMenu✅❌❌
UserMenu❌✅❌
UserSubMenu_allow❌✅✅
UserSubSubMenu❌✅✅
UserSubMenu_deny❌✅❌
AdminMenu✅✅❌
AdminSubMenu_allow✅✅❌
AdminSubMenu_deny✅❌❌

2. 强制实施菜单权限​

在 jCasbin menu permission 示例中,MenuService 提供了 findAccessibleMenus()(用户可以看到的所有菜单)和 checkMenuAccess()(检查单个菜单)。两者底层均使用 jCasbin enforcer。

Comments are powered by giscus and GitHub Discussions. They load from giscus.app and GitHub only after you click the button below.