X509Certificate2.CreateFromEncryptedPemFile Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Zdroj:

X509Certificate2.cs

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

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);

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

Public Shared Function CreateFromEncryptedPemFile (certPemFilePath As String, password As ReadOnlySpan(Of Char), Optional keyPemFilePath As String = Nothing) As X509Certificate2

Parametry

certPemFilePath

String

Cesta pro certifikát X509 kódovaný PEM.

password

ReadOnlySpan<Char>

Heslo pro šifrovaný PEM.

keyPemFilePath

String

Pokud je zadaný, cesta k privátnímu klíči chráněnému heslem zakódovanému PEM. Pokud není zadaný, certPemFilePath soubor se použije k načtení privátního klíče.

Návraty

X509Certificate2

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

Atributy

UnsupportedOSPlatformAttribute

Výjimky

CryptographicException

Obsah cesty k souboru v certPemFilePath souboru neobsahuje certifikát kódovaný PEM nebo je poškozený.

-nebo-

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

-nebo-

Obsah cesty k souboru v keyPemFilePath souboru 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é.

ArgumentNullException

certPemFilePath je null.

Poznámky

Další dokumentaci k výjimkám, které je možné vyvolat, najdete ReadAllText(String) v další dokumentaci.

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

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

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 "Š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žití vlastního chování při načítání.

V případě klíčů s kódováním PEM bez hesla použijte CreateFromPemFile(String, String).