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

检查用户是否拥有指定权限

检查用户是否拥有指定权限

角色适合表达“谁”,权限标识更适合表达“能做什么”。本课把新增、修改、删除等操作拆成独立权限码,并用 StpUtil.hasPermission 与 StpUtil.checkPermission 在业务入口做精确校验,避免一个角色被授予过大的操作范围。

学习目标

  • 能为具体业务动作设计稳定、可读的权限标识
  • 能区分布尔判断与异常式权限校验的适用场景
  • 能验证不同账号对同一操作得到不同授权结果

从角色判断下沉到操作权限

“管理员可以管理用户”通常仍然太粗。真实接口往往需要分别控制查询、新增、修改、删除,例如 user.read、user.add、user.update、user.delete。权限码应描述业务能力,而不是页面名称或按钮位置,这样同一规则才能复用于 HTTP 接口、后台任务和其他调用入口。

Sa-Token 会在鉴权时读取当前账号的权限集合,再判断目标权限是否存在。项目需要实现 StpInterface#getPermissionList 告诉框架某个账号拥有哪些权限;StpUtil.hasPermission 返回布尔值,StpUtil.checkPermission 在不满足时抛出 NotPermissionException。([GitHub][1])

选择 hasPermission 还是 checkPermission

hasPermission("user.delete") 适合“根据权限决定页面数据、菜单或分支逻辑”的场景,因为调用方可以自行处理 true 或 false。如果当前操作没有权限就必须立即终止,更适合使用 checkPermission("user.delete"),让鉴权失败直接中断后续业务代码。

多个权限同时校验时,checkPermissionAnd 表示必须全部具备,checkPermissionOr 表示任意一个通过即可。权限判断应尽量靠近受保护的业务入口,避免先执行写库、发消息等副作用,再补做鉴权。

用两个账号验证权限差异

下面是项目内可运行示例。前提是 Spring Boot 项目已经引入与自身版本匹配的 Sa-Token starter 和 Spring Web;示例把权限数据写死,只用于观察鉴权行为,生产环境应从数据库或权限服务加载。

java
package com.example.permissiondemo;

import cn.dev33.satoken.stp.StpInterface;
import cn.dev33.satoken.stp.StpUtil;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@SpringBootApplication
public class PermissionDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(PermissionDemoApplication.class, args);
    }

    @RestController
    static class DemoController {

        @PostMapping("/demo/login/{id}")
        String login(@PathVariable long id) {
            StpUtil.login(id);
            return StpUtil.getTokenValue();
        }

        @GetMapping("/demo/can-add")
        boolean canAdd() {
            return StpUtil.hasPermission("user.add");
        }

        @PostMapping("/demo/users")
        String addUser() {
            // 没有 user.add 时直接抛出 NotPermissionException。
            StpUtil.checkPermission("user.add");
            return "created";
        }
    }

    @Component
    static class PermissionProvider implements StpInterface {

        @Override
        public List<String> getPermissionList(Object loginId, String loginType) {
            // 账号 1 可新增用户,账号 2 只有读取权限。
            return "1".equals(String.valueOf(loginId))
                    ? List.of("user.read", "user.add")
                    : List.of("user.read");
        }

        @Override
        public List<String> getRoleList(Object loginId, String loginType) {
            return List.of();
        }
    }
}

启动应用后,先登录账号 1。实际端口和 Token 值可能不同,因此用 <PORT>、<TOKEN> 表示动态值。

bash
curl -X POST http://localhost:<PORT>/demo/login/1
curl -H "satoken: <TOKEN>" http://localhost:<PORT>/demo/can-add
curl -X POST -H "satoken: <TOKEN>" http://localhost:<PORT>/demo/users

预期输出

text
<TOKEN>
true
created

如果改为登录账号 2,再请求 /demo/can-add 会得到 false;请求 /demo/users 时控制器不会返回 created,而是由 checkPermission 抛出 NotPermissionException。最终 HTTP 状态码和响应体取决于项目如何配置全局异常处理,不应硬编码成某一种格式。

权限码设计的边界

权限码最好保持稳定且面向业务动作。例如将“用户删除”固定为 user.delete,而不是把 /admin/user/delete 这样的 URL 当作权限码。接口路径可以调整,业务权限通常不应随路由重构一起变化。

当角色只负责聚合权限、接口最终按具体动作校验时,授权模型会更容易审计:角色变化只影响权限集合,接口仍只关心自己需要的那个业务能力。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查用户是否拥有指定权限

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

登录哪都通