如何测试.NET 5项目中集成的ITfoxtec SAML 2.0控制器功能？

前置校验 #

• 先确认Startup.cs中的SAML配置和企业IT提供的参数完全匹配，必填项包括：
  • IdP实体ID
  • IdP单点登录跳转地址
  • IdP签名证书公钥
  • 你方服务（SP）的实体ID
  • 你方/AssertionConsumerService路由的完整公网访问地址，该地址必须提前提交给企业IT录入到他们的SAML路由白名单中
• 确认你的代码中引用的config变量是全局注入的SAML配置实例，没有硬编码参数

本地功能自测 #

• 本地启动项目，直接访问/Login路由，正常逻辑下会自动跳转到配置的企业IdP登录页
• 跳转失败时在return binding.Bind(new Saml2AuthnRequest(config)).ToActionResult();行打断点，提取生成的跳转链接中的SAMLRequest参数，Base64解码后检查Issuer、AssertionConsumerServiceURL字段是否和配置一致

企业环境联调测试 #

• 优先使用企业提供的SAML测试环境联调，不要直接对接生产环境
• 用内网穿透工具将本地运行的服务暴露为公网可访问的HTTPS地址，将该地址对应的/AssertionConsumerService完整路径提交给IT，添加到测试环境的信任列表中
• 访问穿透后的服务的/Login路由，跳转至企业测试IdP登录页，输入测试账号完成登录，在ACS方法第一行打断点，确认能正常接收到IdP POST回传的SAMLResponse参数
• 验证断言解析结果：检查saml2AuthnResponse.ClaimsPrincipal中是否能正常获取IT预设返回的用户属性（工号、邮箱、姓名等），确认CreateSession方法能正常生成应用登录态，最终成功跳转到传入的returnUrl页面

异常场景验证 #

• 登录失败测试：输入错误的账号密码，确认代码能正确捕获非Success状态的SAML响应，抛出对应异常无崩溃
• 签名校验测试：篡改收到的SAMLResponse内容后提交到ACS接口，确认ITfoxtec库会抛出签名验证失败异常，说明自带的签名校验逻辑生效，没有被误关闭

注意：绝大多数企业SAML路由要求SP端必须使用HTTPS协议，本地测试时不要使用HTTP地址，否则会被IdP直接拦截。

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