Skip to content

Document breaking change: Composite ML-DSA on Windows uses native implementation in .NET 11 - #55212

Open
gewarren with Copilot wants to merge 8 commits into
mainfrom
copilot/breaking-change-composite-ml-dsa-native
Open

Document breaking change: Composite ML-DSA on Windows uses native implementation in .NET 11#55212
gewarren with Copilot wants to merge 8 commits into
mainfrom
copilot/breaking-change-composite-ml-dsa-native

Conversation

Copilot AI commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Starting in .NET 11, CompositeMLDsa on Windows switches from a managed implementation layered over ML-DSA/RSA/ECDSA to the native Windows (CNG) implementation, which currently supports only a subset of composite algorithms.

New breaking change article

  • Added docs/core/compatibility/cryptography/11/compositemldsa-windows-native.md covering previous/new behavior, reason for change, and recommended action (checking CompositeMLDsa.IsAlgorithmSupported and handling PlatformNotSupportedException)
  • Verified the exact set of natively-supported parameter sets against the BCRYPT_PQDSA_KEY_BLOB docs: 4 ECDSA-paired algorithms (MLDSA44-ECDSA-P256-SHA256, MLDSA65-ECDSA-P256-SHA512, MLDSA65-ECDSA-P384-SHA512, MLDSA87-ECDSA-P384-SHA512) — RSA-paired algorithms and EdDSA-paired algorithms are no longer natively supported on Windows

Index/TOC updates

  • Added the article to docs/core/compatibility/toc.yml and the Cryptography table in docs/core/compatibility/11.md

Related doc update

  • Updated the Composite ML-DSA support matrix in docs/standard/security/cross-platform-cryptography.md so Windows only shows support for the 4 natively-implemented algorithms, with a link to the new breaking change article for context
if (CompositeMLDsa.IsAlgorithmSupported(CompositeMLDsaAlgorithm.MLDsa65WithECDsaP384))
{
    using CompositeMLDsa mldsa = CompositeMLDsa.GenerateKey(CompositeMLDsaAlgorithm.MLDsa65WithECDsaP384);
    // Use mldsa.
}
else
{
    // Fall back to another algorithm, or handle the lack of support.
}

Internal previews

File Preview link
docs/core/compatibility/11.md docs/core/compatibility/11
docs/core/compatibility/cryptography/11/compositemldsa-windows-native.md docs/core/compatibility/cryptography/11/compositemldsa-windows-native
docs/core/compatibility/toc.yml docs/core/compatibility/toc
docs/standard/security/cross-platform-cryptography.md docs/standard/security/cross-platform-cryptography

Copilot AI review requested due to automatic review settings August 3, 2026 17:41

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 was unable to review this pull request because there is no eligible user to bill. To allow Copilot reviews on bot-authored pull requests, enable direct organization billing in your organization's Copilot settings.

Copilot AI changed the title [WIP] Refactor Composite ML-DSA to use native implementation on Windows Document breaking change: Composite ML-DSA on Windows uses native implementation in .NET 11 Aug 3, 2026
Copilot AI requested a review from gewarren August 3, 2026 17:46
@gewarren
gewarren marked this pull request as ready for review August 3, 2026 21:53
@gewarren
gewarren requested review from a team and BillWagner as code owners August 3, 2026 21:53

@gewarren gewarren left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Comment thread docs/standard/security/cross-platform-cryptography.md
Comment thread docs/core/compatibility/cryptography/11/compositemldsa-windows-native.md Outdated
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>

Copilot AI commented Aug 3, 2026

Copy link
Copy Markdown
Contributor Author

@copilot Please also update https://github.com/dotnet/docs/blob/main/docs/core/compatibility/unsupported-apis.md?plain=1.

Added CompositeMLDsa entries to unsupported-apis.md in e944835.

Copilot AI requested a review from gewarren August 3, 2026 22:00
Comment thread docs/core/compatibility/unsupported-apis.md Outdated

@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, once you have the one question answered.

Comment thread docs/standard/security/cross-platform-cryptography.md Outdated
@gewarren
gewarren enabled auto-merge (squash) August 5, 2026 20:14
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.

[Breaking change]: Composite ML-DSA on Windows uses native implementation

5 participants