X509Certificate2.CreateFromEncryptedPemFile 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 ile kodlanmış sertifikanın ve parola korumalı ö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 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);

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

Parametreler

certPemFilePath

String

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

password

ReadOnlySpan<Char>

Şifrelenmiş PEM'nin parolası.

keyPemFilePath

String

Belirtilirse, parola korumalı 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 parola korumalı 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.

-veya-

Özel anahtar için belirtilen parola yanlış.

ArgumentNullException

certPemFilePath, null değeridir.

Açıklamalar

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

Parola korumalı PEM kodlu anahtarların her zaman "ENCRYPTED PRIVATE KEY" PEM etiketine sahip olması beklenir.

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, "ENCRYPTED PRIVATE KEY" etiketine 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 .

Parolasız PEM ile kodlanmış anahtarlar için kullanın CreateFromPemFile(String, String).