Jenkins Helm Chart JCasC配置SecurityRealm报错求助

问题根源 #

报错Single entry map expected to configure a hudson.security.SecurityRealm的核心原因是：你把SAML专属配置项和maximumAuthenticationLifetime这类属于SAML安全领域内部的属性平级放置了。JCasC要求securityRealm必须是单一映射结构——只能包含一个安全领域类型（比如saml作为唯一顶级键），不能混合其他顶级属性。

修正后的values.yml配置 #

把maximumAuthenticationLifetime、usernameAttributeName、usernameCaseConversion这些属性移到saml节点内部：

JCasC:
  defaultConfig: true
  securityRealm: |-
    saml:
      binding: "urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"
      displayNameAttributeName: "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"
      emailAttributeName: "email"
      groupsAttributeName: "group"
      idpMetadataConfiguration:
        url: "" # 此处需填入你的IDP元数据实际URL
        period: 0
      maximumAuthenticationLifetime: 2073600
      usernameAttributeName: "username"
      usernameCaseConversion: "none"

额外注意事项 #

• 确保Jenkins已安装SAML插件，Helm部署时可在plugins列表中添加plugin: saml
• idpMetadataConfiguration.url不能留空，必须填入身份提供商（如ADFS、Okta等）的元数据URL，否则SAML认证无法正常运行
• 可通过jenkins-plugin-cli提前验证插件是否正确安装，或在Jenkins启动后检查插件状态

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