X509Certificate2.CreateFromEncryptedPemFile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um novo certificado X509 com base no conteúdo do arquivo de um certificado codificado em PEM rfc 7468 e chave privada protegida por senha.
[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.X509Certificate2static member CreateFromEncryptedPemFile : string * ReadOnlySpan<char> * string -> System.Security.Cryptography.X509Certificates.X509Certificate2Public Shared Function CreateFromEncryptedPemFile (certPemFilePath As String, password As ReadOnlySpan(Of Char), Optional keyPemFilePath As String = Nothing) As X509Certificate2Parâmetros
- certPemFilePath
- String
O caminho para o certificado X509 codificado em PEM.
- password
- ReadOnlySpan<Char>
A senha do PEM criptografado.
- keyPemFilePath
- String
Se especificado, o caminho para a chave privada codificada em PEM protegida por senha.
Se não for especificado, o certPemFilePath arquivo será usado para carregar a chave privada.
Retornos
Um novo certificado com a chave privada.
- Atributos
Exceções
O conteúdo do caminho do arquivo não certPemFilePath contém um certificado codificado em PEM ou está malformado.
- ou -
O conteúdo do caminho do arquivo não keyPemFilePath contém uma chave privada codificada em PEM protegida por senha ou está malformado.
- ou -
O conteúdo do caminho do arquivo contém keyPemFilePath uma chave que não corresponde à chave pública no certificado.
- ou -
O certificado usa um algoritmo de chave pública desconhecido.
- ou -
A senha especificada para a chave privada está incorreta.
certPemFilePath é null.
Comentários
Consulte ReadAllText(String) a documentação adicional sobre exceções que podem ser geradas.
Espera-se que as chaves codificadas em PEM protegidas por senha tenham sempre o rótulo PEM "ENCRYPTED PRIVATE KEY".
Os itens codificados em PEM que têm um rótulo diferente são ignorados.
Certificados e chaves codificados em PEM combinados não exigem uma ordem específica. Para o certificado, o primeiro certificado com um rótulo CERTIFICATE é carregado. Para a chave privada, a primeira chave privada com o rótulo "ENCRYPTED PRIVATE KEY" é 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 senha, use CreateFromPemFile(String, String).
