X509Certificate2.CreateFromPem Metode

Definisi

Ruang nama:

System.Security.Cryptography.X509Certificates

Rakitan:

System.Security.Cryptography.dll

Overload

CreateFromPem(ReadOnlySpan<Char>)	Membuat sertifikat X509 baru dari konten sertifikat yang dikodekan RFC 7468 PEM.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Membuat sertifikat X509 baru dari konten sertifikat yang dikodekan RFC 7468 PEM dan kunci privat.

CreateFromPem(ReadOnlySpan<Char>)

Sumber:

X509Certificate2.cs

Membuat sertifikat X509 baru dari konten sertifikat yang dikodekan RFC 7468 PEM.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);

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

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

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2

Parameter

certPem

ReadOnlySpan<Char>

Teks sertifikat X509 yang dikodekan PEM.

Mengembalikan

X509Certificate2

Sertifikat X509 baru.

Atribut

UnsupportedOSPlatformAttribute

Pengecualian

CryptographicException

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

Keterangan

Ini memuat PEM pertama yang terbentuk dengan baik yang ditemukan dengan label SERTIFIKAT.

Untuk sertifikat yang dikodekan PEM dengan kunci privat, gunakan CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).

Untuk sertifikat yang dikodekan PEM dalam file, gunakan X509Certificate2(String).

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Sumber:

X509Certificate2.cs

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

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

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

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

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem 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.

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

Keterangan

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.

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