X509Certificate2.CreateFromPemFile(String, String) 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.

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPemFile (string certPemFilePath, string? keyPemFilePath = default);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPemFile : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPemFile (certPemFilePath As String, Optional keyPemFilePath As String = Nothing) As X509Certificate2

Parameter

certPemFilePath

String

Jalur untuk sertifikat X509 yang dikodekan PEM.

keyPemFilePath

String

Jika ditentukan, jalur untuk kunci privat yang dikodekan PEM. 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 tidak berisi kunci privat yang dikodekan keyPemFilePath PEM, atau salah bentuk.

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

ArgumentNullException

certPemFilePathadalah null.

Keterangan

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

SubjectPublicKeyInfo dari sertifikat menentukan label PEM apa yang diterima untuk kunci privat. Untuk sertifikat RSA, label PEM kunci privat yang diterima adalah "RSA PRIVATE KEY" dan "PRIVATE KEY". Untuk sertifikat ECDSA, label PEM kunci privat yang diterima adalah "EC PRIVATE KEY" dan "PRIVATE KEY". Untuk sertifikat DSA, label PEM kunci privat yang diterima adalah "KUNCI PRIVAT".

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 yang dapat diterima 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 yang dilindungi kata sandi, gunakan CreateFromEncryptedPemFile(String, ReadOnlySpan<Char>, String) untuk menentukan kata sandi.