基于spring-security的微服务鉴权中心

2022-08-23 14:00:28 浏览数 (1)

主题列表：juejin, github, smartblue, cyanosis, channing-cyan, fancy, hydrogen, condensed-night-purple, greenwillow, v-green, vue-pro, healer-readable, mk-cute, jzman, geek-black, awesome-green, qklhk-chocolate

贡献主题：https://github.com/xitu/juejin-markdown-themes

theme: juejin highlight:

一.简介

代码语言：javascript复制
此服务应用于微服务架构下，web系统对于业务接口调用需要进行token校验与权限控制
项目地址：https://github.com/louyanfeng25/Authentication

二.使用技术

  • 注册中心：nacos【2.1.3.RELEASE】
  • 配置中心：nacos【2.1.3.RELEASE】
  • RPC框架：OpenFeign【Hoxton.SR8】
  • 鉴权框架：security【Hoxton.SR8】
  • 链路跟踪：zipkin【Hoxton.SR8】
  • 缓存：guava【23.0】
  • 数据库连接池：durid【1.1.22】
  • ORM框架：mybytis-plus【3.3.2】
  • 接口文档:swagger【2.7.0】
  • 数据库：mysql【8.0.20】

三.项目启动

3.1.安装nacos

https://nacos.io/zh-cn/docs/quick-start.html

3.2.mysql

1.新建mysql数据库名为auth【可为其他名称】

2.新建用户并赋权【可为默认】

以上数据库可以任意名称新建一个数据库，修改application.yml配置即可

3.3.项目获取

git clone https://github.com/louyanfeng25/auth.git

3.4.配置修改

1.修改nacos注册中心与配置中心地址

2.修改mysql配置

flyway报错无法启动解决方案

1.数据库表结构与初始化数据采用flyway进行启动，如果启动报错，则flyway无法将flyway_schema_history相关表结构打入，可手动新建该表结构。

2.注释flyway的maven依赖手动将classpath:/db/migration的初始化sql脚本打入数据库

3.5.启动

AuthApplication启动类进行启动

四.项目说明

4.1.项目结构

  • api ：对外开放的RPC接口
  • commmon ：公共组件包
  • rpc ：对外开放的RPC包
  • sdk ：鉴权SDK包
  • service ：服务包
  • start ：启动包
  • web ：用户交互层

4.2.鉴权【能否访问系统】

能否访问系统的鉴权支持两种方式token和accessKey

4.2.1.token

生成使用对称加密，前端与后端分别定义相同的逻辑对用户名，密码进行加密处理

默认用户名：admin

默认密码：t9KQ7S2gBxzfGxsbOEUnXg==

请求头参数Times：2020-12-15 19:01:35

请求接口：/api/auth/web/login/auth/tokens

请求方式：POST

加解密逻辑具体可查看 com.baiyan.auth.service.utils.AesUtil

com.baiyan.auth.service.utils.AuthAesUtil

com.baiyan.auth.service.utils.PasswordUtil

过期时间配置为==auth.login.config.tokenTimeout==,单位为秒

4.2.2.accessKey

1.新增逻辑：拥有权限code的用户可进行任意用户的accessKey新建，普通用户可以新建自己的accessKey。

2.鉴权逻辑accessKey与用户token的权限一致，无过期时间。

4.2.3.拦截

默认配置下/api开头的所有接口请求均被拦截校验token或者accessKey 可通过配置修改： auth.resourceAp:进行拦截的请求 auth.exclude:进行过滤的请求

4.2.4.鉴权方式

1.header中携带token参数

代码语言：javascript复制
"Authorization":"Bearer fd6fe635e65146968820276eaf873e46

2.请求链接中携带token参数

代码语言：javascript复制
/api/auth/rpc/test?token=fd6fe635e65146968820276eaf873e46

3.header中携带access参数

代码语言：javascript复制
"access":"fd6fe635e65146968820276eaf873e46

4.请求链接中携带access参数

代码语言：javascript复制
/api/auth/rpc/test?access=fd6fe635e65146968820276eaf873e46

4.3.鉴权【是否有权限访问】

在controller层接口上定义

@PreAuthorize("hasAuthority('user_access')")

即为表示用户必须拥有user_access才能进行当前接口访问

五.业务应用服务接入

5.1.pom

代码语言：javascript复制
<dependency>
    <groupId>com.baiyan</groupId>
    <artifactId>auth-sdk</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>
<dependency>
    <groupId>com.baiyan</groupId>
    <artifactId>auth-rpc</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

5.2.配置

5.2.1.引入openFeign与nacos

1.启动类上添加@EnableDiscoveryClient

2.如果只引用了鉴权中心的RPC,则@EnableFeignClients则不需要在启动类上添加，jar提供了自动配置类

5.2.2.鉴权拦截配置

代码语言：javascript复制
#需要拦截的资源，多个前缀开头用英文逗号间隔  

resourceApi:/api/**

#不要拦截的资源，多个前缀开头用英文逗号间隔  

exclude:/api/**/api-docs

5.2.3.rpc发起接口请求时携带token/accessKey参数

在rpc包中重写了RequestTemplate的bean，默认情况可不添加此配置，自动加载，如果不想在rpc接口请求时传递token则增加如下配置关闭

代码语言：javascript复制
auth: 
  feign:   
    enable:false

5.3.当前请求用户信息获取

方式1：使用ThreadLocalUtil.getUser()，在代码中直接操作

代码语言：javascript复制
UserDTO user = ThreadLocalUtil.getUser();

方式2：在controller方法入口添加参数：UserDTO user

代码语言：javascript复制
@GetMapping("/api/test")
publicvoidtest(HttpServletRequest request, UserDTO userDTO){

}

5.4.获取指定根据用户ID，用户token,用户accessKey获取用户信息

此方法在auth服务开启的权限拦截，因此才RPC接口请求必须携带token/accessKey参数

代码语言：javascript复制
@Autowired
private UserApi userApi;

@Autowired
private AccessApi accessApi;

六.错误码说明

20001：用户已在线

20002：用户修改密码或者用户首次登录需要修改密码

401：无效token

403：接口访问权限不足

七.权限表结构说明

header 1

header 2

t_role

⻆色表

t_user_role

用户⻆色关联表

t_menu

权限表

t_role_menu

⻆色权限关联表

t_user

用户表

t_user_auth_log

用户登录日志表

t_access

三方授权信息表

对象存储 html 数据库 rpc https

0 人点赞