架构与系统设计 / 系统课时

功能权限模型

功能权限模型

本课将把用户、角色、菜单、按钮和接口组织成一套可落地的租户内权限模型,并通过接口校验示例说明权限如何从“页面可见”延伸到“请求可执行”。

学习目标

  • 理解用户、角色与权限资源之间的关联关系
  • 能为菜单、按钮和接口设计统一且稳定的权限标识
  • 能在接口层同时校验租户边界与功能权限

从业务动作定义权限

功能权限回答的是“当前用户能否执行某个动作”。建模时不要直接把页面名称当作权限,而应从业务资源和动作出发,例如 order:read、order:refund、member:create。这样即使前端菜单重构,后端授权规则也不会随界面布局变化。

一个权限标识通常由“资源:动作”组成。资源名称保持稳定,动作使用有限词汇,如 read、create、update、delete、approve、export。对于高风险动作,应单独定义权限,避免用一个宽泛的 manage 覆盖全部操作。

建立租户内关联关系

用户不直接绑定大量权限,而是通过角色获得权限。推荐的关联链路是“租户用户 → 用户角色 → 角色 → 角色权限 → 权限资源”,菜单和按钮只是权限资源在前端的表现形式,接口则是后端的最终执行入口。

租户内功能权限关联模型

数据库中至少需要用户、角色、权限资源三张主表,以及用户角色、角色权限两张关联表。所有租户内表都应带有 tenant_id,并在唯一约束中包含租户字段,例如同一租户内角色编码唯一,而不同租户可以使用相同角色编码。

让菜单、按钮和接口各司其职

菜单权限决定页面是否可见,按钮权限决定页面上的操作入口是否显示,接口权限决定请求能否真正执行。三者可以使用同一个权限标识,也可以按需要拆分,但后端绝不能依赖前端隐藏按钮来保证安全。

权限载体 主要职责 是否属于安全边界
菜单 控制导航与页面入口 否
按钮 控制页面操作入口 否
接口 拦截实际业务请求 是

前端可以根据权限集合提升体验,后端必须再次校验。即使用户手工构造请求,只要缺少接口所需权限,服务端也应返回拒绝结果。

在接口层完成最终校验

下面的可运行示例同时检查租户一致性和权限标识。真实项目中,当前租户通常来自登录令牌或租户上下文,资源租户来自数据库查询结果。

java
import java.util.Set;

public class PermissionDemo {

    static boolean canAccess(
            String currentTenant,
            String resourceTenant,
            Set<String> permissions,
            String requiredPermission) {
        // 先阻断跨租户访问,再判断具体功能权限
        if (!currentTenant.equals(resourceTenant)) {
            return false;
        }
        return permissions.contains(requiredPermission);
    }

    public static void main(String[] args) {
        Set<String> permissions = Set.of("order:read", "order:refund");

        System.out.println(canAccess(
                "tenant-a", "tenant-a", permissions, "order:refund"));
        System.out.println(canAccess(
                "tenant-a", "tenant-b", permissions, "order:refund"));
        System.out.println(canAccess(
                "tenant-a", "tenant-a", permissions, "member:delete"));
    }
}

预期输出:

text
true
false
false

第一条请求同时满足租户边界和功能权限,因此通过;第二条请求跨租户,直接拒绝;第三条请求属于同一租户,但缺少所需权限,也会被拒绝。

设计时的关键边界

  • 角色、用户角色和角色权限关联必须限制在同一 tenant_id 下
  • 权限标识应稳定,不要与路由路径、按钮文案或菜单层级强绑定
  • 删除角色或权限前,应检查关联关系并保留必要的审计记录

本课总结

  • 功能权限应围绕“资源:动作”建模,并通过角色批量授予用户
  • 菜单和按钮负责交互体验,接口权限才是最终安全边界
  • 每次授权判断都应同时满足租户隔离和功能权限两个条件

下一课预告

下一课将区分平台管理员、租户管理员和普通成员,明确不同角色可以管理哪些对象,以及哪些权限绝不能跨边界下放。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

功能权限模型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通