开源项目-轻量级Java权限认证框架！

叁歲伎倆 2022-10-04 14:53 171阅读 0赞

今天，要和大家推荐一个超级棒的开源项目，据说它号称是史上功能最全的 Java 权限认证框架！

![03cf8b6ed5a9929db4eae06d52d0cd3d.png][]

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

框架针对踢人下线、自动续签、前后台分离、分布式会话……等常见业务进行N多适配，通过sa-token，你可以以一种极简的方式实现系统的权限认证部分，与其它权限认证框架相比，sa-token 具有以下优势：

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

Sa-Token具有以下功能特性：

*  **登录验证** —— 轻松登录鉴权，并提供五种细分场景值
 *  **权限验证** —— 适配RBAC权限模型，不同角色不同授权
 *  **Session会话** —— 专业的数据缓存中心
 *  **踢人下线 **—— 将违规用户立刻清退下线
 *  **持久层扩展 **—— 可集成Redis、Memcached等专业缓存中间件，重启数据不丢失
 *  **分布式会话 **—— 提供jwt集成和共享数据中心两种分布式会话方案
 *  **单点登录** —— 一处登录，处处通行
 *  **模拟他人账号** —— 实时操作任意用户状态数据
 *  **临时身份切换 **—— 将会话身份临时切换为其它账号
 *  **无Cookie模式** —— APP、小程序等前后台分离场景
 *  **同端互斥登录** —— 像QQ一样手机电脑同时在线，但是两个手机上互斥登录
 *  **多账号认证体系** —— 比如一个商城项目的user表和admin表分开鉴权
 *  **花式token生成 **—— 内置六种token风格，还可自定义token生成策略
 *  **注解式鉴权 **—— 优雅的将鉴权与业务代码分离
 *  **路由拦截式鉴权 **—— 根据路由拦截鉴权，可适配restful模式
 *  **自动续签** —— 提供两种token过期策略，灵活搭配使用，还可自动续签
 *  **会话治理 **—— 提供方便灵活的会话查询接口
 *  **记住我模式 **—— 适配\[记住我\]模式，重启浏览器免验证
 *  **密码加密 **—— 提供密码加密模块，可快速MD5、SHA1、SHA256、AES、RSA加密
 *  **组件自动注入 **—— 零配置与Spring等框架集成

**代码示例**

sa-token的API调用非常简单，有多简单呢？以登录验证为例，你只需要：

// 在登录时写入当前会话的账号id
    StpUtil.setLoginId(10001);
    
    // 然后在任意需要校验登录处调用以下API
    // 如果当前会话未登录，这句代码会抛出 `NotLoginException`异常
    StpUtil.checkLogin();

在sa-token中，登录授权就是如此的简单，不需要什么全局过滤器，不需要各种乱七八糟的配置，只需要这一行简单的API调用，即可完成会话的登录授权。

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

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

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

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

除了以上的示例，sa-token还可以一行代码完成以下功能：

StpUtil.setLoginId(10001);                // 标记当前会话登录的账号id
    StpUtil.getLoginId();                     // 获取当前会话登录的账号id
    StpUtil.isLogin();                        // 获取当前会话是否已经登录, 返回true或false
    StpUtil.logout();                         // 当前会话注销登录
    StpUtil.logoutByLoginId(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.setLoginId(10001, "PC");          // 指定设备标识登录
    StpUtil.logoutByLoginId(10001, "PC");     // 指定设备标识进行强制注销 (不同端不受影响)
    StpUtil.switchTo(10044);                  // 将当前会话身份临时切换为其它账号

往期推荐

[Netty 实现百万连接的难点和优化点][Netty]

[面试官：说一下线程池内部工作原理？][Link 1]

[产品需求：用java做一个长链接转短链的微服务][java]

[【elasticsearch】数据早8小时or晚8小时，你知道为什么吗？附解决方案][elasticsearch_8_or_8]

[java项目，这样优雅的处理 Exception 实践，客户都给你点赞][java_ Exception]

[大实话：等电梯的时候，90%的程序员都想过调度算法][90]

[SpringBoot实现API接口多版本支持][SpringBoot_API]

[太多项目使用MyBatis，你理解它的架构和原理吗？][MyBatis]

![1011542eb0f4b73a8be40266642fdf8b.gif][]

开源链接：**https://github.com/dromara/sa-token**

好看的人，点个再看

[03cf8b6ed5a9929db4eae06d52d0cd3d.png]: /images/20221004/2ce3fb97fd1848daaec1e36cac88b1e9.png
[Netty]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ecb4cb3365a2979fbbea11a03340913ee614c594a8a9b767a04aac0a2e982cf72f0cbb4d&idx=1&mid=2247489933&scene=21&sn=f7e9029d3ac5ccf07e723daeaa9f7701#wechat_redirect
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ecb4cb3365a20848dbd7c70bdc538bb904e2d92a408dfaba2e3c0445bb031aa39de8e413&idx=2&mid=2247489933&scene=21&sn=546277dbe1ed85f7f74c7a22c783e8a5#wechat_redirect
[java]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ec4ecb336558c4ab1ea71982984ca0935fa355b23707e2dbbf38e48b88ea29d0387f8195&idx=1&mid=2247489911&scene=21&sn=fd587cc24b56b4c79431c6efe3ee64c3#wechat_redirect
[elasticsearch_8_or_8]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ec4ecb3365583d1edd3cf070cedbc443439b0fce6a6ef70b25169fad51dbb3385edb7444&idx=2&mid=2247489911&scene=21&sn=b22411aea5b6f4660e200d6f53f7b467#wechat_redirect
[java_ Exception]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ec73cb3365658ea7013c5e2c0e35fb8acc9d03b7b43c5015bcab1c4b467d87e6eaebac7e&idx=1&mid=2247489866&scene=21&sn=0a45b43ef5c24ec3ce852e973bef1c59#wechat_redirect
[90]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ec7bcb33656d274611e70048cfba05ae34ae2382d84aae01e9fcdfb30a1e4dad7bcd5153&idx=2&mid=2247489858&scene=21&sn=5a2bf75e333fba2d67bb4a043d421088#wechat_redirect
[SpringBoot_API]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ec2acb33653c3fda67373cddeba16cb07c7baf87d3e879a494e486f3a4eacb74ba68a3e8&idx=1&mid=2247489811&scene=21&sn=6029b7b8d82753efa260d0c7ee093a3d#wechat_redirect
[MyBatis]: http://mp.weixin.qq.com/s?__biz=MzU2NDc4MjE2Ng%3D%3D&chksm=fc44ec36cb3365201cf9fdaaf57be38c72de39612cc07b9f2de2eeb1e9c13512140b9ffe01c1&idx=1&mid=2247489807&scene=21&sn=11a0903158c30553a8d4ee7664ff13c7#wechat_redirect
[1011542eb0f4b73a8be40266642fdf8b.gif]: /images/20221004/4d03c79ec91848f7aeddb46516ea7c7c.png