X509Certificate2.CreateFromEncryptedPemFile Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography.X509Certificates

Zestaw:

System.Security.Cryptography.dll

Źródło:

X509Certificate2.cs

Tworzy nowy certyfikat X509 z zawartości pliku certyfikatu PEM zakodowanego w standardzie RFC 7468 i chronionego hasłem klucza prywatnego.

[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

Ścieżka certyfikatu X509 zakodowanego w standardzie PEM.

password

ReadOnlySpan<Char>

Hasło zaszyfrowanego PEM.

keyPemFilePath

String

Jeśli zostanie określona, ścieżka klucza prywatnego zakodowanego za pomocą hasła zakodowanego w formacie PEM. Jeśli plik nie zostanie podany, certPemFilePath zostanie użyty do załadowania klucza prywatnego.

Zwraca

X509Certificate2

Nowy certyfikat z kluczem prywatnym.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

CryptographicException

Zawartość ścieżki pliku w pliku certPemFilePath nie zawiera certyfikatu zakodowanego za pomocą protokołu PEM lub jest nieprawidłowo sformułowana.

-lub-

Zawartość ścieżki pliku w pliku keyPemFilePath nie zawiera chronionego hasłem klucza prywatnego zakodowanego za pomocą protokołu PEM lub jest nieprawidłowo sformułowana.

-lub-

Zawartość ścieżki pliku w pliku keyPemFilePath zawiera klucz, który nie jest zgodny z kluczem publicznym w certyfikacie.

-lub-

Certyfikat używa nieznanego algorytmu klucza publicznego.

-lub-

Hasło określone dla klucza prywatnego jest niepoprawne.

ArgumentNullException

certPemFilePath to null.

Uwagi

Zobacz ReadAllText(String) dodatkową dokumentację dotyczącą wyjątków, które można zgłosić.

Klucze zakodowane przy użyciu protokołu PEM chronione hasłem mają zawsze etykietę PEM "ENCRYPTED PRIVATE KEY".

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

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 etykietą "ZASZYFROWANY KLUCZ PRYWATNY". 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 za pomocą protokołu PEM bez hasła użyj polecenia CreateFromPemFile(String, String).