X509Certificate2.CreateFromEncryptedPem Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Zdroj:

X509Certificate2.cs

Vytvoří nový certifikát X509 z obsahu certifikátu zakódovaného RFC 7468 PEM a soukromého klíče chráněného heslem.

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

Parametry

certPem

ReadOnlySpan<Char>

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

keyPem

ReadOnlySpan<Char>

Text soukromého klíče chráněného heslem zakódovaného PEM.

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 neobsahuje certPem certifikát kódovaný PEM nebo je poškozený.

-nebo-

Obsah keyPem souboru neobsahuje privátní klíč chráněný heslem zakódovaný PEM nebo je poškozený.

-nebo-

Obsah obsahuje keyPem 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íč není správné.

Poznámky

U klíčů chráněných heslem zakódovaných PEM se vždy očekává, že mají popisek PEM "ŠIFROVANÝ PRIVÁTNÍ KLÍČ".

Položky kódované PEM, které mají jiný popisek, se ignorují.

Pokud jsou certifikát s kódováním PEM a privátní klíč ve stejném textu, použijte stejný řetězec pro i certPemkeyPem, například CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);. Kombinované certifikáty a klíče s kódováním PEM nevyžadují konkrétní pořadí. Pro certifikát se načte první certifikát s popiskem CERTIFIKÁTU. Pro privátní klíč se načte první privátní klíč s popiskem "ŠIFROVANÝ PRIVÁTNÍ KLÍČ". 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 zakódovaných PEM a použít jakékoli vlastní chování při načítání.

V případě klíčů s kódováním PEM bez hesla použijte CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).