Skip to content

GH-3885: Document Spring Security integration for WebFlux and WebMVC gateways#4198

Merged
ryanjbaxter merged 1 commit into
spring-cloud:mainfrom
won-seoop:doc-3885-spring-security-integration
Jun 15, 2026
Merged

GH-3885: Document Spring Security integration for WebFlux and WebMVC gateways#4198
ryanjbaxter merged 1 commit into
spring-cloud:mainfrom
won-seoop:doc-3885-spring-security-integration

Conversation

@won-seoop

Copy link
Copy Markdown
Contributor

Summary

Closes #3885

  • Adds spring-security.adoc to both the WebFlux and WebMVC gateway modules
  • Documents required starters (spring-boot-starter-security, oauth2-client, oauth2-resource-server)
  • Shows how to configure a permissive SecurityWebFilterChain / SecurityFilterChain that allows health endpoints while protecting routes
  • Documents the WebMVC StrictHttpFirewall concern: it can block requests with encoded slashes or backslashes before they reach the gateway's routing logic, with a configuration example and caution
  • Adds links to the TokenRelay filter docs and Spring Security reference
  • Registers both pages in nav.adoc (after tls-and-ssl)

Test plan

  • AsciiDoc renders correctly in both WebFlux and WebMVC sections
  • xrefs to tokenrelay-factory.adoc and tokenrelay.adoc resolve
  • Spring Security reference links are correct (/reactive/index.html, /servlet/index.html, /servlet/exploits/firewall.html)

🤖 Generated with Claude Code

… and WebMVC gateways

Add spring-security.adoc pages to both the WebFlux and WebMVC gateway
modules covering required starters, default Spring Security behavior,
SecurityWebFilterChain/SecurityFilterChain configuration, the HTTP
Firewall concern for WebMVC (StrictHttpFirewall blocking proxied paths),
and cross-references to the TokenRelay filter and Spring Security docs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ryanjbaxter ryanjbaxter merged commit 021abf6 into spring-cloud:main Jun 15, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation on including Spring Security

3 participants