springcloud gateway整合spring security

Spring Cloud Gateway 整合 Spring Security 的实现方式

1. 添加依赖项

为了使 Spring Cloud Gateway 支持 Spring Security 功能，在项目的 pom.xml 文件中需引入必要的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-gateway</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-config</artifactId>
</dependency>

这些依赖确保了应用程序能够处理 OAuth2 资源服务器的身份验证以及网关的核心功能[^1]。

2. 安全配置类定义

创建一个新的 Java 类用于自定义安全设置，该类应扩展 WebSecurityConfigurerAdapter 或者直接通过声明式的 security DSL 来完成。考虑到 WebFlux 不支持传统的 MVC 拦截器模式，这里推荐使用函数式编程风格的安全配置方法:

@EnableWebFluxSecurity
public class SecurityConfig {

    @Bean
    public SecurityWebFilterChain springSecurityFilterChain(ServerHttpSecurity http) {
        http.authorizeExchange(exchanges -> exchanges
                .pathMatchers("/login", "/register").permitAll()
                .anyExchange().authenticated())
            .oauth2ResourceServer(OAuth2ResourceServerSpec::jwt);
        
        return http.build();
    }
}

上述代码片段展示了如何允许特定路径无需身份验证即可访问，并对其他请求实施 JWT 认证机制[^3]。

3. 配置应用属性文件

编辑 application.yml (或 .properties) 文件以指定授权服务器的相关参数和其他必要选项：

spring:
  security:
    oauth2:
      resourceserver:
        jwt:
          issuer-uri: "https://example.com/auth/realms/master"
          
server:
  port: 8080

此部分指定了发行者的 URI 地址，这对于解析来自外部认证提供商签发的 JSON Web Token 至关重要[^4]。

4. 测试 API 请求保护效果

启动应用程序之后，尝试向受保护资源发起 HTTP GET 请求；如果未携带有效的 Bearer token，则会收到状态码为 401 Unauthorized 的响应消息。反之则表示成功鉴权并返回预期的数据结果。

向AI提问

springcloud gateway整合spring security