dromara /Sa-Token
✨ 开源、免费、一站式 Java 权限认证框架,让鉴权变得简单、优雅!—— 登录认证、权限认证、分布式 Session 会话、微服务网关鉴权、SSO 单点登录、OAuth2.0 统一认证、jwt 集成、API Key 秘钥授权、API 参数签名
★ 19,113⑂ 2,913👁 153⑃ 197● 781▤ 40
More from this author
-1
Daily
+6
Weekly
+28
Monthly
19,113
stars
2,913
forks
153
watchers
197
prs
781
issues
40
releases
README
简体中文 | 繁體中文 | English | 日本語 | 한국어 | Русский
Sa-Token v1.46.0
✨ 开源、免费、一站式 java 权限认证框架,让鉴权变得简单、优雅!
--
--
学习测试请拉取 master 分支,dev 是在开发分支 (在根目录执行 git checkout master) --
在线文档:https://sa-token.com
|
需求提交
---
📝 前言:
回望 2020 年初,我为 Sa-Token 提交第一行代码之际,彼时市面上 Java 缺少的不仅是一个简洁好用的鉴权框架,更是一整套清晰、自洽的权限架构设计思想。
因此,这几年间我将大量时间倾注在 Sa-Token 的文档编写,几乎每一章节、每一句话、每一个字都经过反复修改、精细打磨,以求做到最清晰、干练、易懂的表述。用心阅读文档,你学习到的将不止是 Sa-Token 框架本身,更是绝大多数场景下权限认证设计的最佳实践。
🛠️ Sa-Token 介绍
Sa-Token 是一个轻量级 Java 权限认证框架,目前拥有五大核心模块:登录认证、权限认证、单点登录、OAuth2.0、微服务鉴权。
你还在手搓以下功能?Stop,让 Sa-Token 来!
!sa-token-jss
要在 SpringBoot 项目中使用 Sa-Token,你只需要在 pom.xml 中引入依赖:
xml
cn.dev33
sa-token-spring-boot-starter
1.46.0
除了支持 SpringBoot2、Sa-Token 还为 SpringBoot3/4、Solon、JFinal 等常见 Web 框架提供集成包,做到真正的开箱即用。
简单示例展示:(点击展开 / 折叠)
Sa-Token 旨在以简单、优雅的方式完成系统的权限认证部分,以登录认证为例,你只需要:
java
// 会话登录,参数填登录人的账号id
StpUtil.login(10001);
无需实现任何接口,无需创建任何配置文件,只需要这一句静态代码的调用,便可以完成会话登录认证。
如果一个接口需要登录后才能访问,我们只需调用以下代码:
java
// 校验当前客户端是否已经登录,如果未登录则抛出 NotLoginException 异常
StpUtil.checkLogin();
在 Sa-Token 中,大多数功能都可以一行代码解决:
踢人下线:
java
// 将账号id为 10077 的会话踢下线
StpUtil.kickout(10077);
权限认证:
java
// 注解鉴权:只有具备 user:add 权限的会话才可以进入方法
@SaCheckPermission("user:add")
public String insert(SysUser user) {
// ...
return "用户增加";
}
路由拦截鉴权:
java
// 根据路由划分模块,不同模块不同鉴权
registry.addInterceptor(new SaInterceptor(handler - {
SaRouter.match("/user/", r - StpUtil.checkPermission("user"));
SaRouter.match("/admin/", r - StpUtil.checkPermission("admin"));
SaRouter.match("/goods/", r - StpUtil.checkPermission("goods"));
SaRouter.match("/orders/", r - StpUtil.checkPermission("orders"));
SaRouter.match("/notice/", r - StpUtil.checkPermission("notice"));
// 更多模块...
})).addPathPatterns("/");
如果您曾经使用过 Shiro、SpringSecurity,在切换到 Sa-Token 后,您将体会到质的飞跃。
核心模块一览:(点击展开 / 折叠)
- 登录认证 —— 单端登录、多端登录、同端互斥登录、七天内免登录。
- 权限认证 —— 权限认证、角色认证、会话二级认证。
- 踢人下线 —— 根据账号id踢人下线、根据Token值踢人下线。
- 注解式鉴权 —— 优雅的将鉴权与业务代码分离。
- 路由拦截式鉴权 —— 根据路由拦截鉴权,可适配 restful 模式。
- Session会话 —— 全端共享Session,单端独享Session,自定义Session,方便的存取值。
- 持久层扩展 —— 可集成 Redis,重启数据不丢失。
- 前后台分离 —— APP、小程序等不支持 Cookie 的终端也可以轻松鉴权。
- Token风格定制 —— 内置六种 Token 风格,还可:自定义 Token 生成策略。
- 记住我模式 —— 适配 [记住我] 模式,重启浏览器免验证。
- 二级认证 —— 在已登录的基础上再次认证,保证安全性。
- 模拟他人账号 —— 实时操作任意用户状态数据。
- 临时身份切换 —— 将会话身份临时切换为其它账号。
- 同端互斥登录 —— 像QQ一样手机电脑同时在线,但是两个手机上互斥登录。
- 账号封禁 —— 登录封禁、按照业务分类封禁、按照处罚阶梯封禁。
- 密码加密 —— 提供基础加密算法,可快速 MD5、SHA1、SHA256、AES 加密。
- 会话查询 —— 提供方便灵活的会话查询接口。
- Http Basic认证 —— 一行代码接入 Http Basic、Digest 认证。
- 全局侦听器 —— 在用户登陆、注销、被踢下线等关键性操作时进行一些AOP操作。
- 全局过滤器 —— 方便的处理跨域,全局设置安全响应头等操作。
- 多账号体系认证 —— 一个系统多套账号分开鉴权(比如商城的 User 表和 Admin 表)
- 单点登录 —— 内置三种单点登录模式:同域、跨域、同Redis、跨Redis、前后端分离等架构都可以搞定。
- 单点注销 —— 任意子系统内发起注销,即可全端下线。
- OAuth2.0认证 —— 轻松搭建 OAuth2.0 服务,支持openid模式 。
- 分布式会话 —— 提供共享数据中心分布式会话方案。
- 微服务网关鉴权 —— 适配Gateway、ShenYu、Zuul等常见网关的路由拦截认证。
- RPC调用鉴权 —— 网关转发鉴权,RPC调用鉴权,让服务调用不再裸奔
- 临时Token认证 —— 解决短时间的 Token 授权问题。
- 独立Redis —— 将权限缓存与业务缓存分离。
- Quick快速登录认证 —— 为项目零代码注入一个登录页面。
- 标签方言 —— 提供 ThymeleaTop issues
#675未能获取有效的上下文11 comments · 2024-08-23#795@ SaCheckSign与 @SaCheckAccessToken同时使用7 comments · 2025-05-26#661API 接口签名秘钥只能配置一个公共的吗,是否可以针对不同的客户端单独配置7 comments · 2024-07-26#782TokenSession 存入的对象取出时会被修改为LinkedHashMap类型6 comments · 2025-05-01#778springboot sse显示 SaTokenContext 上下文尚未初始化6 comments · 2025-04-27#846JDK21-SpringBoot3-SaTokenContext 上下文尚未初始化5 comments · 2025-09-12#858SaTempUtil.createToken创建的临时token,我想相同的key,在创建临时token时,新的临时token的生成后,让旧的临时token失效4 comments · 2025-10-26#719electron项目登陆后未能设置cookie、4 comments · 2024-12-24
Latest release
Sa-Token v1.46.0 发布 🚀,新增 Apache Fory 集成、独立 Redisson 集成 v1.46.0 2026-08-19- core: - 新增:侦听器新增注销前钩子 doBeforeLogout / doBeforeKickout / doBeforeReplaced。 [重要] - 新增:StpInterface.isDisabled 补充 loginType 参数。 [不向下兼容] - 新增:新增 allowLoginIdColon 配置,默认禁止 loginId 包含冒号。 [不向下兼容] - 修复:Jackson DefaultTyping 多态反序列化 RCE,新增 SaJsonStrategy 全局类型白名单。 [重要] [漏洞修复] - 新增:getSaTokenConfig 策略支持自定义配置来源,方便从数据库中读取配置。 - 新增:新增 SaRequest / SaResponse / SaStorage 创建策略。 fix: 841 - 新增:Session 新增 getList / getSet / getMap 类型安全集合读取。 - 修改:随机字符串/数字改用 CSPRNG(SecureRandom)生成。 - 修复:isLastingCookie 为 null 时 getCookieTimeout 不再 NPE。 - 修复:isUrl 支持 IPv6 方括号地址并拒绝裸 IPv6。 - 修复:JSON 反序列化容错优