X509Certificate2.CreateFromEncryptedPemFile Methode

Definition

Erstellt ein neues X509-Zertifikat aus dem Dateiinhalt eines RFC 7468 PEM-codierten Zertifikats und kennwortgeschützten privaten Schlüssels.

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPemFile(string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);
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
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

Parameter

certPemFilePath
String

Der Pfad für das PEM-codierte X509-Zertifikat.

password
ReadOnlySpan<Char>

Das Kennwort für das verschlüsselte PEM.

keyPemFilePath
String

Wenn angegeben, wird der Pfad für den kennwortgeschützten PEM-codierten privaten Schlüssel angegeben. Wenn nicht angegeben, wird die certPemFilePath Datei verwendet, um den privaten Schlüssel zu laden.

Gibt zurück

Ein neues Zertifikat mit dem privaten Schlüssel.

Attribute

Ausnahmen

Der Inhalt des Dateipfads certPemFilePath enthält kein PEM-codiertes Zertifikat oder ist falsch formatiert.

-oder-

Der Inhalt des Dateipfads keyPemFilePath enthält keinen kennwortgeschützten PEM-codierten privaten Schlüssel oder ist falsch formatiert.

-oder-

Der Inhalt des Dateipfads enthält keyPemFilePath einen Schlüssel, der nicht mit dem öffentlichen Schlüssel im Zertifikat übereinstimmt.

-oder-

Das Zertifikat verwendet einen unbekannten Algorithmus für öffentliche Schlüssel.

-oder-

Das für den privaten Schlüssel angegebene Kennwort ist falsch.

certPemFilePath ist null.

Hinweise

Weitere Dokumentation zu Ausnahmen, die ausgelöst werden können, finden Sie ReadAllText(String) in der Dokumentation.

Kennwortgeschützte PEM-codierte Schlüssel werden immer mit der PEM-Bezeichnung "VERSCHLÜSSELTER PRIVATER SCHLÜSSEL" erwartet.

PEM-codierte Elemente mit einer anderen Bezeichnung werden ignoriert.

Kombinierte PEM-codierte Zertifikate und Schlüssel erfordern keine bestimmte Reihenfolge. Für das Zertifikat wird das erste Zertifikat mit einer ZERTIFIKATbezeichnung geladen. Für den privaten Schlüssel wird der erste private Schlüssel mit der Bezeichnung "VERSCHLÜSSELTER PRIVATER SCHLÜSSEL" geladen. Komplexere Szenarien zum Laden von Zertifikaten und privaten Schlüsseln können zum Aufzählen von PEM-codierten Werten und zum Anwenden eines benutzerdefinierten Ladeverhaltens verwendet PemEncoding werden.

Verwenden Sie CreateFromPemFile(String, String)für PEM-codierte Schlüssel ohne Kennwort.

Gilt für: