身份认证与应用安全 / 系统课时

建模角色与权限标识

建模角色与权限标识

接口鉴权如果只使用“管理员、普通用户”这类角色,很快会遇到粒度不足的问题。本篇把角色与业务权限拆成两类稳定标识,并用可执行代码固化命名规则,使后续 Spring Security 鉴权既能表达身份分组,也能精确限制具体操作。

学习目标

  • 区分角色与细粒度 permission 各自适合解决的问题
  • 设计可直接映射为 Spring Security authority 的命名规则
  • 避免把角色、权限和业务状态混成同一种标识

两类标识解决不同粒度的问题

角色表示一组相对稳定的身份或职责,例如 ROLE_ADMIN、ROLE_USER。它适合回答“这个用户属于哪一类人”,常用于保护后台入口或一组功能。

业务权限表示一个明确动作,例如 order:read、order:refund。它适合回答“这个用户能否执行某项操作”,尤其适用于同一角色内部仍存在授权差异的系统。

类型 示例 适合的判断
角色 ROLE_ADMIN 是否属于管理员角色
权限 order:read 是否可以读取订单
权限 order:refund 是否可以执行退款

在 Spring Security 中,两者最终都可以表示为 authority 字符串。区别主要来自业务语义以及鉴权 API 的使用方式:默认配置下,hasRole("ADMIN") 会按 ROLE_ADMIN 检查,而 hasAuthority("order:refund") 会按传入字符串精确匹配。

设计稳定的命名规则

角色建议统一使用 ROLE_ 前缀,并保持名称数量有限,例如 ROLE_ADMIN、ROLE_OPERATOR。不要为每个按钮或接口创建一个角色,否则角色会退化成另一套难以维护的权限列表。

细粒度权限可以采用 资源:动作 形式,例如 user:read、user:update、order:refund。资源和动作都使用稳定的业务词汇,不要把用户 ID、订单 ID 等运行时数据编码进权限名称。

角色和权限也不应承担业务状态的职责。例如“订单已付款”是订单状态,不应建模为 ROLE_PAID 或 order:paid-user。鉴权负责判断主体有没有资格执行动作,业务代码再判断当前对象是否允许该动作。

用代码固化角色与权限边界

下面的示例使用枚举约束角色名称,并用值对象检查 permission 是否符合 资源:动作 结构。它可以直接在 Java 17 及以上环境运行,不依赖 Spring Security。

java
import java.util.List;

public class RolePermissionModelDemo {
    enum Role {
        ROLE_ADMIN,
        ROLE_USER
    }

    record Permission(String value) {
        Permission {
            // 在模型入口统一限制权限格式,避免各业务模块自行拼接不同风格的名称。
            if (!value.matches("[a-z][a-z0-9-]*:[a-z][a-z0-9-]*")) {
                throw new IllegalArgumentException("permission must be resource:action");
            }
        }
    }

    public static void main(String[] args) {
        Role role = Role.ROLE_ADMIN;
        List<Permission> permissions = List.of(
                new Permission("order:read"),
                new Permission("order:refund")
        );

        System.out.println(role.name());
        permissions.forEach(permission -> System.out.println(permission.value()));
    }
}

预期输出:

text
ROLE_ADMIN
order:read
order:refund

实际项目可以把角色和权限持久化到数据库,也可以通过角色与权限的关联表复用权限集合;关键不是表名,而是保证最终产生的标识稳定且语义唯一。

避免把授权模型做得过细或过粗

只使用 ROLE_ADMIN 一类粗粒度角色,会迫使管理员拥有所有后台能力;反过来,如果所有访问控制都直接绑定数百个 permission,账号配置又会变得难以维护。常见做法是让角色负责批量授予权限,而真正敏感的业务接口按 permission 判断。

因此,角色更像权限集合的业务分组,permission 才是精确授权的基本单位。后续无论这些标识来自数据库还是 JWT,只要最终保持相同字符串,就可以统一转换为 Spring Security 的 GrantedAuthority。

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

目录与阅读设置

阅读设置

17

记录一个想法

建模角色与权限标识

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

登录哪都通