Udostępnij za pośrednictwem


X509Certificate2.CreateFromEncryptedPemFile Metoda

Definicja

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

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

Ś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

Nowy certyfikat z kluczem prywatnym.

Atrybuty

Wyjątki

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.

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

Dotyczy