Skip to content

Breaking change: HttpSys TLS channel binding token exposure (.NET 11)#37325

Open
DeagleGross wants to merge 2 commits into
dotnet:mainfrom
DeagleGross:deaglegross-httpsys-cbt-breaking-change
Open

Breaking change: HttpSys TLS channel binding token exposure (.NET 11)#37325
DeagleGross wants to merge 2 commits into
dotnet:mainfrom
DeagleGross:deaglegross-httpsys-cbt-breaking-change

Conversation

@DeagleGross

@DeagleGross DeagleGross commented Jul 9, 2026

Copy link
Copy Markdown
Member

Adds a new breaking-change doc for ASP.NET Core 11 announcing that Microsoft.AspNetCore.Server.HttpSys now calls HttpSetUrlGroupProperty(HttpServerChannelBindProperty) on every startup by default. This enables per-request TLS channel binding tokens (RFC 5929 tls-server-end-point) and the new ITlsConnectionFeature.TryGetChannelBindingBytes API, unlocking Extended Protection for Authentication (EPA) scenarios.

Reference: dotnet/aspnetcore#67436.

Changes

  • New file aspnetcore/breaking-changes/11/httpsys-channel-binding-token-enabled.md following the section structure and tone of the existing .NET 11 breaking-change docs (e.g., kestrel-strict-protocol-compliance.md).
  • Adds a row for the new doc in aspnetcore/breaking-changes/11/overview.md, inserted in the correct alphabetical position and typed as a Behavioral change.

Highlights

  • New HttpSysOptions.HttpAuthenticationHardeningLevel (Legacy / Medium / Strict), default Medium.
  • At startup, HttpSys always configures HttpServerChannelBindProperty; for Medium/Strict it also sets HTTP_CHANNEL_BIND_SECURE_CHANNEL_TOKEN.
  • New ITlsConnectionFeature.TryGetChannelBindingBytes returns the endpoint CBT on authenticated HTTPS requests.
  • Opt-out via HttpAuthenticationHardeningLevel.Legacy to restore pre-.NET 11 behavior.

Internal previews

📄 File 🔗 Preview link
aspnetcore/breaking-changes/11/httpsys-channel-binding-token-enabled.md HttpSys enables TLS channel binding token exposure by default
aspnetcore/breaking-changes/11/overview.md Breaking changes in ASP.NET Core 11

…e (.NET 11)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@DeagleGross DeagleGross requested a review from BrennanConroy July 9, 2026 16:46
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@DeagleGross DeagleGross self-assigned this Jul 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant