Conversation
3 tasks
…ypt obsolete (SYSLIB0064) Agent-Logs-Url: https://github.com/dotnet/docs/sessions/bc1664ca-5e7f-4e55-8477-176d61b0e93e Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Remove obsolete RSACryptoServiceProvider Encrypt and Decrypt methods
docs: Add SYSLIB0064 breaking change – RSACryptoServiceProvider.Encrypt/Decrypt with fOAEP obsolete (.NET 11)
Apr 3, 2026
gewarren
approved these changes
Apr 4, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR adds documentation for the new SYSLIB0064 obsoletion (RSACryptoServiceProvider Encrypt/Decrypt(byte[], bool)), wires the new diagnostic page into navigation, and adds a .NET 11 compatibility page for “non-default diagnostic ID” API obsoletions.
Changes:
- Added
SYSLIB0064diagnostic reference content with workaround and suppression guidance. - Updated SYSLIB navigation and the obsoletions index to include
SYSLIB0064. - Added a .NET 11 compatibility “custom diagnostic IDs” breaking-change page and linked it from the .NET 11 Core Libraries index/TOC.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/navigate/tools-diagnostics/toc.yml | Adds SYSLIB0064 to the diagnostics navigation. |
| docs/fundamentals/syslib-diagnostics/syslib0064.md | New SYSLIB diagnostic reference page for the RSA fOAEP overload obsoletion. |
| docs/fundamentals/syslib-diagnostics/obsoletions-overview.md | Adds SYSLIB0064 row to the SYSLIB obsoletions index table. |
| docs/core/compatibility/toc.yml | Links the new .NET 11 “non-default diagnostic IDs” page under .NET 11 Core Libraries. |
| docs/core/compatibility/core-libraries/11/obsolete-apis.md | New .NET 11 “non-default diagnostic IDs” compatibility page listing SYSLIB0064. |
| docs/core/compatibility/11.md | Adds the new “non-default diagnostic IDs” page to the .NET 11 Core Libraries breaking-changes index. |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
vcsjones
approved these changes
Apr 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the .NET 11 Preview 3 obsoletion of
RSACryptoServiceProvider.Encrypt(byte[], bool)andRSACryptoServiceProvider.Decrypt(byte[], bool). These methods implicitly used SHA-1 with OAEP and offered no way to specify a different digest algorithm; callers should migrate to theRSAEncryptionPaddingoverloads.New articles
docs/core/compatibility/cryptography/11/rsacryptoserviceprovider-encrypt-decrypt-obsolete.md— breaking change article (SYSLIB0064, source incompatible)docs/fundamentals/syslib-diagnostics/syslib0064.md— SYSLIB diagnostic reference with migration table and warning-suppression guidanceUpdated articles
obsoletions-overview.md— SYSLIB0064 row added to the obsoletion tabletoc.yml(compatibility) — entry added under .NET 11 › Cryptography11.md— entry added to the Cryptography breaking-changes indexnavigate/tools-diagnostics/toc.yml— SYSLIB0064 added to diagnostic navigationMigration at a glance
Encrypt(data, fOAEP: true)Encrypt(data, RSAEncryptionPadding.OaepSHA1)Encrypt(data, fOAEP: false)Encrypt(data, RSAEncryptionPadding.Pkcs1)Decrypt(data, fOAEP: true)Decrypt(data, RSAEncryptionPadding.OaepSHA1)Decrypt(data, fOAEP: false)Decrypt(data, RSAEncryptionPadding.Pkcs1)Where OAEP is in use,
RSAEncryptionPadding.OaepSHA256(or stronger) is recommended overOaepSHA1.Internal previews