X509Certificate2.CreateFromPem Metoda

Definice

Obor názvů:

System.Security.Cryptography.X509Certificates

Sestavení:

System.Security.Cryptography.dll

Přetížení

CreateFromPem(ReadOnlySpan<Char>)	Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 s kódováním PEM.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 s kódováním PEM a privátního klíče.

CreateFromPem(ReadOnlySpan<Char>)

Zdroj:

X509Certificate2.cs

Vytvoří nový certifikát X509 z obsahu certifikátu RFC 7468 s kódováním PEM.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem);

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

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2

Parametry

certPem

ReadOnlySpan<Char>

Text certifikátu X509 zakódovaného PEM

Návraty

X509Certificate2

Nový certifikát X509.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

CryptographicException

Obsah neobsahuje certPem certifikát kódovaný PEM nebo je poškozený.

Poznámky

Tím se načte první správně tvarovaný PEM nalezený s popiskem CERTIFICATE.

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

V případě certifikátů s kódováním PEM v souboru použijte X509Certificate2(String).

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Zdroj:

X509Certificate2.cs

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

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

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

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

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2

Parametry

certPem

ReadOnlySpan<Char>

Text certifikátu X509 zakódovaného PEM

keyPem

ReadOnlySpan<Char>

Text privátního klíče zakódovaného 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íč kó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.

Poznámky

SubjectPublicKeyInfo z certifikátu určuje, jaké popisky PEM jsou přijímány pro privátní klíč. U certifikátů RSA jsou akceptovanými popisky PEM privátního klíče 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 přijímaný popisek PEM privátního klíče "PRIVÁTNÍ KLÍČ".

Položky s kódováním 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 oba certPem a keyPem, například CreateFromPem(combinedCertAndKey, combinedCertAndKey);. 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 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žití vlastního chování při načítání.

U klíčů chráněných heslem zakódovaných PEM použijte CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) k zadání hesla.