X509Certificate2.CreateFromEncryptedPem Método

Definição

Cria um novo certificado X509 a partir do conteúdo de um certificado codificado em PEM na RFC 7468 e da chave privada protegida por palavra-passe.

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);
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2
static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function CreateFromEncryptedPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char), password As ReadOnlySpan(Of Char)) As X509Certificate2

Parâmetros

certPem
ReadOnlySpan<Char>

O texto do certificado X509 codificado em PEM.

keyPem
ReadOnlySpan<Char>

O texto da chave privada protegida por palavra-passe codificada em PEM.

password
ReadOnlySpan<Char>

A palavra-passe do PEM encriptado.

Devoluções

Um novo certificado com a chave privada.

Atributos

Exceções

O conteúdo de certPem não contém um certificado codificado em PEM, caso contrário está malformado.

-ou-

O conteúdo de keyPem não contém uma chave privada codificada em PEM protegida por palavra-passe, caso contrário está malformada.

-ou-

O conteúdo de keyPem contém uma chave que não corresponde à chave pública no certificado.

-ou-

O certificado utiliza um algoritmo de chave pública desconhecido.

-ou-

A palavra-passe especificada para a chave privada está incorreta.

Observações

As chaves codificadas em PEM protegidas por palavra-passe devem sempre ter o rótulo PEM "CHAVE PRIVADA ENCRIPTADA".

Itens codificados em PEM que têm uma etiqueta diferente são ignorados.

Se o certificado codificado em PEM e a chave privada estiverem no mesmo texto, use a mesma cadeia para ambos certPem e keyPem, por exemplo, CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);. Certificados e chaves codificados em PEM combinados não requerem uma ordem específica. Para o certificado, é carregado o primeiro certificado com a etiqueta CERTIFICATE. Para a chave privada, a primeira chave privada com o rótulo "CHAVE PRIVADA ENCRIPTADA" é carregada. Cenários mais avançados para carregar certificados e chaves privadas podem aproveitar PemEncoding para enumerar valores codificados em PEM e aplicar qualquer comportamento de carregamento personalizado.

Para chaves codificadas em PEM sem palavra-passe, use CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).

Aplica-se a