X509Certificate2.CreateFromEncryptedPem Metode

Definisi

Ruang nama:

System.Security.Cryptography.X509Certificates

Rakitan:

System.Security.Cryptography.dll

Sumber:

X509Certificate2.cs

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

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromEncryptedPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);

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

Public Shared Function CreateFromEncryptedPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char), password As ReadOnlySpan(Of Char)) As X509Certificate2

Parameter

certPem

ReadOnlySpan<Char>

Teks sertifikat X509 yang dikodekan PEM.

keyPem

ReadOnlySpan<Char>

Teks kunci privat yang dikodekan PEM yang dilindungi kata sandi.

password

ReadOnlySpan<Char>

Kata sandi untuk PEM terenkripsi.

Mengembalikan

X509Certificate2

Sertifikat baru dengan kunci privat.

Atribut

UnsupportedOSPlatformAttribute

Pengecualian

CryptographicException

Isi certPem tidak berisi sertifikat yang dikodekan PEM, atau salah format.

-atau-

Isi keyPem tidak berisi kunci privat yang dikodekan PEM yang dilindungi kata sandi, atau salah format.

-atau-

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

Keterangan

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

Item berkode PEM yang memiliki label berbeda diabaikan.

Jika sertifikat yang dikodekan PEM dan kunci privat berada dalam teks yang sama, gunakan string yang sama untuk dan certPemkeyPem, misalnya, CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);. 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 CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).