.NET 6中使用Shibboleth时无法获取ServerVariables及Shib相关变量

问题背景 #

在基于.NET 6搭建的站点中集成Shibboleth时遇到服务变量读取异常，当前访问 https://domain/Shibboleth.sso/Session 路径可正常查看会话信息，确认Shibboleth认证功能本身运行正常，仅应用代码内无法读取用户关联的Shibboleth属性信息。

具体异常表现 #

• 参考Shibboleth官方文档示例调用 Request.ServerVariables() 获取服务变量时，收到编译错误："HttpRequest does not contain a definition for 'ServerVariables'"
• 尝试实例化 IServerVariablesFeature 对象读取变量时，仅能成功获取 SERVER_NAME 这类通用服务变量，无法查询到 Shib-Application-ID 等Shibboleth专属变量

待确认问题 #

• IServerVariablesFeature 是否为.NET 6环境下读取Shibboleth变量的正确途径？
• 还是需要修复 Request.ServerVariables() 的调用兼容性问题？

解决方案 #

Request.ServerVariables() 是传统.NET Framework下System.Web栈的内置API，ASP.NET Core（.NET 5/6/7/8均属此栈）默认不存在该方法，不需要强行修复这个调用，问题核心是API版本差异+IIS变量透传配置缺失，按以下步骤处理即可：

• 首先确认站点采用IIS托管，项目已引用Microsoft.AspNetCore.Server.IISIntegration包，.NET 6默认Web项目模板已自动引入该包并配置IIS集成，无需额外修改服务注册代码。
• 不要手动实例化IServerVariablesFeature对象，必须通过当前请求的HttpContext特性集合获取实例，手动new的实例不会绑定当前请求的真实变量数据，这是只能拿到部分通用变量的核心原因，正确读取代码如下：

// 在Controller、Razor Page或其他可获取HttpContext的代码上下文中调用
var serverVars = HttpContext.Features.Get<IServerVariablesFeature>();
if (serverVars != null)
{
    // 读取Shibboleth相关变量
    string shibAppId = serverVars["Shib-Application-ID"];
    string shibSessionId = serverVars["Shib-Session-ID"];
    // 其余Shibboleth注入的属性（如eppn、mail、用户唯一标识等）均按此方式读取
}

• 如果按上述代码仍无法读取Shibboleth专属变量，需要修改站点根目录的web.config配置，将需要读取的Shibboleth变量加入IIS允许转发的服务器变量列表，IIS默认会拦截非内置的自定义变量传给ASP.NET Core模块，配置示例如下：

<system.webServer>
  <rewrite>
    <allowedServerVariables>
      <add name="Shib-Application-ID" />
      <add name="Shib-Session-ID" />
      <add name="Shib-Identity-Provider" />
      <add name="Shib-Authentication-Instant" />
      <add name="Shib-Authentication-Method" />
      <add name="Shib-Session-Index" />
      <!-- 按需追加业务需要读取的其他Shibboleth属性，例如用户邮箱、工号、统一身份标识等 -->
      <add name="eppn" />
      <add name="mail" />
      <add name="uid" />
    </allowedServerVariables>
  </rewrite>
</system.webServer>

• 配置完成后重启对应IIS站点即可正常读取所有变量。

补充注意：如果项目部署时采用OutOfProcess（独立进程）托管模式，请切换为InProcess（IIS进程内托管）模式，OutOfProcess模式下IIS侧Shibboleth模块注入的服务器变量无法完整透传给后端Kestrel服务，进程内托管模式下服务器变量读取兼容性最好。

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