Sa-Token 正在参加 2021 年度 OSC 中国开源项目评选,请投票支持!
Sa-Token 在 2021 年度 OSC 中国开源项目评选 中已获得 {{ projectVoteCount }} 票,请投票支持!
2021 年度 OSC 中国开源项目评选 正在火热进行中,快来投票支持你喜欢的开源项目!
2021 年度 OSC 中国开源项目评选 >>> 中场回顾
Sa-Token 获得 2021 年度 OSC 中国开源项目评选「最佳人气项目」 !
授权协议 Apache-2.0
开发语言 Java
操作系统 跨平台
软件类型 开源软件
所属分类 Web应用开发Web框架
开源组织
地区 国产
投 递 者 会长_
适用人群 未知
收录时间 2020-10-21

软件简介

Sa-Token 是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、Session会话、单点登录、OAuth2.0 等一系列权限相关问题。

框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分。

与其它权限认证框架相比,Sa-Token 具有以下优势:

  1. 简单 :可零配置启动框架,真正的开箱即用,低成本上手。
  2. 强大 :目前已集成几十项权限相关特性,涵盖了大部分业务场景的解决方案。
  3. 易用 :如丝般顺滑的API调用,大量高级特性统统只需一行代码即可实现。
  4. 高扩展 :几乎所有组件都提供了扩展接口,90%以上的逻辑都可以按需重写。

有了Sa-Token,你所有的权限认证问题,都不再是问题!

Sa-Token 能做什么?

  • 登录认证 —— 单端登录、多端登录、同端互斥登录、七天内免登录
  • 权限认证 —— 权限认证、角色认证、会话二级认证
  • Session会话 —— 全端共享Session、单端独享Session、自定义Session
  • 踢人下线 —— 根据账号id踢人下线、根据Token值踢人下线
  • 账号封禁 —— 指定天数封禁、永久封禁、设定解封时间
  • 持久层扩展 —— 可集成Redis、Memcached等专业缓存中间件,重启数据不丢失
  • 分布式会话 —— 提供jwt集成、共享数据中心两种分布式会话方案
  • 微服务网关鉴权 —— 适配Gateway、ShenYu、Zuul等常见网关的路由拦截认证
  • 单点登录 —— 内置三种单点登录模式:无论是否跨域、是否共享Redis,都可以搞定
  • OAuth2.0认证 —— 基于RFC-6749标准编写,OAuth2.0标准流程的授权认证,支持openid模式
  • 二级认证 —— 在已登录的基础上再次认证,保证安全性
  • Basic认证 —— 一行代码接入 Http Basic 认证
  • 独立Redis —— 将权限缓存与业务缓存分离
  • 临时Token验证 —— 解决短时间的Token授权问题
  • 模拟他人账号 —— 实时操作任意用户状态数据
  • 临时身份切换 —— 将会话身份临时切换为其它账号
  • 前后台分离 —— APP、小程序等不支持Cookie的终端
  • 同端互斥登录 —— 像QQ一样手机电脑同时在线,但是两个手机上互斥登录
  • 多账号认证体系 —— 比如一个商城项目的user表和admin表分开鉴权
  • 花式token生成 —— 内置六种Token风格,还可:自定义Token生成策略、自定义Token前缀
  • 注解式鉴权 —— 优雅的将鉴权与业务代码分离
  • 路由拦截式鉴权 —— 根据路由拦截鉴权,可适配restful模式
  • 自动续签 —— 提供两种Token过期策略,灵活搭配使用,还可自动续签
  • 会话治理 —— 提供方便灵活的会话查询接口
  • 记住我模式 —— 适配[记住我]模式,重启浏览器免验证
  • 密码加密 —— 提供密码加密模块,可快速MD5、SHA1、SHA256、AES、RSA加密
  • 全局侦听器 —— 在用户登陆、注销、被踢下线等关键性操作时进行一些AOP操作
  • 开箱即用 —— 提供SpringMVC、WebFlux等常见web框架starter集成包,真正的开箱即用……

代码示例

Sa-Token 的 API 设计非常简单,有多简单呢?以登录认证为例,你只需要:

// 在登录时写入当前会话的账号id
StpUtil.login(10001);

// 然后在任意需要校验登录处调用以下API
// 如果当前会话未登录,这句代码会抛出 `NotLoginException` 异常
StpUtil.checkLogin();

至此,我们已经借助 Sa-Token 完成登录认证!

此时的你小脑袋可能飘满了问号,就这么简单?自定义 Realm 呢?全局过滤器呢?我不用写各种配置文件吗?

没错,在 Sa-Token 中,登录认证就是如此简单,不需要任何的复杂前置工作,只需这一行简单的API调用,就可以完成会话登录认证!

当你受够 Shiro、SpringSecurity 等框架的三拜九叩之后,你就会明白,相对于这些传统老牌框架,Sa-Token 的 API 设计是多么的简单、优雅!

