【实战】Spring Cloud Gateway 整合 OAuth2

案例架构

---

开始撸代码之前，先来说说大致的认证鉴权流程，架构如下图：

大致分为四个角色，如下：

• 客户端：需要访问微服务资源

• 网关：负责转发、认证、鉴权

• OAuth2.0授权服务：负责认证授权颁发令牌

• 微服务集合：提供资源的一系列服务。

大致流程如下：

1、客户端发出请求给网关获取令牌

2、网关收到请求，直接转发给授权服务

3、授权服务验证用户名、密码等一系列身份，通过则颁发令牌给客户端

4、客户端携带令牌请求资源，请求直接到了网关层

5、网关对令牌进行校验（验签、过期时间校验…）、鉴权（对当前令牌携带的权限）和访问资源所需的权限进行比对，如果权限有交集则通过校验，直接转发给微服务

6、微服务进行逻辑处理

针对上述架构需要新建三个服务，分别如下：

| 名称 | 功能 |

| — | — |

| oauth2-cloud-auth-server | OAuth2.0认证授权服 |

| oauth2-cloud-gateway | 网关服务 |

| oauth2-cloud-order-service | 订单资源服务 |

案例源码目录如下：

认证授权

需要文中资料的朋友，可以加我\/信获取：vip1024b 备注Java

服务搭建

---

很多企业是将认证授权服务直接集成到网关中，这么做耦合性太高了，这里小编直接将认证授权服务抽离出来。

新建一个oauth2-cloud-auth-server模块，目录如下：

用于从数据库中加载用户，如下：

为了演示只是模拟了从数据库中查询，其中存了两个用户，如下：

• user：具有ROLE_user权限

• admin：具有ROLE_admin、ROLE_user权限

要想这个生效，还要在security的配置文件SecurityConfig中指定，如下图：

另外还整合了注册中心Nacos，详细配置就不贴了，可以看源码

网关服务搭建

---

网关使用的是Spring Cloud Gateway

新建一个oauth2-cloud-gateway模块，目录如下图：

1、添加依赖

需要添加几个OAuth2.0相关的依赖，如下：

2、JWT令牌服务配置

使用JWT令牌，配置要和认证服务的令牌配置相同，代码如下：

3、认证管理器自定义

新建一个JwtAuthenticationManager，需要实现ReactiveAuthenticationManager这个接口。

认证管理的作用就是获取传递过来的令牌，对其进行解析、验签、过期时间判定。

详细代码如下：

逻辑很简单，就是通过JWT令牌服务解析客户端传递的令牌，并对其进行校验，比如上传三处校验失败，抛出令牌无效的异常。

抛出的异常如何处理？如何定制返回的结果？

这里抛出的异常可以通过Spring Cloud Gateway的全局异常进行捕获，下面只贴出关键代码，如下：

4、鉴权管理器自定义

经过认证管理器JwtAuthenticationManager认证成功后，就需要对令牌进行鉴权，如果该令牌无访问资源的权限，则不允通过。

新建JwtAccessManager，实现ReactiveAuthorizationManager，代码如下：

这里的逻辑很简单，就是取出令牌中的权限和当前请求资源URI的权限对比，如果有交集则通过。

①处的代码什么意思？

这里是直接从Redis中取出资源URI对应的权限集合，因此实际开发中需要维护资源URI和权限的对应关系，这里不细说，为了演示，陈某直接在项目启动的时候向Redis中添加了两个资源的权限，代码如下：

注意：实际开发中需要维护资源URI和权限的对应关系。

②处的代码什么意思？

这处代码就是取出令牌中的权限集合

③处的代码什么意思？

这处代码就是比较两者权限了，有交集，则放行。

5、令牌无效或者过期时定制结果

在第4步，如果令牌失效或者过期，则会直接返回，这里需要定制提示信息。

新建一个RequestAuthenticationEntryPoint，实现ServerAuthenticationEntryPoint，代码如下：

6、无权限时定制结果

在第4步鉴权的过程中，如果无该权限，也是会直接返回，这里也需要定制提示信息。

新建一个RequestAccessDeniedHandler，实现ServerAccessDeniedHandler，代码如下：

7、OAuth2.0相关配置

经过上述6个步骤，相关组件已经准备就绪，现在直接配置到OAuth2.0中。

新建SecurityConfig这个配置类，标注注解 @EnableWebFluxSecurity，注意不是 @EnableWebSecurity，因为Spring Cloud Gateway是基于Flux实现的。详细代码如下：

需要配置的内容如下：

• 认证过滤器，其中利用了认证管理器对令牌的校验

• 鉴权管理器、令牌失效异常处理、无权限访问异常处理

• 白名单配置

• 跨域过滤器的配置

8、全局过滤器定制

最后

本人也收藏了一份Java面试核心知识点来应付面试，借着这次机会可以送给我的读者朋友们

目录：

Java面试核心知识点

一共有30个专题，足够读者朋友们应付面试啦，也节省朋友们去到处搜刮资料自己整理的时间！

Java面试核心知识点

已经有读者朋友靠着这一份Java面试知识点指导拿到不错的offer了

8、全局过滤器定制

最后

本人也收藏了一份Java面试核心知识点来应付面试，借着这次机会可以送给我的读者朋友们

目录：

[外链图片转存中…(img-WQRhhMPr-1716343166785)]

Java面试核心知识点

一共有30个专题，足够读者朋友们应付面试啦，也节省朋友们去到处搜刮资料自己整理的时间！

[外链图片转存中…(img-Zx9h7M7m-1716343166786)]

Java面试核心知识点

已经有读者朋友靠着这一份Java面试知识点指导拿到不错的offer了

[外链图片转存中…(img-mNWdaXSN-1716343166786)]