X509Certificate2.CreateFromPemFile(String, String) Yöntem

Tanım

Ad Alanı:

System.Security.Cryptography.X509Certificates

Bütünleştirilmiş Kod:

System.Security.Cryptography.dll

Kaynak:

X509Certificate2.cs

RFC 7468 PEM kodlu sertifikanın ve özel anahtarın dosya içeriğinden yeni bir X509 sertifikası oluşturur.

[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

Parametreler

certPemFilePath

String

PEM ile kodlanmış X509 sertifikasının yolu.

keyPemFilePath

String

Belirtilirse, PEM ile kodlanmış özel anahtarın yolu. Belirtilmezse, certPemFilePath dosya özel anahtarı yüklemek için kullanılır.

Döndürülenler

X509Certificate2

Özel anahtara sahip yeni bir sertifika.

Öznitelikler

UnsupportedOSPlatformAttribute

Özel durumlar

CryptographicException

içindeki certPemFilePath dosya yolunun içeriği PEM ile kodlanmış bir sertifika içermiyor veya hatalı biçimlendirilmiş.

-veya-

içindeki keyPemFilePath dosya yolunun içeriği PEM ile kodlanmış özel anahtar içermiyor veya hatalı biçimlendirilmiş.

-veya-

içindeki keyPemFilePath dosya yolunun içeriği, sertifikadaki ortak anahtarla eşleşmeyen bir anahtar içeriyor.

-veya-

Sertifika bilinmeyen bir ortak anahtar algoritması kullanıyor.

ArgumentNullException

certPemFilePath, null değeridir.

Açıklamalar

Oluşturulabilecek özel durumlar hakkında ek belgeler için bkz ReadAllText(String) .

Sertifikadaki SubjectPublicKeyInfo, özel anahtar için hangi PEM etiketlerinin kabul edileceğini belirler. RSA sertifikaları için, kabul edilen özel anahtar PEM etiketleri "RSA ÖZEL ANAHTAR" ve "ÖZEL ANAHTAR"dır. ECDSA sertifikaları için, kabul edilen özel anahtar PEM etiketleri "EC PRIVATE KEY" ve "PRIVATE KEY" şeklindedir. DSA sertifikaları için kabul edilen özel anahtar PEM etiketi "ÖZEL ANAHTAR"dır.

Farklı bir etikete sahip PEM ile kodlanmış öğeler yoksayılır.

Birleştirilmiş PEM ile kodlanmış sertifikalar ve anahtarlar belirli bir sıra gerektirmez. Sertifika için, CERTIFICATE etiketine sahip ilk sertifika yüklenir. Özel anahtar için, kabul edilebilir etikete sahip ilk özel anahtar yüklenir. Sertifikaları ve özel anahtarları yüklemek için daha gelişmiş senaryolar PEM ile kodlanmış değerleri listelemek ve herhangi bir özel yükleme davranışını uygulamak için kullanılabilir PemEncoding .

Parola korumalı PEM ile kodlanmış anahtarlar için parola belirtmek için kullanın CreateFromEncryptedPemFile(String, ReadOnlySpan<Char>, String) .