身份认证与应用安全 / 系统课时
建模角色与权限标识
建模角色与权限标识
接口鉴权如果只使用“管理员、普通用户”这类角色,很快会遇到粒度不足的问题。本篇把角色与业务权限拆成两类稳定标识,并用可执行代码固化命名规则,使后续 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。
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()));
}
}预期输出:
ROLE_ADMIN
order:read
order:refund实际项目可以把角色和权限持久化到数据库,也可以通过角色与权限的关联表复用权限集合;关键不是表名,而是保证最终产生的标识稳定且语义唯一。
避免把授权模型做得过细或过粗
只使用 ROLE_ADMIN 一类粗粒度角色,会迫使管理员拥有所有后台能力;反过来,如果所有访问控制都直接绑定数百个 permission,账号配置又会变得难以维护。常见做法是让角色负责批量授予权限,而真正敏感的业务接口按 permission 判断。
因此,角色更像权限集合的业务分组,permission 才是精确授权的基本单位。后续无论这些标识来自数据库还是 JWT,只要最终保持相同字符串,就可以统一转换为 Spring Security 的 GrantedAuthority。