SpringBoot实现OAuth客户端

ops/2024/11/17 18:59:38/

      背景

        5 月份的时候,我实践并整理了一篇博客:SpringBoot搭建OAuth2,该博客完成之后,本以为能对OAuth2的认证机制更加清晰,但我却觉得自己更“迷惘”了。
        抛开我在项目中积累的浅薄经验不谈,单从在网上找到的OAuth2资料来看,它更适合应用于“资源所有者,客户端,授权服务器,资源服务器”四方角色存在的场景。那么,在企业级的微服务架构中,它也是这么应用的吗?

        一般的企业分布式微服务架构中,常有认证服务OAuth2、基础平台服务(负责用户信息,权限,菜单等管理),网关服务(负责负载,网关转发),业务资源服务(提供业务服务)等,这些服务在互相调用时的流程是怎么样的?怎么做的授权?用的是OAuth2中的哪种授权模式?服务之间,哪个是客户端,哪个是资服服务……等等,怎么越想脑子越乱呢?   

        于是,我打算结合企业微服务架构中对于OAuth的实际应用整理一篇博客,把自己不懂的全弄清楚。也借此和各位大佬们探讨下,OAuth应用于企业服务需要做哪些调整。

      代码实践

        结合公司对OAuth的实际使用情况,以及网上查阅到的资料,我发现要实现OAuth客户端,有两种方案。一种是官方推建的使用spring-boot-starter-oauth2-client的方式,另一种是公司DIY的网关代理的模式,这两种方式的实现我在这里都会写一下。

      一、spring-boot-starter-oauth2-client方式

        这是网上推荐的OAuth2客户端实现方式,它与OAuth Server的交互时序图如下:

        

        代码实现如下:

        1、pom.xml引入依赖包

    <parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>2.3.2.RELEASE</version> <!-- lookup parent from repository --></parent><groupId>com.client.auth2</groupId><artifactId>auth-client</artifactId><version>1.0</version><name>auth-client</name><description>auth-client</description><properties><java.version>1.8</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-security</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-oauth2-client</artifactId></dependency></dependencies>

        2、yml添加添加OAuth服务端的配置

server:port: 19210servlet:context-path: /leixisession:cookie:# 需要更换存放sessionId的cookie名字,否则认证服务和客户端的sessionId会相互覆盖name: JSESSIONID-2max-http-header-size: 102400spring:security:oauth2:client:registration:leixi-client:provider: auth-server    #与下面provider里的配置呼应client-id: client        #在OAuth Server服务端里注测的客户端Idclient-secret: 123456    #在OAuth Server服务端里注测的客户端Secretauthorization-grant-type: authorization_code   #客户端访问的授权模式redirect-uri: '{baseUrl}/{action}/oauth2/code/{registrationId}'  #客户端获得code后的回调地址,默认该地址不变scope: read, write  #授权的scopeclient-name: client  #客户端名称provider:auth-server:authorization-uri: http://127.0.0.1:19200/oauth/authorize    #OAuth Server授权码模式地址token-uri: http://127.0.0.1:19200/oauth/token   #OAuth Server获取Token的地址user-info-uri: http://127.0.0.1:19200/user/info   #OAuth获取用户信息的地址user-name-attribute: name

        3、添加WebSecurityConfig配置

package com.client.auth2.config;import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.config.http.SessionCreationPolicy;@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {@Overridepublic void configure(HttpSecurity http) throws Exception {http.authorizeRequests().anyRequest().authenticated().and().logout().and().sessionManagement().sessionCreationPolicy(SessionCreationPolicy.ALWAYS).and().oauth2Client().and().oauth2Login();}
}

        4、编写一个Controller方法用于测试

