Sdílet prostřednictvím


X509Certificate2.CreateFromEncryptedPemFile Metoda

Definice

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.

public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);
static member CreateFromEncryptedPemFile : string * ReadOnlySpan<char> * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<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

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

Atributy

Výjimky

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é.

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

Platí pro