默认情况下,HttpSys 启用 TLS 通道绑定令牌公开

在 ASP.NET Core 11 中,Microsoft.AspNetCore.Server.HttpSys无条件地在启动时配置 HttpServerChannelBindProperty URL 组。 这将通过新的 ITlsConnectionFeature.TryGetChannelBindingBytes API 向应用公开 RFC 5929 终结点 TLS 通道绑定令牌(CBT),从而为身份验证(EPA)方案启用扩展保护。

引入的版本

.NET 11

以前的行为

HttpSys 支持的服务器在启动时未在 URL 组上配置 HttpServerChannelBindProperty ,RFC 5929 TLS 通道绑定令牌未向应用公开。

应用程序可以通过启用开关来选择加入 Microsoft.AspNetCore.Server.HttpSys.EnableCBTHardeningAppContext 。 该开关将强化级别设置为 Medium,但未设置 HTTP_CHANNEL_BIND_SECURE_CHANNEL_TOKEN 标志,因此 http.sys 未提供每请求 CBT。

ITlsConnectionFeature 无法检索令牌。 唯一相关的 API 是现已过时 ITlsTokenBindingFeature的,这是一个不同的无关功能。

新行为

具有默认为 类型的新属性。

在启动时,HttpSys 无条件调用HttpSetUrlGroupPropertyHttpServerChannelBindProperty并应用配置的强化级别。 Strict此外Medium,它还设置HTTP_CHANNEL_BIND_SECURE_CHANNEL_TOKEN标志,以便 http.sys 按请求HTTP_REQUEST_CHANNEL_BIND_STATUS传递。

ITlsConnectionFeature.TryGetChannelBindingBytes(ChannelBindingKind kind, out ReadOnlyMemory<byte> channelBindingToken)新请求在经过身份验证的 HTTPS 请求上返回终结点 CBT(RFC 5929tls-server-end-point)。

HttpSetUrlGroupProperty如果调用失败(例如,在旧内核或被阻止的内核上),则会记录失败并继续启动。 应用会 Legacy 像配置一样运行。

破坏性变更的类型

此更改为行为更改。

更改原因

此更改向身份验证中间件公开 RFC 5929 终结点通道绑定,以便它可以实现针对身份验证的扩展保护(EPA)。 EPA 以加密方式将 Kerberos、NTLM 或协商身份验证绑定到基础 TLS 通道,从而缓解身份验证中继攻击。 以前,没有 ASP.NET Core服务器向托管代码公开 CBT。

有关详细信息,请参阅 dotnet/aspnetcore#67436。

大多数用户无需采取任何行动。 新 API 已选择加入。 不调用 TryGetChannelBindingBytes 的应用仍会产生较小的每个请求成本:使用 Medium 强化(默认值),http.sys 捕获每个 HTTPS 请求的通道绑定令牌,并将其包含在分配给用户模式的请求信息中,这增加了少量内核工作,每个请求大约 40 个额外的字节。 典型工作负荷的开销可忽略不计,但不为零。 需要完全消除的应用可以通过设置 HttpAuthenticationHardeningLevel.Legacy (请参阅下面的代码片段)来选择退出。

若要还原预.NET 11 行为,请将强化级别设置为Legacy:

builder.WebHost.UseHttpSys(options =>
{
    options.HttpAuthenticationHardeningLevel = HttpAuthenticationHardeningLevel.Legacy;
});

配置后 Legacy ,HttpSys 不会设置 CBT 标志,http.sys 不会填充 HTTP_REQUEST_CHANNEL_BIND_STATUS,并 TryGetChannelBindingBytes 返回 false。

HttpServerChannelBindProperty自 Windows 7 2008 年 10 月 22 日发布(2009 年 10 月 22 日发布)以来,http.sys 支持 Windows Server http.sys,该版本低于操作系统下的任何受支持 ASP.NET Core版本。 不支持 ASP.NET Core操作系统。

受影响的 API

  • Microsoft.AspNetCore.Server.HttpSys.HttpSysOptions.HttpAuthenticationHardeningLevel (新)
  • Microsoft.AspNetCore.Server.HttpSys.HttpAuthenticationHardeningLevel (新枚举)
  • Microsoft.AspNetCore.Http.Features.ITlsConnectionFeature.TryGetChannelBindingBytes (新的默认接口方法)