权限认证示例 (只有具有user:add权限的会话才可以进入请求)

@SaCheckPermission("user:add")
@RequestMapping("/user/insert")
public String insert(SysUser user) {
    // ... 
    return "用户增加";
}

将某个账号踢下线 (待到对方再次访问系统时会抛出NotLoginException异常)

// 使账号id为10001的会话注销登录
StpUtil.kickout(10001);

除了以上的示例,Sa-Token 还可以一行代码完成以下功能:

StpUtil.login(10001);    // 标记当前会话登录的账号id
StpUtil.getLoginId();    // 获取当前会话登录的账号id
StpUtil.isLogin();    // 获取当前会话是否已经登录, 返回true或false
StpUtil.logout();    // 当前会话注销登录
StpUtil.kickout(10001);    // 将账号为10001的会话踢下线
StpUtil.hasRole("super-admin");    // 查询当前账号是否含有指定角色标识, 返回true或false
StpUtil.hasPermission("user:add");    // 查询当前账号是否含有指定权限, 返回true或false
StpUtil.getSession();    // 获取当前账号id的Session
StpUtil.getSessionByLoginId(10001);    // 获取账号id为10001的Session
StpUtil.getTokenValueByLoginId(10001);    // 获取账号id为10001的token令牌值
StpUtil.login(10001, "PC");    // 指定设备标识登录,常用于“同端互斥登录”
StpUtil.kickout(10001, "PC");    // 指定账号指定设备标识踢下线 (不同端不受影响)
StpUtil.openSafe(120);    // 在当前会话开启二级认证,有效期为120秒 
StpUtil.checkSafe();    // 校验当前会话是否处于二级认证有效期内,校验失败会抛出异常 
StpUtil.switchTo(10044);    // 将当前会话身份临时切换为其它账号 

Sa-Token 的API众多,请恕此处无法为您逐一展示,更多示例请戳官方在线文档。

展开阅读全文

代码

的 Gitee 指数为
超过 的项目

评论

点击加入讨论🔥(37) 发布并加入讨论🔥
发表了资讯
2023/06/25 09:12

Sa-Token v1.35.0 更新,新增动态 active-timeout 能力

Sa-Token v1.35.0 更新,新增动态 active-timeout 能力 Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.35.0.RC 版本更新包括以下内容: sa-token-core: 优化:前端未...

0
0
发表了资讯
2023/01/12 09:46

Sa-Token v1.34.0 更新,适配 SpringBoot3

Sa-Token v1.34.0 更新,适配 SpringBoot3 Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.34.0 版本更新包括以下内容: 新增:新增 SpringBoot3.x 集成插件,感谢 @j...

2
5
发表了资讯
2022/11/17 08:56

Sa-Token v1.33.0 更新,新增全局 Log 模块

Sa-Token v1.33.0 更新,新增全局 Log 模块 Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.33.0 版本更新包括以下内容: 重构:重构异常状态码机制。 [重要] 重构:重...

5
2
发表了资讯
2022/10/28 11:53

Sa-Token v1.32.0 更新,新增账号分类封禁、阶梯封禁功能

Sa-Token v1.32.0 更新,新增账号分类封禁、阶梯封禁功能 Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分。 Sa-Token v1.32.0 版本更新包括以下内容: 修复:修复 sa-token-dao-red...

2
8
发表了资讯
2022/10/27 10:26

Sa-Token 1.31.3 更新,轻量级 Java 权限认证框架

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.31.3.temp 版本更新包括以下内容: 新增:二级认证模块新增指定业务标识能力。 [重要] 重构:重构会话查询参数作用:由...

0
3
发表了资讯
2022/10/24 09:00

Sa-Token 1.31.2 更新,轻量级权限认证框架

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.31.1.temp 版本更新包括以下内容: 文档:新增多账号体系混合鉴权代码示例。 文档:文档增加 Gradle 依赖方式和 proper...

0
7
发表了资讯
2022/10/19 10:10

Sa-Token 1.31.1 更新,轻量级权限认证框架

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.31.1.temp 版本更新包括以下内容: 文档:[自定义 SaTokenContext 指南] 章节新增对三种模型的解释。 文档:基础章节新...

0
5
发表了资讯
2022/09/08 11:31

Sa-Token v1.31.0 发布,轻量级 Java 权限认证框架

Sa-Token v1.31.0 更新,新增账号分类封禁、阶梯封禁功能 Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.31.0 版本更新包括以下内容: 文档:新增优秀开源案例展示。 ...

4
14
发表了资讯
2022/05/10 10:51