/**** @author leixiyueqi* @since 2023/12/5 19:39*/
@RestController
@Slf4j
public class DemoController {@GetMapping("/demo")public Object demo() {Authentication authentication = SecurityContextHolder.getContext().getAuthentication();log.info("authentication: {}", authentication);return "Hello World";}
}

        5、结合OAuth Server进行测试,为方便测试,咱们使用上篇博客中构建的直接跳转登陆页的OAuth Server服务。访问客户端地址:http://127.0.0.1:19210/leixi/demo,测试结果如下:

        

        输入用户名,密码之后,正常跳转到了客户端的请求:

        

      二、网关代理集成方式

        网关代理集成方式是公司在应用OAuth Server时,结合公司的架构进行的一些个性化设计处理,它与其他服务的交互时序图如下:

        以下是一个简化版的实现,其实现逻辑如下:
        1) 通过浏览器访问客户端服务,客户端通过Filter检查请求的cookie中是否有Token,
        2) 如果没有Token或Token校验不通过,则重定向到OAuth Server的登陆页面。
        3) OAuth Server登陆授权后,跳转到客户端的回调方法,回调方法中拿到Code,调用oauth/token来获得token.
        4) 将token封装到cookie中,再重新调用客户端服务,本次Filter检查到有Token,正常放行。
        5) 返回客户端服务的结果到浏览器。

        下面是代码实践:

        1、添加pom.xml依赖

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></dependency><dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version></dependency><dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt-jackson</artifactId><version>0.11.2</version> </dependency><dependency><groupId>io.jsonwebtoken</groupId><artifactId>jjwt</artifactId><version>0.9.0</version></dependency><!--huTool工具箱大全--><dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.3.0</version></dependency>

        2、添加检查cookie中Token的过滤器

/**** @author leixiyueqi* @since 2024/9/18 19:39*/
@Slf4j
@Component
public class TokenAuthFilter implements Ordered, Filter {private static final String authUri = "http://127.0.0.1:19200/oauth/authorize?client_id=client&response_type=code&redirect_uri=http://127.0.0.1:19210/leixi/callback&state=";@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {HttpServletRequest httpRequest = (HttpServletRequest) request;HttpServletResponse httpResponse = (HttpServletResponse) response;//String token = httpRequest.getParameter("token");  通过url的方式获取Token// 获取请求的URIString requestURI = CommonUtils.getRequestUriByHttpRequest(httpRequest);String token = getCookieFromRequest(httpRequest,"token");if (!requestURI.contains("callback")) {if (StringUtils.isEmpty(token)) {log.info("请求中未携带token信息");httpResponse.sendRedirect(authUri + requestURI);} else {Claims claim = CommonUtils.parseJwt(token);if (claim == null) {log.info("token解析失败");httpResponse.sendRedirect(authUri + requestURI);}}}chain.doFilter(request, response);}private String getCookieFromRequest(HttpServletRequest request,String cookieName) {Cookie[] cookies = request.getCookies();if (cookies != null) {for (Cookie cookie : cookies) {// 进行其他处理,比如验证Cookieif (cookieName.equals(cookie.getName())) {return cookie.getValue();}}} else {log.info("No cookies found in the request.");}return null;}@Overridepublic int getOrder() {return 2;}
}

