当前位置： 首页 > news >正文

Spring Boot 3.x + OAuth 2.0：构建认证授权服务与资源服务器

news 2025/6/25 19:09:57

Spring Boot 3.x + OAuth 2.0：构建认证授权服务与资源服务器

在这里插入图片描述

前言

随着Spring Boot 3的发布，我们迎来了许多新特性和改进，其中包括对Spring Security和OAuth 2.0的更好支持。本文将详细介绍如何在Spring Boot 3.x版本中集成OAuth 2.0，快速开发认证授权服务、OAuth客户端以及资源服务。

开发环境介绍

在开始之前，我们需要准备三个服务，分别对应认证授权服务、OAuth客户端以及资源服务。以下是这些服务的端口配置：

服务端口
认证授权服务8080
OAuth客户端服务8081
资源服务8082

认证授权服务

在这里插入图片描述

pom.xml依赖

首先，我们需要在pom.xml文件中添加以下依赖：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-security</artifactId></dependency><dependency><groupId>org.springframework.security</groupId><artifactId>spring-security-oauth2-authorization-server</artifactId><version>${spring-security-oauth2-authorization-server.version}</version></dependency>
</dependencies>

Oauth2ServerAutoConfiguration类

接下来，我们创建Oauth2ServerAutoConfiguration类来配置认证授权服务：

@Configuration
public class Oauth2ServerAutoConfiguration {@Beanpublic SecurityFilterChain authorizationServerSecurityFilterChain(HttpSecurity http) throws Exception {OAuth2AuthorizationServerConfiguration.applyDefaultSecurity(http);http.getConfigurer(OAuth2AuthorizationServerConfigurer.class).oidc(Customizer.withDefaults()); // Enable OpenID Connect 1.0// 其他配置省略...return http.build();}// 其他Bean定义省略...
}

main函数

认证授权服务的启动类如下：

@SpringBootApplication
public class OauthServerApplication {public static void main(String[] args) {SpringApplication.run(OauthServerApplication.class, args);}
}

yml配置

最后，我们需要在yml配置文件中设置服务端口：

server:port: 8080

第三方应用OAuth客户端

pom.xml依赖

在pom.xml文件中添加以下依赖：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</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>

Oauth2ClientAutoConfiguration类

创建Oauth2ClientAutoConfiguration类来配置OAuth客户端：

@Configuration
public class Oauth2ClientAutoConfiguration {@Beanpublic SecurityFilterChain authorizationClientSecurityFilterChain(HttpSecurity http) throws Exception {http.authorizeRequests().anyRequest().authenticated().and().oauth2Client();// 其他配置省略...return http.build();}
}

OauthClientDemoController类

创建OauthClientDemoController类来处理客户端请求：

@RestController
public class OauthClientDemoController {@RequestMapping(path = "/hello")public String demo() {return "Hello, OAuth Client!";}
}

main函数

OAuth客户端服务的启动类如下：

@SpringBootApplication
public class OauthClientApplication {public static void main(String[] args) {SpringApplication.run(OauthClientApplication.class, args);}
}

yml配置

在yml配置文件中设置服务端口和OAuth2客户端配置：

server:port: 8081servlet:session:cookie:name: JSESSIONID-2spring:security:oauth2:client:registration:client-id-1:provider: demo-providerclient-id: demo-client-idclient-secret: demo-client-secretscope: user_info, pull_requestsauthorization-grant-type: authorization_coderedirect-uri: '{baseUrl}/{action}/oauth2/code/{registrationId}'

资源服务

pom.xml依赖

在pom.xml文件中添加以下依赖：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</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-resource-server</artifactId></dependency>
</dependencies>

ResourceServerAutoConfiguration类

创建ResourceServerAutoConfiguration类来配置资源服务：

@Configuration
public class ResourceServerAutoConfiguration {@Beanpublic SecurityFilterChain resourceServerSecurityFilterChain(HttpSecurity http) throws Exception {http.authorizeRequests().anyRequest().authenticated().and().oauth2ResourceServer().jwt();return http.build();}
}

UserController类

创建UserController类来处理用户信息请求：

@RestController
public class UserController {@RequestMapping(path = "/user/info", produces = MediaType.APPLICATION_JSON_VALUE)public Map<String, Object> getUser() {Map<String, Object> map = new HashMap<>();map.put("name", "Kimi");return map;}
}

main函数

资源服务的启动类如下：

@SpringBootApplication
public class ResourceServerApplication {public static void main(String[] args) {SpringApplication.run(ResourceServerApplication.class, args);}
}

yml配置

在yml配置文件中设置服务端口和资源服务配置：

server:port: 8082spring:security:oauth2:resourceserver:jwt:jwk-set-uri: http://127.0.0.1:8080/oauth2/jwks

OAuth客户端openid演示

通过访问http://127.0.0.1:8080/.well-known/openid-configuration，我们可以获取OpenID Connect的配置信息。

错误处理和安全性

在集成OAuth 2.0时，我们需要特别注意错误处理和安全性问题。确保所有的通信都是通过HTTPS进行，以保护用户的认证信息不被截获。同时，合理配置客户端的权限和范围，避免过度授权。

实际应用场景

OAuth 2.0在实际项目中的应用非常广泛，例如用户登录、API访问控制等。通过集成OAuth 2.0，我们可以为用户提供安全、便捷的认证服务。

测试和验证

为了确保OAuth 2.0集成成功，我们需要进行一系列的测试，包括但不限于：