Sa-Token 1.30.0 更新,深度优化 SSO 模块

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话…… 等常见业务进行 N 多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分。 Sa-Token v1.30.0 版本更新包括以下内容: 新增:新增集成 Web-Socket 鉴权示例。[重要] 新增:新增集成 Web-Socket(Spring封装版...

2
10
发表了资讯
2022/02/14 08:50

Sa-Token 1.29.1.trial 更新,新增 JFinal 整合插件

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.29.1.trial 版本更新包括以下内容: 新增:新增集成 Web-Socket 鉴权示例。 新增:新增集成 Web-Socket(Spring封装版) ...

5
5
发表了资讯
2022/02/10 09:52

Sa-Token v1.29.0 更新,轻松搭建 OAuth2.0 服务

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.29.0 版本更新包括以下内容: 升级:sa-token-jwt插件可在登录时添加额外数据。 重构:优化Dubbo调用时向下传递Token的规则...

5
10
发表了资讯
2021/11/08 09:18

Sa-Token v1.28.0 发布,新增 jwt 集成插件

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.28.0 版本更新包括以下内容: 新增:新增 sa-token-jwt 插件,用于与jwt的整合 [重要] 新增:新增 sa-token-context-dubbo...

3
7
发表了资讯
2021/10/20 09:51

Sa-Token v1.27.1 更新,轻量级权限认证框架

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.27.1 版本更新包括以下内容: 新增:新增sa-token-jwt插件,用于与jwt的整合 [重要] 优化:抽离getSaTokenDao()方法,方便...

7
10
发表于开发技能专区
2021/10/12 09:37

Sa-Token v1.27.0 更新,轻量级权限认证框架

Sa-Token 是一个轻量级 Java 权限认证框架,主要解决:登录认证、权限认证、分布式 Session 会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.27.0 版本更新包括以下内容: 升级:增强 SaRouter 链式匹配能力 [重要] 新增:新增插件 Thymeleaf 标签方言 [重要] 新增:...

6
17
发表了资讯
2021/09/30 10:49

Sa-Token v1.26.2 更新,轻量级权限认证框架

Sa-Token是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、分布式Session会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过 Sa-Token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.26.2 版本更新包括以下内容: 废弃 SaTokenAction 接口,新增 SaStrategy 策略类,方便内部逻辑按需重写 SaTokenConfig 配置类中...

3
8
发表了资讯
2021/09/09 09:32

Sa-Token v1.26.1 发布,轻量级权限认证框架

Sa-Token是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、分布式Session会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过sa-token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.26.1 版本更新包括以下内容: 新增:官网新增框架专属公众号 更新:考虑到新手学习难度,[权限缓存] 小节移动到附录 修复:修复文...

3
10
发表了资讯
2021/09/02 10:11

Sa-Token v1.26.0 发布,轻量级权限认证框架

Sa-Token是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、分布式Session会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过sa-token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.26.0 版本更新包括以下内容: 优化:优化单点登录文档 新增:新增 Http Basic 认证 [重要] 新增:文档新增跨域解决方案 文档:新...

0
8
发表了资讯
2021/08/17 09:04

Sa-Token v1.25.0 更新,最全单点登录框架

Sa-Token是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、分布式Session会话、单点登录、OAuth2.0 等一系列权限相关问题。 框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配,通过sa-token,你可以以一种极简的方式实现系统的权限认证部分 Sa-Token v1.25.0 版本更新包括以下内容: 新增:SaRequest新增getHeader(name, defaultValue)方法,用于获取header默认值 新增:SaRequest 添...

0
10
发表了资讯
2021/07/27 10:01

Sa-Token v1.24.1 更新,最全单点登录框架

Sa-Token是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、Session会话、单点登录、OAuth2.0 等一系列权限相关问题 框架集成简单、开箱即用、API设计清爽,通过Sa-Token,你将以一种极其简单的方式实现系统的权限认证部分 Sa-Token v1.24.1 版本更新主要简化代码API,包括以下内容: 新增:`SaRequest`新增`getHeader(name, defaultValue)`方法,用于获取header默认值 新增:Readme新增源码模块介绍 新增:新增友情...

0
7
发表了资讯
2021/07/26 09:33

Sa-Token v1.24.0 发布,微服务鉴权支持

Sa-Token是一个轻量级Java权限认证框架,主要解决:登录认证、权限认证、Session会话、单点登录、OAuth2.0 等一系列权限相关问题 框架集成简单、开箱即用、API设计清爽,通过Sa-Token,你将以一种极其简单的方式实现系统的权限认证部分 Sa-Token v1.24.0 版本更新主要为微服务鉴权支持,包括以下内容: 修复:修复部分场景下Alone-Redis插件导致项目无法启动的问题 优化:增加对SpringBoot1.x版本的兼容性 新增:SaOAuth2Util新...

0
11
没有更多内容
加载失败,请刷新页面
点击加载更多
加载中
下一页
发表了博客
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
发表了问答
{{o.pubDate | formatDate}}

{{formatAllHtml(o.title)}}

{{parseInt(o.replyCount) | bigNumberTransform}}
{{parseInt(o.viewCount) | bigNumberTransform}}
没有更多内容
暂无内容
暂无内容
37 评论
246 收藏
分享
OSCHINA
登录后可查看更多优质内容
返回顶部
顶部