        3、添加调用/oauth/token请求的工具类

/*** 认证服务交互工具类,用于访问OAuth Server,获得Token** @author leixiyueqi* @since 2024/9/18 19:39*/public class AuthorizationUtils {private static String oauthTokenUrl = "http://127.0.0.1:19200/oauth/token";private static final String clientId ="client";private static final String clientSecret ="123456";public static Map getAccessToken(String code, String redirectUri) {try {// 发送请求String body = HttpUtil.createPost(oauthTokenUrl).contentType(MediaType.APPLICATION_FORM_URLENCODED_VALUE).header("Authorization", generateAuthHeader()).form("code", code).form("redirect_uri", redirectUri).form("grant_type", "authorization_code").execute().body();System.out.println("DibAuthorization.getAccessToken:tokenBody " +body);Map<String, Object> map = JSON.parseObject(body, HashMap.class);return map;} catch (Exception ex) {System.out.println("get access token failed : {}"+ ex.getMessage());throw ex;}}private static String generateAuthHeader() {String credentials = clientId + ":" + clientSecret;String encoded = new String(Base64.getEncoder().encode(credentials.getBytes()));return "Basic " + encoded;}}

        4、添加测试Controller


/**** @author leixiyueqi* @since 2024/9/18 19:39*/
@RestController
@Slf4j
public class DemoController {@GetMapping("/demo")public Object demo() {;return "Hello World";}/*** 客户端的回调方法,用于获得code后,通过code获得** @param code* @param state* @param httpRequest* @param response*/@GetMapping("/callback")public void callback(@RequestParam String code,@RequestParam(required = false) String state,ServletRequest httpRequest, ServletResponse response) {try {log.info("进入方法,callback");String localUri = CommonUtils.getRequestUriByHttpRequest((HttpServletRequest)httpRequest);Map<String, Object> map = AuthorizationUtils.getAccessToken(code, localUri);String jwtStr = CommonUtils.createJwt(map);HttpServletResponse httpResponse = (HttpServletResponse) response;//redirectUrl = String.format("%s%s=%s", redirectUrl, redirectUrl.contains("?") ? "&token" : "?token", jwtStr);  //将token拼装到url中。addCookieForToken(httpResponse, jwtStr);httpResponse.sendRedirect(state);} catch (Exception e) {log.error("AuthorizationCodeTokenController.callback exception:{}", e.getMessage());}}/*** 将token以cookie的形式添加到response中** @param response* @param token* @throws Exception*/private void addCookieForToken(HttpServletResponse response, String token) throws Exception {Cookie cookie = new Cookie("token", token);// 设置Cookie的有效期(以秒为单位)cookie.setMaxAge(60 * 60); // 有效期为1小时// 设置Cookie的路径cookie.setPath("/");// 设置Cookie是否只能通过HTTPS协议传输cookie.setSecure(true); // 如果你的应用支持HTTPS,设置为true// 设置Cookie是否可以通过JavaScript脚本访问cookie.setHttpOnly(true); // 设置为true,增加安全性// 添加Cookie到响应中response.addCookie(cookie);// 输出一些文本,以便查看响应response.setContentType("text/html;charset=UTF-8");response.getWriter().println("<h1>Cookie has been set.</h1>");}
}

        5、补充下工具类

/*** 工具类** @author leixiyueqi* @since 2024/9/18 19:39*/
public class CommonUtils {private static final String secretKey = "leixi_2024";public static String createJwt(Map<String, Object> map) {return Jwts.builder().setClaims(map).setExpiration(new Date(System.currentTimeMillis() + 28800000L)).signWith(SignatureAlgorithm.HS256, secretKey).compact();}public static Claims parseJwt(String jwtString) {try {return (Claims)Jwts.parser().setSigningKey(secretKey).parseClaimsJws(jwtString).getBody();} catch (JwtException var2) {return null;}}public static String getRequestUriByHttpRequest(HttpServletRequest httpRequest) {String requestURI = httpRequest.getRequestURI();// 获取服务器的端口号int serverPort = httpRequest.getServerPort();// 获取请求的协议(HTTP或HTTPS)String scheme = httpRequest.getScheme();// 构建完整的URLStringBuilder fullUrl = new StringBuilder(scheme).append("://").append(httpRequest.getServerName()).append(":").append(serverPort).append(requestURI);return fullUrl.toString();}
}

        6、测试,与上文一致,输入:http://127.0.0.1:19210/leixi/demo,通过Filter重定向跳转到/oauth/authorize,重定向到登陆页。

        

        输入用户名,密码后,经过上文所述的认证,callback,重定向,再Filter,最终进入客户端请求。

        

      后记与致谢

        完成了这篇博客后,我终于对OAuth Server的使用,企业中的应用、与客户端的交互有了一个全盘的理解。道阻且长,行将则至,我也没想到时隔近五个月,我才把OAuth相关的知识链给跑通。参考了网上其他的博客,很多大佬在一篇博客里就把认证,自定义页面,客户端给写好了,但我自认没有能力写得那么简单直白,另一方面也想深入的剖析下它的实现,所以写得有点啰嗦了,请各位看官人多多包涵。

        现在回过头看OAuth Server的四种授权模式,可知本篇博客中的两种实现都是授权码模式,那么,对于在企业内部应用OAuth,是不是可以使用其他模式呢?如更简捷的“简单模式”,这个课题,大家可以结合自己的需要进行实践。

        在实践这篇博客时,我也在网上找到了很多二货,以下是我觉得对我帮助极大的,拜谢大佬!

        SpringBoot+SpringSecurity OAuth2 认证服务搭建实战 (六)OAuth2经典场景~授权码模式

        SpringBoot整合OAuth 2.0

        超级简单的springboot整合springsecurity oauth2第三方登录


http://www.ppmy.cn/ops/117802.html

相关文章

工作安排 - 华为OD统一考试(E卷)

2024华为OD机试(C卷+D卷)最新题库【超值优惠】Java/Python/C++合集 题目描述 小明每周上班都会拿到自己的工作清单,工作清单内包含n项工作,每项工作都有对应的耗时时长(单位h)和报酬,工作的总报酬为所有已完成工作的报酬之和。那么请你帮小明安排一下工作,保证小明在指定…

STM32嵌入式编程学习到提高:【4】UART串口打印

------------------------------------------------------------------------------------------------------------------------- 工程文件&#xff1a;放在百度云盘里&#xff0c;需要的自行下载&#xff01;&#xff01;&#xff01; 链接: https://pan.baidu.com/s/14gRne…

git-repo系列教程(3) git-repo https证书认证问题

文章目录 问题描述解决步骤1.下载证书2.测试证书是否正常3.设置环境变量 总结 问题描述 在使用git repo 同步仓库时,发现不能同步,出现如下提示错误: % Total % Received % Xferd Average Speed Time Time Time CurrentDload Upload Total Spent Left …

SCDN是服务器吗?SCDN防御服务器有什么特点?

SCDN确实具有一定的防DDoS攻击能力&#xff0c;SCDN防御服务器有什么特点&#xff1f;高防SCDN通过结合内容分发网络&#xff08;CDN&#xff09;和分布式拒绝服务&#xff08;DDoS&#xff09;防护技术&#xff0c;提供了更全面的网络保护措施。在充满网络攻击的互联网时代&am…

微服务3:微服务间接口远程调用(同步通信方式)

1、微服务架构优势 1)模块化与独立性:微服务架构将大型应用程序拆分成多个小型、独立的服务单元。每个服务都专注于单一的业务功能,这使得服务更加模块化和独立。这种设计不仅降低了服务之间的耦合度,还提高了系统的可维护性和可扩展性。每个服务都可以独立地进行开发、测…

Java项目实战II基于Java+Spring Boot+MySQL的车辆管理系统(开发文档+源码+数据库)

目录 一、前言 二、技术介绍 三、系统实现 四、论文参考 五、核心代码 六、源码获取 全栈码农以及毕业设计实战开发&#xff0c;CSDN平台Java领域新星创作者&#xff0c;专注于大学生项目实战开发、讲解和毕业答疑辅导。获取源码联系方式请查看文末 一、前言 "随着…

pg入门11-pg中的publications是什么

在 PostgreSQL&#xff08;PG&#xff09;中&#xff0c;Publication&#xff08;发布&#xff09;是逻辑复制机制中的一个概念&#xff0c;用于定义哪些表的数据变更&#xff08;INSERT、UPDATE、DELETE&#xff09;可以发布到订阅者&#xff08;Subscribers&#xff09;。它主…

ChatGPT Sidebar 浏览器插件配置指南

随着聊天机器人技术的不断进步&#xff0c;越来越多的人开始依赖这些强大的工具来提高工作效率、获取信息和解决问题。OpenAI 的 ChatGPT 是其中最受欢迎的聊天机器人之一。为了方便用户在浏览网页时随时与 ChatGPT 互动&#xff0c;开发者们设计了一款名为 ChatGPT Sidebar 的…