SaToken认证授权快速上手

最新推荐文章于 2025-09-15 10:09:30 发布

原创

最新推荐文章于 2025-09-15 10:09:30 发布 · 3k 阅读

35 ·

CC 4.0 BY-SA版权

文章标签：

#springboot #SaToken

该文章已生成可运行项目，

SA-TOKEN认证授权快速上手

SaToken简介
认证授权实现
测试验证

SaToken简介

SaToken 是一个轻量级 Java 权限认证框架，主要解决：登录认证、权限认证、单点登录、OAuth2.0、分布式Session会话、微服务网关鉴权等一系列权限相关问题。Sa-Token 旨在以简单、优雅的方式完成系统的权限认证部分。SaToken官网，原理如下
请添加图片描述

认证授权实现

1 创建5张测试基础表

利用经典RBAC理论，创建5张基础表，用于模拟用户的角色和权限功能。
users用户表
在这里插入图片描述
role角色表

role_users角色用户表

promission权限表

role_promission角色权限表

可以看到
用户1zhangsan拥有admin和guest角色，拥有user-read、user-write、product-read、product-read四个权限。
用户2拥有guest角色，拥有user-read、product-read两个权限。

2 配置文件

pom.xml引入依赖

        <!-- Sa-Token 权限认证，在线文档：https://sa-token.cc -->
        <dependency>
            <groupId>cn.dev33</groupId>
            <artifactId>sa-token-spring-boot-starter</artifactId>
            <version>1.38.0</version>
        </dependency>

application-dev.yml增加配置

############## Sa-Token 配置 (文档: https://sa-token.cc) ##############
sa-token:
  # token 名称（同时也是 cookie 名称）
  token-name: satoken
  # token 有效期（单位：秒） 默认30天，-1 代表永久有效
  timeout: 2592000
  # token 最低活跃频率（单位：秒），如果 token 超过此时间没有访问系统就会被冻结，默认-1 代表不限制，永不冻结
  active-timeout: -1
  # 是否允许同一账号多地同时登录 （为 true 时允许一起登录, 为 false 时新登录挤掉旧登录）
  is-concurrent: true
  # 在多人登录同一账号时，是否共用一个 token （为 true 时所有登录共用一个 token, 为 false 时每次登录新建一个 token）
  is-share: true
  # token 风格（默认可取值：uuid、simple-uuid、random-32、random-64、random-128、tik）
  token-style: uuid
  # 是否输出操作日志
  is-log: true

3 Sa-Token的全局拦截器

@Configuration
public class SaTokenConfigure implements WebMvcConfigurer {
   
   
    // 注册 Sa-Token 拦截器，打开注解式鉴权功能
    @Override
    public void addInterceptors(InterceptorRegistry registry) {