X509Certificate2.CreateFromEncryptedPem Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea un certificado X509 nuevo a partir del contenido 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 ^ CreateFromEncryptedPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2Public Shared Function CreateFromEncryptedPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char), password As ReadOnlySpan(Of Char)) As X509Certificate2Parámetros
- certPem
- ReadOnlySpan<Char>
Texto del certificado X509 codificado en PEM.
- keyPem
- ReadOnlySpan<Char>
Texto de la clave privada con codificación PEM protegida con contraseña.
- password
- ReadOnlySpan<Char>
Contraseña del PEM cifrado.
Devoluciones
Certificado nuevo con la clave privada.
- Atributos
Excepciones
El contenido de certPem no incluye un certificado con codificación PEM o tiene un formato incorrecto.
O bien
El contenido de keyPem no incluye una clave privada con codificación PEM protegida con contraseña o tiene un formato incorrecto.
O bien
El contenido de keyPem 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.
Comentarios
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.
Si el certificado codificado en PEM y la clave privada están en el mismo texto, use la misma cadena para certPem y keyPem, por ejemplo, CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);. Los certificados y claves codificados en 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 en PEM y aplicar cualquier comportamiento de carga personalizado.
Para las claves codificadas en PEM sin una contraseña, use CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).
