Skip to content

Document HKDF Windows CNG breaking change in .NET 11 - #55945

Merged
gewarren merged 2 commits into
mainfrom
copilot/breaking-change-hkdf-windows
Sep 11, 2026
Merged

Document HKDF Windows CNG breaking change in .NET 11#55945
gewarren merged 2 commits into
mainfrom
copilot/breaking-change-hkdf-windows

Conversation

Copilot AI commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Starting in .NET 11, System.Security.Cryptography.HKDF on Windows uses the Windows CNG implementation. That implementation enforces input-size limits for DeriveKey input keying material and Expand pseudorandom keys, which can cause CryptographicException for inputs that worked in earlier .NET versions.

  • Breaking change article

    • Added a .NET 11 cryptography compatibility article for the HKDF Windows CNG implementation change.
    • Documented previous behavior, new behavior, version introduced, reason for change, recommended action, and affected APIs.
  • Navigation

    • Added the article to the .NET 11 compatibility index.
    • Added the article to the compatibility TOC under Cryptography.

Internal previews

File Preview link
docs/core/compatibility/11.md Learn preview
docs/core/compatibility/cryptography/11/hkdf-windows-cng.md Learn preview
docs/core/compatibility/toc.yml Learn preview

Build report

Copilot AI lite review requested due to automatic review settings September 10, 2026 23:08

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Copilot wasn't able to review any files in this pull request.


💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix HKDF implementation for compatibility with .NET 11 Document HKDF Windows CNG breaking change in .NET 11 Sep 10, 2026
Copilot AI requested a review from gewarren September 10, 2026 23:11
@gewarren
gewarren marked this pull request as ready for review September 10, 2026 23:20
@gewarren
gewarren requested a review from a team as a code owner September 10, 2026 23:20

@BillWagner BillWagner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This LGTM @gewarren

Let's :shipit:

@gewarren
gewarren merged commit 49eb656 into main Sep 11, 2026
13 checks passed
@gewarren
gewarren deleted the copilot/breaking-change-hkdf-windows branch September 11, 2026 18:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Breaking change]: HKDF on Windows uses Windows CNG implementation

4 participants