SpringBoot集成JumpCloud SAML2登录遇重定向循环问题求助

我们目前使用JumpCloud作为身份提供商（IDP）登录MS-Office等服务，现计划将一款内部应用接入JumpCloud，基于SpringBoot搭建演示应用做概念验证，完成了以下配置，但启动应用输入凭据后，页面陷入跳转至IDP URL的循环，以下是问题排查与解决步骤：

已完成的配置 #

1. application.properties配置 #

spring.security.saml2.relyingparty.registration.jumpcloud.assertingparty.metadata-uri=https://sso.jumpcloud.com/saml2/metadata/64b663a87f16d2qwertyuky234

该URL为JumpCloud提供的元数据地址。

2. Controller代码 #

@RestController("/saml")
@Slf4j
public class HomeController {

    @GetMapping("/something")
    public String home(@AuthenticationPrincipal Saml2AuthenticatedPrincipal principal, Model model) {

        model.addAttribute("name", principal.getName());
        model.addAttribute("emailAddress", principal.getFirstAttribute("email"));
        model.addAttribute("userAttributes", principal.getAttributes());
        log.info(model.toString());
        return "home";
    }
}

3. pom.xml依赖 #

<dependency>
    <groupId>org.springframework.security</groupId>
    <artifactId>spring-security-saml2-service-provider</artifactId>
    <version>6.1.1</version>
</dependency>

<dependency>
    <groupId>org.opensaml</groupId>
    <artifactId>opensaml-core</artifactId>
    <version>4.1.1</version>
</dependency>
<dependency>
    <groupId>org.opensaml</groupId>
    <artifactId>opensaml-saml-api</artifactId>
    <version>4.1.1</version>
</dependency>

4. SpringBoot主类 #

package com.saml.ssoDemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ssoDemo {

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

}

JumpCloud端配置 #

以管理员账号登录，进入SSO模块创建自定义SAML应用，完成SP与IDP配置、ACS URL设置，获取生成的IDP URL。

跳转循环问题排查与解决 #

1. 补全Spring Security核心配置 #

Spring Security SAML2默认没有明确的认证跳转规则，需添加安全配置类指定认证成功后的跳转路径：

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth
                .anyRequest().authenticated()
            )
            .saml2Login(saml2 -> saml2
                .defaultSuccessUrl("/saml/something", true) // 强制跳转到认证后的接口
            )
            .saml2Logout(logout -> logout
                .logoutSuccessUrl("/")
            );
        return http.build();
    }
}

defaultSuccessUrl的第二个参数设为true，避免因浏览器缓存导致跳转异常。

2. 校验ACS URL一致性 #

• SpringBoot SAML2默认ACS URL格式为{应用域名}/login/saml2/sso/{registrationId}，这里registrationId是jumpcloud，所以ACS URL应为http://你的应用域名/login/saml2/sso/jumpcloud，需确保JumpCloud后台配置的ACS URL与该地址完全匹配（包括HTTP/HTTPS、端口、路径）。
• 若自定义ACS URL，需在application.properties中显式配置：

spring.security.saml2.relyingparty.registration.jumpcloud.assertingparty.acs-url=https://你的应用域名/自定义路径

3. 修正主类启动类错误 #

主类中SpringApplication.run(OktaSsoApplication.class, args);存在类名错误，应改为当前主类名ssoDemo.class：

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

该错误会导致Spring上下文初始化异常，引发认证流程紊乱。

4. 检查Session与断言配置 #

• 确保JumpCloud返回的SAML断言包含有效的nameID属性，Spring Security依赖该属性识别已认证用户。
• 配置Session Cookie参数，避免Session无法持久化导致重复认证：

server.servlet.session.cookie.domain=你的应用域名
server.servlet.session.cookie.path=/
server.servlet.session.timeout=3600s

5. 开启日志定位细节 #

添加DEBUG日志配置，查看认证流程中的具体错误：

logging.level.org.springframework.security=DEBUG
logging.level.org.opensaml=DEBUG

重点关注SAML响应验证结果、认证成功后的跳转逻辑、Session创建日志，定位循环跳转的具体触发点。

内容的提问来源于stack exchange，提问作者Khwaish T