  1. 用户认证流程是否正常。
  2. 访问令牌（Access Token）和刷新令牌（Refresh Token）是否正确生成和刷新。
  3. 资源服务是否能够正确验证访问令牌并返回数据。

通过本篇文章您能学到的知识点

  1. Spring Boot 3.x与OAuth 2.0集成的理解：您将了解如何在最新的Spring Boot版本中集成OAuth 2.0，这是现代应用程序中常见的认证授权机制。

  2. 服务端口配置：您将学会如何为认证授权服务、OAuth客户端服务和资源服务配置适当的端口，这是搭建微服务架构的基础。

  3. 依赖管理：您将掌握如何在pom.xml中添加和管理Spring Boot项目所需的依赖。

  4. 安全配置类编写：您将学习如何创建和配置Oauth2ServerAutoConfiguration、Oauth2ClientAutoConfiguration和ResourceServerAutoConfiguration等安全配置类。

  5. 启动类编写：您将了解如何编写Spring Boot应用的启动类，这是任何Spring Boot应用的核心。

  6. 配置文件编写：您将学会如何编写yml配置文件，这对于配置Spring Boot应用的行为至关重要。

  7. 控制器类编写：您将掌握如何创建OauthClientDemoController和UserController等控制器类来处理HTTP请求。

  8. OAuth 2.0客户端和资源服务器配置：您将学习如何配置OAuth 2.0客户端和资源服务器，包括客户端注册、授权类型、重定向URI等。

  9. OpenID Connect集成：您将了解如何通过访问/.well-known/openid-configuration来获取OpenID Connect的配置信息，这是实现OpenID Connect认证的关键步骤。

  10. 错误处理和安全性：您将认识到在集成OAuth 2.0时需要注意的错误处理和安全性问题，这对于保护用户数据和系统安全至关重要。

  11. 实际应用场景理解：您将了解OAuth 2.0在实际项目中的应用场景，这有助于您在实际工作中更好地应用这些知识。

  12. 测试和验证：您将学习如何进行OAuth 2.0集成的测试和验证，确保认证授权流程的正确性和安全性。

通过本篇文章的学习，您将能够构建一个完整的OAuth 2.0认证授权体系，提升您在Spring Boot和安全领域的专业技能。

你掌握了那些或遇到那些问题，欢迎评论留言进行讨论！！！

http://www.lryc.cn/news/491146.html

相关文章：

  • 2024年09月CCF-GESP编程能力等级认证Scratch图形化编程二级真题解析
  • Linux 正则表达式（basic and extened）
  • GB 35114-2017 学习笔记（规避版权阉割版）
  • YOLO-FaceV2: A Scale and Occlusion Aware Face Detector
  • 进程间通信--详解
  • 零基础上手WebGIS+智慧校园实例（1）【html by js】
  • 【Github】如何使用Git将本地项目上传到Github
  • 集合Queue、Deque、LinkedList、ArrayDeque、PriorityQueue详解
  • 谈一下开源生态对 AI人工智能大模型的促进作用
  • 基于python的机器学习（四）—— 聚类（一）
  • 实时数据开发 | 怎么通俗理解Flink容错机制，提到的checkpoint、barrier、Savepoint、sink都是什么
  • C++设计模式-策略模式-StrategyMethod
  • 小程序免备案：快速部署与优化的全攻略
  • Jmeter中的定时器
  • C++自动化测试：GTest 与 GitLab CI/CD 的完美融合
  • vscode连接远程开发机报错
  • 神经网络12-Time-Series Transformer (TST)模型
  • IDEA 2024安装指南（含安装包以及使用说明 cannot collect jvm options 问题 四）
  • Fakelocation Server服务器/专业版 Centos7
  • oracle的静态注册和动态注册
  • 机器翻译基础与模型 之四：模型训练
  • Vue——响应式数据，v-on，v-bind，v-if，v-for(内含项目实战)
  • ceph 18.2.4二次开发，docker镜像制作
  • 产品经理的项目管理课
  • Linux 下的 AWK 命令详细指南与示例
  • FPGA经验谈系列文章——8、复位的设计
  • C#里怎么样实现操作符重载？
  • 项目实战：Vue3开发一个购物车
  • Oracle SQL*Plus中的SET VERIFY
  • Spring AI 框架使用的核心概念