X509Certificate2.CreateFromPem Método

Definición

Espacio de nombres:

System.Security.Cryptography.X509Certificates

Ensamblado:

System.Security.Cryptography.dll

Sobrecargas

CreateFromPem(ReadOnlySpan<Char>)	Crea un nuevo certificado X509 a partir del contenido de un certificado con codificación PEM de RFC 7468.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Crea un certificado X509 nuevo a partir del contenido de un certificado con codificación PEM de RFC 7468 y una clave privada.

CreateFromPem(ReadOnlySpan<Char>)

Source:

X509Certificate2.cs

Crea un nuevo certificado X509 a partir del contenido de un certificado con codificación PEM de RFC 7468.

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2

Parámetros

certPem

ReadOnlySpan<Char>

Texto del certificado X509 codificado en PEM.

Devoluciones

X509Certificate2

Nuevo certificado X509.

Atributos

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

El contenido de certPem no incluye un certificado con codificación PEM o tiene un formato incorrecto.

Comentarios

Esto carga el primer PEM bien formado encontrado con una etiqueta CERTIFICATE.

Para los certificados codificados en PEM con una clave privada, use CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).

Para los certificados codificados en PEM en un archivo, use X509Certificate2(String).

CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Source:

X509Certificate2.cs

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

public:
 static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPem (ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2

Parámetros

certPem

ReadOnlySpan<Char>

Texto del certificado X509 codificado en PEM.

keyPem

ReadOnlySpan<Char>

Texto de la clave privada con codificación PEM.

Devoluciones

X509Certificate2

Certificado nuevo con la clave privada.

Atributos

UnsupportedOSPlatformAttribute

Excepciones

CryptographicException

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

Comentarios

SubjectPublicKeyInfo del certificado determina qué etiquetas PEM se aceptan para la clave privada. En el caso de los certificados RSA, las etiquetas PEM de clave privada aceptadas son "RSA PRIVATE KEY" y "PRIVATE KEY". En el caso de los certificados ECDSA, las etiquetas PEM de clave privada aceptadas son "EC PRIVATE KEY" y "PRIVATE KEY". En el caso de los certificados DSA, la etiqueta PEM de clave privada aceptada es "CLAVE PRIVADA".

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, CreateFromPem(combinedCertAndKey, combinedCertAndKey);. 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 una etiqueta aceptable. 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 con codificación PEM protegidas con contraseña, use CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) para especificar una contraseña.