X509Certificate2.CreateFromEncryptedPemFile Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuat sertifikat X509 baru dari konten file sertifikat yang dikodekan RFC 7468 PEM dan kunci privat yang dilindungi kata sandi.
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
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
Sertifikat baru dengan kunci privat.
- Atribut
Pengecualian
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.
certPemFilePath
adalah 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).