Comparteix a través de


X509Certificate2.CreateFromEncryptedPemFile Método

Definición

Crea un certificado X509 nuevo a partir del contenido del archivo de un certificado con codificación PEM de RFC 7468 y una clave privada protegida con contraseña.

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

Parámetros

certPemFilePath
String

Ruta de acceso del certificado X509 con codificación PEM.

password
ReadOnlySpan<Char>

Contraseña del PEM cifrado.

keyPemFilePath
String

Si se especifica, la ruta de acceso de la clave privada con codificación PEM protegida con contraseña. Si no se especifica, el archivo certPemFilePath se usará para cargar la clave privada.

Devoluciones

Certificado nuevo con la clave privada.

Atributos

Excepciones

El contenido de la ruta de acceso al archivo en certPemFilePath no incluye un certificado con codificación PEM o tiene un formato incorrecto.

O bien

El contenido de la ruta de acceso al archivo en keyPemFilePath no incluye una clave privada con codificación PEM protegida con contraseña o tiene un formato incorrecto.

O bien

El contenido de la ruta de acceso al archivo en keyPemFilePath incluye una clave que no coincide con la clave pública del certificado.

O bien

El certificado usa un algoritmo de clave pública desconocido.

O bien

La contraseña especificada para la clave privada no es correcta.

certPemFilePath es null.

Comentarios

Consulte ReadAllText(String) para obtener documentación adicional sobre las excepciones que se pueden producir.

Siempre se espera que las claves con codificación PEM protegidas con contraseña tengan la etiqueta PEM "ENCRYPTED PRIVATE KEY".

Los elementos codificados en PEM que tienen una etiqueta diferente se omiten.

Los certificados y claves codificados peM combinados no requieren un orden específico. Para el certificado, se carga el primer certificado con una etiqueta CERTIFICATE. Para la clave privada, se carga la primera clave privada con la etiqueta "ENCRYPTED PRIVATE KEY". Los escenarios más avanzados para cargar certificados y claves privadas pueden aprovechar PemEncoding para enumerar valores codificados por PEM y aplicar cualquier comportamiento de carga personalizado.

Para las claves codificadas en PEM sin contraseña, use CreateFromPemFile(String, String).

Se aplica a