ComponentSpace SAML 6.1.0在ASP.NET Core中配置未识别问题排查

错误信息 #

SAML configuration has not been specified
LocalServiceProvider configuration not specified

相关代码与配置 #

Program.cs #

builder.Services.AddSaml(builder.Configuration.GetSection("SAML"));

appsettings.json #

{
  "SAML": {
    "Configurations": [
      {
        "Name": "SP",
        "ServiceProvider": {
          "EntityId": "https://localhost:5001/Saml2",
          "AssertionConsumerServiceUrl": "https://localhost:5001/Saml2/Acs"
        },
        "IdentityProviders": [
          {
            "Name": "ADFS",
            "EntityId": "http://my-adfs/adfs/services/trust",
            "SingleSignOnServiceUrl": "https://my-adfs/adfs/ls/"
          }
        ]
      }
    ]
  }
}

控制器代码 #

await _saml.InitiateSsoAsync("ADFS");

已尝试操作 #

• 验证JSON结构
• 使用AddSaml(builder.Configuration.GetSection("SAML"))添加配置
• 清理并重建项目

问题排查与解决方案 #

核心原因 #

ComponentSpace SAML v6.x要求明确指定要使用的服务提供商（SP）配置：要么设置默认SP配置，要么在调用SSO方法时同时传入SP名称。你的配置中虽然定义了SP，但组件无法自动识别默认使用哪一组配置，导致报错。

解决方案1：设置默认配置 #

在appsettings.json的SAML节点下添加DefaultConfigurationName字段，指定默认SP的名称：

{
  "SAML": {
    "DefaultConfigurationName": "SP", // 新增默认配置指定
    "Configurations": [
      {
        "Name": "SP",
        "ServiceProvider": {
          "EntityId": "https://localhost:5001/Saml2",
          "AssertionConsumerServiceUrl": "https://localhost:5001/Saml2/Acs"
        },
        "IdentityProviders": [
          {
            "Name": "ADFS",
            "EntityId": "http://my-adfs/adfs/services/trust",
            "SingleSignOnServiceUrl": "https://my-adfs/adfs/ls/"
          }
        ]
      }
    ]
  }
}

解决方案2：调用方法时指定SP名称 #

如果不想设置默认配置，可在InitiateSsoAsync方法中同时传入SP和IDP的名称：

await _saml.InitiateSsoAsync("SP", "ADFS");

额外排查项 #

• 检查appsettings.json的文件属性，确保复制到输出目录设置为“始终复制”或“较新时复制”，避免部署时配置文件缺失。
• 可在Program.cs中添加调试代码，验证配置是否被正确读取：

var samlSection = builder.Configuration.GetSection("SAML");
Console.WriteLine($"Default Config Name: {samlSection["DefaultConfigurationName"]}");
Console.WriteLine($"First SP Name: {samlSection["Configurations:0:Name"]}");

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