X509Certificate2.CreateFromEncryptedPemFile Metode

Definisi

Ruang nama:

System.Security.Cryptography.X509Certificates

Rakitan:

System.Security.Cryptography.dll

Sumber:

X509Certificate2.cs

Membuat sertifikat X509 baru dari konten file sertifikat yang dikodekan RFC 7468 PEM dan kunci privat yang dilindungi kata sandi.

[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

Parameter

certPemFilePath

String

Jalur untuk sertifikat X509 yang dikodekan PEM.

password

ReadOnlySpan<Char>

Kata sandi untuk PEM terenkripsi.

keyPemFilePath

String

Jika ditentukan, jalur untuk kunci privat yang dikodekan PEM yang dilindungi kata sandi. Jika tidak ditentukan, certPemFilePath file akan digunakan untuk memuat kunci privat.

Mengembalikan

X509Certificate2

Sertifikat baru dengan kunci privat.

Atribut

UnsupportedOSPlatformAttribute

Pengecualian

CryptographicException

Isi jalur file di tidak berisi sertifikat yang dikodekan certPemFilePath PEM, atau salah format.

-atau-

Isi jalur file di keyPemFilePath tidak berisi kunci privat yang dikodekan PEM yang dilindungi kata sandi, atau salah format.

-atau-

Isi jalur file di keyPemFilePath berisi kunci yang tidak cocok dengan kunci publik dalam sertifikat.

-atau-

Sertifikat menggunakan algoritma kunci publik yang tidak diketahui.

-atau-

Kata sandi yang ditentukan untuk kunci privat salah.

ArgumentNullException

certPemFilePathadalah null.

Keterangan

Lihat ReadAllText(String) untuk dokumentasi tambahan tentang pengecualian yang dapat dilemparkan.

Kunci yang dikodekan PEM yang dilindungi kata sandi selalu diharapkan memiliki label PEM "ENCRYPTED PRIVATE KEY".

Item berkode PEM yang memiliki label berbeda diabaikan.

Gabungan sertifikat dan kunci yang dikodekan PEM tidak memerlukan urutan tertentu. Untuk sertifikat, sertifikat pertama dengan label SERTIFIKAT dimuat. Untuk kunci privat, kunci privat pertama dengan label "ENCRYPTED PRIVATE KEY" dimuat. Skenario yang lebih canggih untuk memuat sertifikat dan kunci privat dapat memanfaatkan PemEncoding untuk menghitung nilai yang dikodekan PEM dan menerapkan perilaku pemuatan kustom apa pun.

Untuk kunci yang dikodekan PEM tanpa kata sandi, gunakan CreateFromPemFile(String, String).