大家好,我是满心
今天给大家分享一款轻量级的权限认证框架,可主要解决:登录认证、权限认证、单点登录、OAuth2.0、分布式Session会话、微服务网关鉴权 等一系列权限相关问题。
当你受够 Shiro、SpringSecurity 等框架的三拜九叩之后,你就会明白,相对于这些传统老牌框架,Sa-Token
的 API 设计是多么的简单、优雅!
我们搭建服务监控、单体主页、自己做的一些无授权应用,为了防止被他人扫描或被攻击,我们可能需要自己添加授权,当然在服务器层面也可以添加授权,不过我们这里使用一个轻量级框架来完成。
比如:我公司给客户免费做了一个运维监控面板,由于客户不想花钱,我们最后商议就采用轻量级框架帮他解决安全问题。
Sa-Token 目前主要五大功能模块:登录认证、权限认证、单点登录、OAuth2.0、微服务鉴权
官网给出了SpringBoot
、WebFlux
集成方式,我们这里采用SpringBoot
方式
由于我们这里有现成的项目,如果没有的朋友,可以参考SpringBoot-Pure创建项目
<dependency>
<groupId>cn.dev33groupId>
<artifactId>sa-token-spring-boot-starterartifactId>
<version>1.33.0version>
dependency>
Maven依赖拉取失败参考以下步骤
C:\Users\你的电脑用户名\.m2\repository\cn\dev33
<mirror>
<id>nexus-aliyunid>
<mirrorOf>centralmirrorOf>
<name>Nexus aliyunname>
<url>http://maven.aliyun.com/nexus/content/groups/publicurl>
mirror>
如果有的话,先把它注释掉(注释掉就直连 Maven 中央仓库了),或者修改为其它的镜像,例如腾讯云的:
<mirror>
<id>tencentid>
<name>tencent mavenname>
<url>http://mirrors.cloud.tencent.com/nexus/repository/maven-public/url>
<mirrorOf>centralmirrorOf>
mirror>
然后重启你的代码编辑器,重新构建项目,我是第四种情况,按照操作成功了。
也可以零配置直接启动,不过还是建议配置,个性化定制
server:
# 端口
port: 8081
############## Sa-Token 配置 (文档: https://sa-token.cc) ##############
sa-token:
# token名称 (同时也是cookie名称)
token-name: satoken
# token有效期,单位s 默认30天, -1代表永不过期
timeout: 2592000
# token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒
activity-timeout: -1
# 是否允许同一账号并发登录 (为true时允许一起登录, 为false时新登录挤掉旧登录)
is-concurrent: true
# 在多人登录同一账号时,是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token)
is-share: true
# token风格
token-style: uuid
# 是否输出操作日志
is-log: false
# 端口
server.port=8081
############## Sa-Token 配置 (文档: https://sa-token.cc) ##############
# token名称 (同时也是cookie名称)
sa-token.token-name=satoken
# token有效期,单位s 默认30天, -1代表永不过期
sa-token.timeout=2592000
# token临时有效期 (指定时间内无操作就视为token过期) 单位: 秒
sa-token.activity-timeout=-1
# 是否允许同一账号并发登录 (为true时允许一起登录, 为false时新登录挤掉旧登录)
sa-token.is-concurrent=true
# 在多人登录同一账号时,是否共用一个token (为true时所有登录共用一个token, 为false时每次登录新建一个token)
sa-token.is-share=true
# token风格
sa-token.token-style=uuid
# 是否输出操作日志
sa-token.is-log=false
在项目com.mx.auth
包中创建,SaTokenDemoApplication.java
,复制以下代码:
@SpringBootApplication
public class SaTokenDemoApplication {
public static void main(String[] args) throws JsonProcessingException {
SpringApplication.run(SaTokenDemoApplication.class, args);
System.out.println("启动成功:Sa-Token配置如下:" + SaManager.getConfig());
}
}
@RestController
@RequestMapping("/user/")
public class UserController {
// 测试登录,浏览器访问: http://localhost:8080/user/doLogin?username=manxin&password=123456
@RequestMapping("doLogin")
public String doLogin(String username, String password) {
// 此处仅作模拟示例,真实项目需要从数据库中查询数据进行比对
if("manxin".equals(username) && "123456".equals(password)) {
StpUtil.login(10001);
return "登录成功";
}
return "登录失败";
}
// 查询登录状态,浏览器访问: http://localhost:8080/user/isLogin
@RequestMapping("isLogin")
public String isLogin() {
return "当前会话是否登录:" + StpUtil.isLogin();
}
}
访问:http://localhost:8080/user/doLogin?username=manxin&password=123456,浏览器打印登录成功
访问:http://localhost:8080/user/isLogin,浏览器打印true
验证通过后,就可以正常返回数据了,大家也去试试吧
轻量级的权限应用场景其实也蛮多,选择合适的才是最重要的,如果对源码有兴趣的也可以看看
Gitee
Github
官方文档