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

组合多个权限判断条件

组合多个权限判断条件

当一个接口同时要求“具备多个权限”“满足任一权限”,或允许特定角色作为例外通道时,关键不是堆更多注解,而是先把授权规则写成清晰的 AND/OR 关系,再选择 Sa-Token 对应的表达方式。

学习目标

  • 区分 SaMode.AND 与 SaMode.OR 的适用场景
  • 用权限、角色和 orRole 表达常见组合条件
  • 识别复杂组合中容易放宽授权范围的写法

先把条件写成布尔关系

@SaCheckPermission 和 @SaCheckRole 都支持 mode。同一注解中列出多个值时,默认是 SaMode.AND:全部满足才通过;显式设置为 SaMode.OR 后,只要满足其中一个即可。

业务规则 推荐写法
同时具备 order:update 和 order:audit @SaCheckPermission,默认 AND
具备两项权限中的任意一项 @SaCheckPermission(..., mode = SaMode.OR)
具备 order:approve 或角色 admin @SaCheckPermission(..., orRole = "admin")
同时具备角色 auditor 和权限 order:approve 同一方法叠加 @SaCheckRole 与 @SaCheckPermission

多个普通鉴权注解叠加在同一个方法上时,关系天然是 AND。需要跨不同注解类型做 OR 时,可以使用 @SaCheckOr;如果只是“某权限或某角色”,orRole 更直接。([GitHub][1])

用注解表达常见组合

片段示例:以下控制器放在已经启用 Sa-Token 注解鉴权的 Spring Boot 工程中。权限标识和角色标识应与项目的 StpInterface 返回值保持一致。

java
package com.example.auth;

import cn.dev33.satoken.annotation.SaCheckPermission;
import cn.dev33.satoken.annotation.SaCheckRole;
import cn.dev33.satoken.annotation.SaMode;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/orders")
public class OrderAuthController {

    @GetMapping("/edit-and-audit")
    @SaCheckPermission({"order:update", "order:audit"})
    public String editAndAudit() {
        return "AND passed";
    }

    @GetMapping("/edit-or-audit")
    @SaCheckPermission(
            value = {"order:update", "order:audit"},
            mode = SaMode.OR
    )
    public String editOrAudit() {
        return "OR passed";
    }

    @GetMapping("/approve-by-permission-or-admin")
    @SaCheckPermission(value = "order:approve", orRole = "admin")
    public String approveByPermissionOrAdmin() {
        return "permission-or-role passed";
    }

    @GetMapping("/auditor-approve")
    @SaCheckRole("auditor")
    @SaCheckPermission("order:approve")
    public String auditorApprove() {
        return "role-and-permission passed";
    }
}

验证 OR 接口时,可使用一个已登录且只拥有 order:update 权限的令牌。若项目修改过 token 名称,请把请求头中的 satoken 替换为实际配置值。

bash
curl -s "http://localhost:<PORT>/orders/edit-or-audit"   -H "satoken: <TOKEN>"

预期输出

text
OR passed

这里的 <PORT> 和 <TOKEN> 需要替换为实际端口与登录令牌。相同账号若访问 /orders/edit-and-audit,因为缺少 order:audit,请求会在进入控制器方法前被拒绝。

复杂条件优先拆成可读规则

授权条件一旦出现多层括号,例如“必须是审计员,并且拥有导出或复核权限”,先写成 (role:auditor) AND (report:export OR report:review),再分别映射到角色校验和权限 OR 校验。这样比在业务代码里混用多次 hasPermission 判断更容易审查。

如果权限集合是运行时动态生成的,注解不再合适,可以改用 StpUtil.checkPermissionAnd(...) 或 StpUtil.checkPermissionOr(...)。无论使用哪种方式,都应让接口的授权规则只有一个明确入口,避免控制器、服务层和前端各自维护一套条件。

防止 OR 条件意外放宽权限

OR 最常见的风险是把原本必须同时满足的条件写成“任一通过”。例如审批接口真正要求“审计员且可审批”,就不应使用 orRole = "auditor",因为这会变成“有审批权限或是审计员”。

设计组合条件时,先明确哪些是必选条件、哪些是替代条件,再选 AND、OR 或 orRole。这样可以让权限配置与业务语义一一对应,也更容易通过接口测试验证边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

组合多个权限判断条件

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

登录哪都通