Skip to content

Update HTTP.sys documentation for HTTP3#36928

Open
BrennanConroy wants to merge 2 commits intomainfrom
BrennanConroy-patch-1
Open

Update HTTP.sys documentation for HTTP3#36928
BrennanConroy wants to merge 2 commits intomainfrom
BrennanConroy-patch-1

Conversation

@BrennanConroy
Copy link
Copy Markdown
Member

@BrennanConroy BrennanConroy commented Mar 26, 2026

Probably needs some word-smithing


Internal previews

📄 File 🔗 Preview link
aspnetcore/fundamentals/servers/httpsys.md HTTP.sys web server implementation in ASP.NET Core

Http.Sys also supports sending an AltSvc HTTP/2 protocol message rather than a response header to notify the client that HTTP/3 is available. See the [EnableAltSvc registry key](https://techcommunity.microsoft.com/t5/networking-blog/enabling-http-3-support-on-windows-server-2022/ba-p/2676880).

> [!NOTE]
> This requires netsh sslcert bindings that use host names rather than IP addresses. Replace `ipport` with `hostnameport` in the `netsh http add sslcert` commands below, as well as changing the IP to the HostName, e.g. www.example.com. There is also a bug where using `hostnameport` fails unless the `certstorename` parameter is used. By default use `certstorename=MY`.
Copy link
Copy Markdown
Contributor

@wadepickett wadepickett Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> This requires netsh sslcert bindings that use host names rather than IP addresses. Replace `ipport` with `hostnameport` in the `netsh http add sslcert` commands below, as well as changing the IP to the HostName, e.g. www.example.com. There is also a bug where using `hostnameport` fails unless the `certstorename` parameter is used. By default use `certstorename=MY`.
> This requires netsh sslcert bindings that use host names rather than IP addresses. Replace `ipport` with `hostnameport` in the `netsh http add sslcert` commands below, and replace the IP address with the `HostName`, for example, `www.example.com`. There's also a known issue where using `hostnameport` fails unless the `certstorename` parameter is specified. By default, use `certstorename=MY`.

Some very minor items per style guide, missing backticks. @BrennanConroy, Did you mean "host name" or HostName (reserved word/parameter) for this text:
"changing the IP to the HostName"

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

2 participants