diff --git a/docs/modules/ROOT/pages/migration/servlet/exploits.adoc b/docs/modules/ROOT/pages/migration/servlet/exploits.adoc
index d1472fe229..0e41a8a263 100644
--- a/docs/modules/ROOT/pages/migration/servlet/exploits.adoc
+++ b/docs/modules/ROOT/pages/migration/servlet/exploits.adoc
@@ -11,6 +11,7 @@ In Spring Security 6, the default is that the lookup of the `CsrfToken` will be
To opt into the new Spring Security 6 default, the following configuration can be used.
+[[servlet-opt-in-defer-loading-csrf-token]]
.Defer Loading `CsrfToken`
====
.Java
@@ -166,3 +167,79 @@ open fun springSecurity(http: HttpSecurity): SecurityFilterChain {
p:csrfRequestAttributeName="_csrf"/>
----
====
+
+[[servlet-csrf-breach-opt-out]]
+=== Opt-out Steps
+
+If configuring CSRF BREACH protection gives you trouble, take a look at these scenarios for optimal opt out behavior:
+
+==== I am using AngularJS or another Javascript framework
+
+If you are using AngularJS and the https://angular.io/api/common/http/HttpClientXsrfModule[HttpClientXsrfModule] (or a similar module in another framework) along with `CookieCsrfTokenRepository.withHttpOnlyFalse()`, you may find that automatic support no longer works.
+
+In this case, you can configure Spring Security to validate the raw `CsrfToken` from the cookie while keeping CSRF BREACH protection of the response using a custom `CsrfTokenRequestHandler` with delegation, like so:
+
+.Configure `CsrfToken` BREACH Protection to validate raw tokens
+====
+.Java
+[source,java,role="primary"]
+----
+@Bean
+public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
+ CookieCsrfTokenRepository tokenRepository = CookieCsrfTokenRepository.withHttpOnlyFalse();
+ XorCsrfTokenRequestAttributeHandler delegate = new XorCsrfTokenRequestAttributeHandler();
+ // set the name of the attribute the CsrfToken will be populated on
+ delegate.setCsrfRequestAttributeName("_csrf");
+ // Use only the handle() method of XorCsrfTokenRequestAttributeHandler and the
+ // default implementation of resolveCsrfTokenValue() from CsrfTokenRequestHandler
+ CsrfTokenRequestHandler requestHandler = delegate::handle;
+ http
+ // ...
+ .csrf((csrf) -> csrf
+ .csrfTokenRepository(tokenRepository)
+ .csrfTokenRequestHandler(requestHandler)
+ );
+
+ return http.build();
+}
+----
+
+.Kotlin
+[source,kotlin,role="secondary"]
+----
+@Bean
+open fun springSecurity(http: HttpSecurity): SecurityFilterChain {
+ val tokenRepository = CookieCsrfTokenRepository.withHttpOnlyFalse()
+ val delegate = XorCsrfTokenRequestAttributeHandler()
+ // set the name of the attribute the CsrfToken will be populated on
+ delegate.setCsrfRequestAttributeName("_csrf")
+ // Use only the handle() method of XorCsrfTokenRequestAttributeHandler and the
+ // default implementation of resolveCsrfTokenValue() from CsrfTokenRequestHandler
+ val requestHandler = CsrfTokenRequestHandler(delegate::handle)
+ http {
+ csrf {
+ csrfTokenRepository = tokenRepository
+ csrfTokenRequestHandler = requestHandler
+ }
+ }
+ return http.build()
+}
+----
+
+.XML
+[source,xml,role="secondary"]
+----
+
+
+
+
+
+----
+====
+
+==== I need to opt out of CSRF BREACH protection for another reason
+
+If CSRF BREACH protection does not work for you for another reason, you can opt out using the configuration from the <> section.