Skip to content

Commit fdea82f

Browse files
authored
Update APIs that always throw on .NET (#49682)
1 parent 190e78f commit fdea82f

File tree

2 files changed

+11
-5
lines changed

2 files changed

+11
-5
lines changed

docs/core/compatibility/cryptography/10.0/openssl-macos-unsupported.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: "Breaking change: OpenSSL cryptographic primitives aren't supported on macOS"
2+
title: "Breaking change: OpenSSL cryptographic primitives not supported on macOS"
33
description: "Learn about the breaking change in .NET 10 where OpenSSL cryptographic primitives are no longer supported on macOS."
44
ms.date: 06/23/2025
55
ai-usage: ai-assisted
66
ms.custom: https://github.com/dotnet/docs/issues/46789
77
---
8-
# OpenSSL cryptographic primitives are not supported on macOS
8+
# OpenSSL cryptographic primitives not supported on macOS
99

1010
Starting in .NET 10, OpenSSL-backed cryptographic primitives are no longer supported on macOS. <xref:System.Security.Cryptography.AesCcm?displayProperty=fullName> and classes that are specific to OpenSSL, such as <xref:System.Security.Cryptography.RSAOpenSsl?displayProperty=fullName>, now throw a <xref:System.PlatformNotSupportedException> on macOS.
1111

docs/core/compatibility/unsupported-apis.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: Unsupported APIs on .NET Core and .NET 5+
33
titleSuffix: ""
44
description: Learn which .NET APIs always throw an exception on .NET Core and .NET 5 and later versions.
5-
ms.date: 09/08/2025
5+
ms.date: 11/07/2025
66
---
7-
# APIs that always throw exceptions on .NET Core and .NET 5+
7+
# APIs that always throw exceptions on .NET (Core)
88

9-
The following APIs will always throw an exception on .NET (Core) on all or a subset of platforms. In most cases, the exception that's thrown is <xref:System.PlatformNotSupportedException>.
9+
The following APIs always throw an exception on .NET (Core) on all or a subset of platforms. In most cases, the exception that's thrown is <xref:System.PlatformNotSupportedException>.
1010

1111
This article organizes the affected APIs by namespace.
1212

@@ -242,6 +242,7 @@ This article organizes the affected APIs by namespace.
242242

243243
| Member | Platforms that throw |
244244
|--------|----------------------|
245+
| <xref:System.Security.Cryptography.AesCcm.%23ctor*> | macOS |
245246
| <xref:System.Security.Cryptography.AsymmetricAlgorithm.Create(System.String)?displayProperty=nameWithType> | All |
246247
| <xref:System.Security.Cryptography.CngAlgorithm?displayProperty=nameWithType> | Linux and macOS |
247248
| <xref:System.Security.Cryptography.CngAlgorithmGroup?displayProperty=nameWithType> | Linux and macOS |
@@ -264,14 +265,17 @@ This article organizes the affected APIs by namespace.
264265
| <xref:System.Security.Cryptography.CspKeyContainerInfo.RandomlyGenerated?displayProperty=nameWithType> | Linux and macOS |
265266
| <xref:System.Security.Cryptography.CspKeyContainerInfo.Removable?displayProperty=nameWithType> | Linux and macOS |
266267
| <xref:System.Security.Cryptography.CspKeyContainerInfo.UniqueKeyContainerName?displayProperty=nameWithType> | Linux and macOS |
268+
| <xref:System.Security.Cryptography.DSAOpenSsl.%23ctor*> | macOS |
267269
| <xref:System.Security.Cryptography.ECDiffieHellmanCng.FromXmlString(System.String,System.Security.Cryptography.ECKeyXmlFormat)?displayProperty=nameWithType> | All |
268270
| <xref:System.Security.Cryptography.ECDiffieHellmanCng.ToXmlString(System.Security.Cryptography.ECKeyXmlFormat)?displayProperty=nameWithType> | All |
269271
| <xref:System.Security.Cryptography.ECDiffieHellmanCngPublicKey.FromXmlString(System.String)?displayProperty=nameWithType> | All |
270272
| <xref:System.Security.Cryptography.ECDiffieHellmanCngPublicKey.ToXmlString?displayProperty=nameWithType> | All |
273+
| <xref:System.Security.Cryptography.ECDiffieHellmanOpenSsl.%23ctor*> | macOS |
271274
| <xref:System.Security.Cryptography.ECDiffieHellmanPublicKey.ToByteArray?displayProperty=nameWithType> | Linux and macOS |
272275
| <xref:System.Security.Cryptography.ECDiffieHellmanPublicKey.ToXmlString?displayProperty=nameWithType> | All |
273276
| <xref:System.Security.Cryptography.ECDsaCng.FromXmlString(System.String,System.Security.Cryptography.ECKeyXmlFormat)?displayProperty=nameWithType> | All |
274277
| <xref:System.Security.Cryptography.ECDsaCng.ToXmlString(System.Security.Cryptography.ECKeyXmlFormat)?displayProperty=nameWithType> | All |
278+
| <xref:System.Security.Cryptography.ECDsaOpenSsl.%23ctor*> | macOS |
275279
| <xref:System.Security.Cryptography.HashAlgorithm.Create?displayProperty=nameWithType> | All |
276280
| <xref:System.Security.Cryptography.HMAC.Create?displayProperty=nameWithType> | All |
277281
| <xref:System.Security.Cryptography.HMAC.Create(System.String)?displayProperty=nameWithType> | All |
@@ -284,10 +288,12 @@ This article organizes the affected APIs by namespace.
284288
| <xref:System.Security.Cryptography.ProtectedData.Unprotect%2A?displayProperty=nameWithType> | Linux and macOS |
285289
| <xref:System.Security.Cryptography.RSACryptoServiceProvider.DecryptValue(System.Byte[])?displayProperty=fullName> | All |
286290
| <xref:System.Security.Cryptography.RSACryptoServiceProvider.EncryptValue(System.Byte[])?displayProperty=fullName> | All |
291+
| <xref:System.Security.Cryptography.RSAOpenSsl.%23ctor*> | macOS |
287292
| <xref:System.Security.Cryptography.RSA.DecryptValue(System.Byte[])?displayProperty=fullName> | All |
288293
| <xref:System.Security.Cryptography.RSA.EncryptValue(System.Byte[])?displayProperty=fullName> | All |
289294
| <xref:System.Security.Cryptography.RSA.FromXmlString%2A?displayProperty=nameWithType> | All |
290295
| <xref:System.Security.Cryptography.RSA.ToXmlString%2A?displayProperty=nameWithType> | All |
296+
| <xref:System.Security.Cryptography.SafeEvpPKeyHandle?displayProperty=nameWithType> | macOS |
291297
| <xref:System.Security.Cryptography.SymmetricAlgorithm.Create?displayProperty=nameWithType> | All |
292298
| <xref:System.Security.Cryptography.SymmetricAlgorithm.Create(System.String)?displayProperty=nameWithType> | All |
293299

0 commit comments

Comments
 (0)