X509Certificate2.CreateFromPem 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.
Sobrecargas
| CreateFromPem(ReadOnlySpan<Char>) |
Cria um novo certificado X509 com base no conteúdo de um certificado codificado em PEM RFC 7468. |
| CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>) |
Cria um certificado X509 a partir do conteúdo de um certificado codificado por PEM do RFC 7468 e da chave privada. |
CreateFromPem(ReadOnlySpan<Char>)
- Origem:
- X509Certificate2.cs
- Origem:
- X509Certificate2.cs
- Origem:
- X509Certificate2.cs
Cria um novo certificado X509 com base no conteúdo de um certificado codificado em PEM RFC 7468.
public:
static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem);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);static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char)) As X509Certificate2Parâmetros
- certPem
- ReadOnlySpan<Char>
O texto do certificado X509 codificado em PEM.
Retornos
Um novo certificado X509.
- Atributos
Exceções
O conteúdo de certPem não contém um certificado codificado por PEM ou está malformado.
Comentários
Isso carrega o primeiro PEM bem formado encontrado com um rótulo CERTIFICATE.
Para certificados codificados em PEM com uma chave privada, use CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).
Para certificados codificados em PEM em um arquivo, use X509Certificate2(String).
Aplica-se a
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
- Origem:
- X509Certificate2.cs
- Origem:
- X509Certificate2.cs
- Origem:
- X509Certificate2.cs
Cria um certificado X509 a partir do conteúdo de um certificado codificado por PEM do RFC 7468 e da chave privada.
public:
static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem);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);static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPem : ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2Public Shared Function CreateFromPem (certPem As ReadOnlySpan(Of Char), keyPem As ReadOnlySpan(Of Char)) As X509Certificate2Parâmetros
- certPem
- ReadOnlySpan<Char>
O texto do certificado X509 codificado em PEM.
- keyPem
- ReadOnlySpan<Char>
O texto da chave privada codificada em PEM.
Retornos
Um novo certificado com a chave privada.
- Atributos
Exceções
O conteúdo de certPem não contém um certificado codificado por PEM ou está malformado.
- ou -
O conteúdo de keyPem não contém uma chave privada codificada por PEM ou está malformado.
- ou -
O conteúdo de keyPem contém uma chave que não corresponde à chave pública do certificado.
- ou -
O certificado usa um algoritmo de chave pública desconhecido.
Comentários
O SubjectPublicKeyInfo do certificado determina quais rótulos PEM são aceitos para a chave privada. Para certificados RSA, os rótulos PEM de chave privada aceitos são "RSA PRIVATE KEY" e "PRIVATE KEY". Para certificados ECDSA, os rótulos PEM de chave privada aceitos são "EC PRIVATE KEY" e "PRIVATE KEY". Para certificados DSA, o rótulo PEM de chave privada aceito é "PRIVATE KEY".
Os itens codificados em PEM que têm um rótulo diferente são ignorados.
Se o certificado codificado em PEM e a chave privada estiverem no mesmo texto, use a mesma cadeia de caracteres para certPem e keyPem, por exemplo, CreateFromPem(combinedCertAndKey, combinedCertAndKey);. 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 um rótulo aceitável é 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 protegidas por senha, use CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) para especificar uma senha.
