From 018c215e54d61aee9a5336f41b621b865af90342 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20Nicoll?= <stephane.nicoll@broadcom.com>
Date: Wed, 4 Mar 2026 08:48:39 +0100
Subject: [PATCH] Add repository configuration section for SAML support

Closes gh-49260
---
 .../reference/pages/web/spring-security.adoc  | 38 +++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/web/spring-security.adoc b/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/web/spring-security.adoc
index e1bfee2420b..4c7147515d1 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/web/spring-security.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/web/spring-security.adoc
@@ -384,6 +384,44 @@ Additional information can be found in the {url-spring-authorization-server-docs
 
 
 
+[[web.security.saml2.build]]
+=== Build Configuration
+SAML 2.0 support builds off of the OpenSAML library that https://shibboleth.atlassian.net/wiki/spaces/DEV/pages/1123844333/Use+of+Maven+Central#Publishing-to-Maven-Central[requires an extra repository] configuration.
+
+
+
+[[web.security.saml2.build.maven]]
+==== Using Maven
+With Maven, you need to add an extra `repository` element to your POM as follows:
+
+[source,xml,subs="verbatim,attributes"]
+----
+<repositories>
+	<repository>
+		<id>shibboleth-releases</id>
+		<name>Shibboleth Releases Repository</name>
+		<url>https://build.shibboleth.net/maven/releases</url>
+		<snapshots>
+			<enabled>false</enabled>
+		</snapshots>
+	</repository>
+</repositories>
+----
+
+
+[[web.security.saml2.build.gradle]]
+==== Using Gradle
+With Gradle, a repository element should be added to your build script:
+
+[source,gradle,subs="verbatim,attributes"]
+----
+repositories {
+    maven { url "https://build.shibboleth.net/maven/releases" }
+}
+----
+
+
+
 [[web.security.saml2.relying-party]]
 === Relying Party