X509Certificate2.CreateFromPem Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.dll

Przeciążenia

CreateFromPem(ReadOnlySpan<Char>)	Tworzy nowy certyfikat X509 z zawartości certyfikatu zakodowanego w standardzie PEM RFC 7468.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Tworzy nowy certyfikat X509 z zawartości certyfikatu PEM zakodowanego w standardzie RFC 7468 i klucza prywatnego.

CreateFromPem(ReadOnlySpan<Char>)

Źródło:

X509Certificate2.cs

Tworzy nowy certyfikat X509 z zawartości certyfikatu zakodowanego w standardzie PEM RFC 7468.

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>

Tekst certyfikatu X509 zakodowanego w standardzie PEM.

Zwraca

X509Certificate2

Nowy certyfikat X509.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Zawartość pliku certPem nie zawiera certyfikatu zakodowanego za pomocą protokołu PEM lub jest nieprawidłowo sformułowana.

Uwagi

Spowoduje to załadowanie pierwszego dobrze sformułowanego PEM znalezionego z etykietą CERTIFICATE.

W przypadku certyfikatów zakodowanych za pomocą klucza prywatnego należy użyć polecenia CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).

W przypadku certyfikatów zakodowanych za pomocą protokołu PEM w pliku użyj polecenia X509Certificate2(String).

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

Źródło:

X509Certificate2.cs

Tworzy nowy certyfikat X509 z zawartości certyfikatu PEM zakodowanego w standardzie RFC 7468 i klucza prywatnego.

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>

Tekst certyfikatu X509 zakodowanego w standardzie PEM.

keyPem

ReadOnlySpan<Char>

Tekst klucza prywatnego zakodowanego w formacie PEM.

Zwraca

X509Certificate2

Nowy certyfikat z kluczem prywatnym.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Zawartość pliku certPem nie zawiera certyfikatu zakodowanego za pomocą protokołu PEM lub jest nieprawidłowo sformułowana.

-lub-

Zawartość klucza keyPem prywatnego zakodowanego w formacie PEM nie jest źle sformułowana.

-lub-

Zawartość pliku keyPem zawiera klucz, który nie jest zgodny z kluczem publicznym w certyfikacie.

-lub-

Certyfikat używa nieznanego algorytmu klucza publicznego.

Uwagi

SubjectPublicKeyInfo z certyfikatu określa, jakie etykiety PEM są akceptowane dla klucza prywatnego. W przypadku certyfikatów RSA akceptowane etykiety PEM klucza prywatnego to "KLUCZ PRYWATNY RSA" i "KLUCZ PRYWATNY". W przypadku certyfikatów ECDSA akceptowane etykiety PEM klucza prywatnego to "KLUCZ PRYWATNY EC" i "KLUCZ PRYWATNY". W przypadku certyfikatów DSA zaakceptowana etykieta PEM klucza prywatnego to "KLUCZ PRYWATNY".

Elementy zakodowane w formacie PEM, które mają inną etykietę, są ignorowane.

Jeśli certyfikat zakodowany za pomocą protokołu PEM i klucz prywatny znajdują się w tym samym tekście, użyj tego samego ciągu zarówno dla , jak certPem i keyPem, na przykład CreateFromPem(combinedCertAndKey, combinedCertAndKey);. Połączone certyfikaty i klucze zakodowane za pomocą protokołu PEM nie wymagają określonej kolejności. W przypadku certyfikatu jest ładowany pierwszy certyfikat z etykietą CERTYFIKAT. W przypadku klucza prywatnego jest ładowany pierwszy klucz prywatny z akceptowalną etykietą. Bardziej zaawansowane scenariusze ładowania certyfikatów i kluczy prywatnych mogą być używane PemEncoding do wyliczania wartości zakodowanych w formacie PEM i stosowania dowolnego niestandardowego zachowania ładowania.

W przypadku kluczy zakodowanych w formacie PEM chronionych hasłem użyj polecenia CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) , aby określić hasło.