X509Certificate2.CreateFromEncryptedPem Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.X509Certificates.dll

Sestavení:

System.Security.Cryptography.dll

Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 PEM kódovaného certifikátem a privátním klíčem chráněným heslem.

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

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);

static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

[<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

Parametry

certPem

ReadOnlySpan<Char>

Text certifikátu X509 s kódováním PEM.

keyPem

ReadOnlySpan<Char>

Text privátního klíče s kódováním PEM chráněným heslem

password

ReadOnlySpan<Char>

Heslo pro šifrovaný PEM.

Návraty

X509Certificate2

Nový certifikát s privátním klíčem.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

CryptographicException

Obsah certPem certifikátu s kódováním PEM neobsahuje nebo je poškozený.

-nebo-

Obsah keyPem neobsahuje privátní klíč s kódováním PEM chráněný heslem nebo je poškozený.

-nebo-

Obsah keyPem obsahuje klíč, který neodpovídá veřejnému klíči v certifikátu.

-nebo-

Certifikát používá neznámý algoritmus veřejného klíče.

-nebo-

Heslo zadané pro privátní klíč je nesprávné.

Poznámky

U klíčů s kódováním PEM chráněných heslem se vždy očekává, že bude mít popisek PEM "ENCRYPTED PRIVATE KEY".

Položky s kódováním PEM, které mají jiný popisek, se ignorují.

Pokud je certifikát s kódováním PEM a privátní klíč ve stejném textu, použijte stejný řetězec pro oba certPem a keyPemnapříklad CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);. Kombinované certifikáty a klíče kódované PEM nevyžadují konkrétní pořadí. Pro certifikát se načte první certifikát s popiskem CERTIFICATE. Pro privátní klíč se načte první privátní klíč s popiskem "ENCRYPTED PRIVATE KEY". Pokročilejší scénáře načítání certifikátů a privátních klíčů můžou využít PemEncoding k vytvoření výčtu hodnot kódování PEM a použití jakéhokoli vlastního chování při načítání.

Pro klíče s kódováním PEM bez hesla použijte CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).