权限认证体系Sa-Token应用
零、调研下权限系统工具Sa-Token
开源项目-官网入口：Sa-Token
一、功能说明简介
二、项目集成
三、登录认证
四、 权限认证
返回成功示例
无权限示例
五、深入功能
六、单点登录
同域指：c1.domain.com、c2.domain.com、c3.domain.com
①SSO模式一:共享cookie同步会话 参考项目
sa-token-demo-sso1-client
②SSO模式二：URL重定向 参考项目
sa-token-demo-sso2-client
③SSO模式三Http请求 参考项目
sa-token-demo-sso3-client
单点登录步骤：
前提：三系统 server1+client1+client2
1、client1 登录接口/sso/login 携带back回调地址
2、未登录，重定向到sso认证中心server1
3、登录成功，跳转到回调地址，携带ticket码
4、 client1得到ticket码，通过http和密钥去server端校验，成功登录系统
5、client2登录接口/sso/login携带back回调地址
6、重定向到sso认证中心，此时server1已经存在刚才的token，已经认证登陆过，直接跳转client2回调地址，携带ticket码
7、client2校验ticket码通过http和密钥校验有效，成功登陆系统
8、其他数据通过/sso/myinfo接口
9、一键注销
七、OAuth2.0 使用
后续待学习
八、微服务的分布式Session会话 和网关统一鉴权
后续待学习
测试代码git路径
https://gitee.com/feng-qingxuan/satoken-usage
https://gitee.com/feng-qingxuan/satoken-usage
附录：
常用命令
登录：
StpUtil.login(Object id); //登录会话
StpUtil.logout(); // 当前会话注销登录
StpUtil.isLogin(); //判断是否已登陆true=已登陆,false=未登录
StpUtil.checkLogin();//检查是否登录未登录抛异常` `
StpUtil.getLoginId();//获取会话账号id，未登录抛异常NotLoginException
StpUtil.getLoginIdAsString(); // 获取当前会话账号id, 并转化为`String`类型
StpUtil.getLoginIdAsInt(); // 获取当前会话账号id, 并转化为`int`类型
StpUtil.getLoginIdAsLong(); // 获取当前会话账号id, 并转化为`long`类型
StpUtil.getLoginIdDefaultNull();// 获取当前会话账号id, 如果未登录，则返回null
StpUtil.getLoginId(T defaultValue);//获取会话账号id，未登录返回默认值
踢人：
StpUtil.logout(10001); // 强制指定账号注销下线
StpUtil.logout(10001, "PC"); // 强制指定账号指定端注销下线
StpUtil.logoutByTokenValue("token"); // 强制指定 Token 注销下线
StpUtil.kickout(10001); // 将指定账号踢下线
StpUtil.kickout(10001, "PC"); // 将指定账号指定端踢下线
StpUtil.kickoutByTokenValue("token"); // 将指定 Token 踢下线
StpUtil.disable(10001, 86400); //封禁帐号、id和时长单位秒(86400秒=1天，-1时，代表永久封禁)
StpUtil.isDisable(10001);//获取账号是否被封禁,true被封禁，false未被封禁
StpUtil.getDisableTime(10001);//获取指定账号剩余封禁时间,单位秒
StpUtil.untieDisable(10001); // 解除封禁
//对于一些用户使其立马封号并下线操作
StpUtil.kickout(10001); // 1、先踢下线
StpUtil.disable(10001, 86400); // 2、再封禁账号
权限 -API鉴权
StpUtil.hasPermission("user-update");// 判断：账号是否有指定权限, 返回true或false
StpUtil.checkPermission("user-update");// 校验：账号是否含有指定权限, 如果验证未通过，则抛出异常: NotPermissionException
StpUtil.checkPermissionAnd("user-update", "user-delete");// 校验：账号权限都满足
StpUtil.checkPermissionOr("user-update", "user-delete"); //校验：账号权限 满足一个即可
StpUtil.hasRole("super-admin");// 判断：当前账号拥有角色, 返回true或false
StpUtil.checkRole("super-admin");// 校验：当前账号是否含有指定角色标识, 如果验证未通过，则抛出异常: NotRoleException
StpUtil.checkRoleAnd("super-admin", "shop-admin");//校验：角色都满足
StpUtil.checkRoleOr("super-admin", "shop-admin");//校验：角色满足一个即可
上帝权限：user* 和 *
权限 -注解式鉴权
@SaCheckLogin: 登录认证 —— 只有登录之后才能进入该方法
@SaCheckRole("admin"): 角色认证 —— 必须具有指定角色标识才能进入该方法
@SaCheckPermission("user:add"): 权限认证 —— 必须具有指定权限才能进入该方法
@SaCheckSafe: 二级认证校验 —— 必须二级认证之后才能进入该方法
@SaCheckBasic: HttpBasic认证 —— 只有通过 Basic 认证后才能进入该方法
@SaCheckPermission(value = {"user-add", "user-all", "user-delete"}, mode = SaMode.OR) 校验模式
@SaCheckPermission(value = "user-add", orRole = "admin") 角色权限双重校验
写法一：orRole = "admin"，代表需要拥有角色 admin 。
写法二：orRole = {"admin", "manager", "staff"}，代表具有三个角色其一即可。
写法三：orRole = {"admin, manager, staff"}，代表必须同时具有三个角色。
操作其他账号&身份切换
StpUtil.getTokenValueByLoginId(10001); // 获取指定账号10001的`tokenValue`值
StpUtil.logout(10001); // 将账号10001的会话注销登录
StpUtil.getSessionByLoginId(10001); // 获取账号10001的Session对象, 如果session尚未创建, 则新建并返回
StpUtil.getSessionByLoginId(10001, false); // 获取账号10001的Session对象, 如果session尚未创建, 则返回null
StpUtil.hasRole(10001, "super-admin");// 获取账号10001是否含有指定角色标识
StpUtil.hasPermission(10001, "user:add");// 获取账号10001是否含有指定权限码
StpUtil.switchTo(10044); // 将当前会话[身份临时切换]为其它账号
StpUtil.getLoginId();// 此时再调用此方法会返回 10044 (我们临时切换到的账号id)
StpUtil.endSwitch();// 结束 [身份临时切换]
StpUtil.switchTo(10044, () -> {
System.out.println("是否正在身份临时切换中: " + StpUtil.isSwitch());
System.out.println("获取当前登录账号id: " + StpUtil.getLoginId());
});
System.out.println("------- [身份临时切换]调用结束...");
同端互斥登录
StpUtil.login(10001, "PC");// 指定`账号id`和`设备标识`进行登录
StpUtil.logout(10001, "PC");// 指定`账号id`和`设备标识`进行强制注销
StpUtil.getLoginDevice();// 返回当前token的登录设备
StpUtil.getTokenValueByLoginId(10001, "APP");// 获取指定loginId指定设备端的tokenValue