X509Certificate2.CreateFromPemFile(String, String) 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 s kódováním RFC 7468 PEM a privátního klíče.

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPemFile (string certPemFilePath, string? keyPemFilePath = default);

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

Public Shared Function CreateFromPemFile (certPemFilePath As String, Optional keyPemFilePath As String = Nothing) As X509Certificate2

Parametry

certPemFilePath

String

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

keyPemFilePath

String

Pokud je zadán, cesta k privátnímu klíči 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íč kó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.

ArgumentNullException

certPemFilePath je null.

Poznámky

Další dokumentaci k výjimkám, které lze vyvolat, najdete ReadAllText(String) v dokumentaci.

SubjectPublicKeyInfo z certifikátu určuje, jaké popisky PEM jsou pro privátní klíč přijímány. U certifikátů RSA jsou akceptovanými popisky PEM privátního klíče RSA "RSA PRIVATE KEY" a "PRIVATE KEY". U certifikátů ECDSA jsou akceptovanými popisky PEM privátního klíče "EC PRIVATE KEY" a "PRIVATE KEY". U certifikátů DSA je akceptovaným popiskem PEM privátního klíče "PRIVÁTNÍ KLÍČ".

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

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 přijatelným popiskem. 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íčů chráněných heslem zakódovaných PEM zadejte heslo pomocí příkazu CreateFromEncryptedPemFile(String, ReadOnlySpan<Char>, String) .