使用NuGet包实现MitId登录时AssertionConsumerService报‘Not HTTP POST Method’

1. 「Not HTTP POST Method」错误的核心原因 #

MitId的SAML断言必须通过POST请求发送到AssertionConsumerService（ACS）端点。出现这个错误通常有两种情况：

• 你的ACS端点仅允许GET请求，或是框架配置限制了请求方法
• MitId身份提供商（IdP）被错误配置为用GET方式发送断言（但MitId默认要求POST，所以更大概率是你的服务端配置问题）

2. Issuer的配置要求 #

Issuer 必须在MitId管理门户注册，这是MitId验证服务合法性的核心要求：

• Issuer的值要和你在MitId门户中注册的服务提供商（SP）实体ID完全一致，包括大小写、https://这类前缀
• 检查appsettings.json中的Issuer配置，确保和SP元数据XML里的<md:EntityDescriptor entityID="xxx">值完全匹配

3. 针对性排查步骤 #

（1）验证ACS端点的请求方法配置 #

• 确认你的ACS端点控制器/路由允许POST请求：比如ASP.NET中要添加[HttpPost]特性，不要只保留[HttpGet]
• 检查是否有中间件（比如CORS、路由规则）拦截了POST请求，导致请求被转为GET或直接拒绝

（2）核对SP元数据XML的正确性 #

• 确保<md:AssertionConsumerService>节点的Binding属性是urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST，而非HTTP-Redirect（GET方式）
• 确认元数据中的ACS端点URL和你实际部署的地址完全一致，包括HTTP/HTTPS协议、端口号

（3）Issuer配置的细节检查 #

• 登录MitId管理门户，找到你的SP注册条目，直接复制实体ID（Entity ID）粘贴到appsettings.json的Issuer字段，避免手动输入出错
• 如果是本地测试，确认MitId门户是否允许本地地址（比如https://localhost:xxxx）作为Issuer，部分环境需要提前将本地测试域名加入白名单

（4）对比示例代码的差异 #

• 即便你说代码几乎一致，也需要检查：
  • 示例中的appsettings.json是否有额外配置项（比如SAML绑定方式、端点路由）你未复制
  • 示例中的SP元数据是否和你生成的有差异，重点关注ACS绑定和实体ID部分

4. 快速验证方法 #

把示例项目中的SP元数据XML和appsettings.json直接复制到你的项目中替换现有文件，再测试是否还会出现错误。如果问题消失，说明是你的配置文件有误；如果问题依旧，再排查服务端的请求方法限制。

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