X509Certificate2.CreateFromEncryptedPem 方法

定義

命名空間:

System.Security.Cryptography.X509Certificates

組件:

System.Security.Cryptography.dll

來源:

X509Certificate2.cs

從 RFC 7468 PEM 編碼憑證與受密碼保護之私密金鑰的內容建立新的 X509 憑證。

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromEncryptedPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromEncryptedPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char), password As ReadOnlySpan(Of Char)) As X509Certificate2

參數

certPem

ReadOnlySpan<Char>

PEM 編碼 X509 憑證的文字。

keyPem

ReadOnlySpan<Char>

受密碼保護之 PEM 編碼私密金鑰的文字。

password

ReadOnlySpan<Char>

已加密 PEM 的密碼。

傳回

X509Certificate2

含私密金鑰的新憑證。

屬性

UnsupportedOSPlatformAttribute

例外狀況

CryptographicException

certPem 的內容並不包含 PEM 編碼的憑證，或其格式不正確。

-或-

keyPem 其內容並不包含受密碼保護的 PEM 編碼私密金鑰，或其格式不正確。

-或-

keyPem 其內容包含不符合憑證中公開金鑰的金鑰。

-或-

憑證會使用未知的公鑰演演算法。

-或-

針對私密金鑰指定的密碼不正確。

備註

受密碼保護的 PEM 編碼金鑰一律會具有 PEM 標籤「加密的私鑰」。

忽略具有不同標籤的 PEM 編碼專案。

如果 PEM 編碼的憑證和私鑰位於相同的文字中，請針對 certPem 和 keyPem使用相同的字串， CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);例如 。 合併的 PEM 編碼憑證和金鑰不需要特定順序。 針對憑證，會載入具有 CERTIFICATE 標籤的第一個憑證。 針對私鑰，會載入具有「加密私鑰」標籤的第一個私鑰。 加載憑證和私鑰的更進階案例可以利用 PemEncoding 來列舉 PEM 編碼的值，並套用任何自定義載入行為。

對於不含密碼的 PEM 編碼金鑰，請使用 CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)。