X509Certificate2.CreateFromPem Méthode

Définition

Espace de noms:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Surcharges

CreateFromPem(ReadOnlySpan<Char>)	Crée un certificat X509 à partir du contenu d’un certificat encodé en PEM RFC 7468.
CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	Crée un certificat x509 à partir du contenu d’un certificat RFC 7468 et d’une clé privée encodés PEM.

CreateFromPem(ReadOnlySpan<Char>)

Source:

X509Certificate2.cs

Crée un certificat X509 à partir du contenu d’un certificat encodé en PEM 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

Paramètres

certPem

ReadOnlySpan<Char>

Texte du certificat X509 encodé en PEM.

Retours

X509Certificate2

Un nouveau certificat X509.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Le contenu de certPem ne contient pas de certificat encodé PEM, ou il est incorrect.

Remarques

Cela charge le premier PEM bien formé trouvé avec une étiquette CERTIFICATE.

Pour les certificats encodés pem avec une clé privée, utilisez CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).

Pour les certificats encodés pem dans un fichier, utilisez X509Certificate2(String).

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

Source:

X509Certificate2.cs

Crée un certificat x509 à partir du contenu d’un certificat RFC 7468 et d’une clé privée encodés PEM.

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

Paramètres

certPem

ReadOnlySpan<Char>

Texte du certificat X509 encodé en PEM.

keyPem

ReadOnlySpan<Char>

Texte de la clé privée encodée PEM.

Retours

X509Certificate2

Nouveau certificat avec la clé privée.

Attributs

UnsupportedOSPlatformAttribute

Exceptions

CryptographicException

Le contenu de certPem ne contient pas de certificat encodé PEM, ou il est incorrect.

- ou -

Le contenu de keyPem ne comprend pas de clé privée encodée PEM, ou elle est incorrecte.

- ou -

Le contenu de keyPem comprend une clé qui ne correspond pas à la clé publique du certificat.

- ou -

Le certificat utilise un algorithme de clé publique inconnu.

Remarques

L’objet SubjectPublicKeyInfo du certificat détermine les étiquettes PEM acceptées pour la clé privée. Pour les certificats RSA, les étiquettes PEM de clé privée acceptées sont « CLÉ PRIVÉE RSA » et « CLÉ PRIVÉE ». Pour les certificats ECDSA, les étiquettes PEM de clé privée acceptées sont « CLÉ PRIVÉE EC » et « CLÉ PRIVÉE ». Pour les certificats DSA, l’étiquette PEM de clé privée acceptée est « CLÉ PRIVÉE ».

Les éléments encodés en PEM qui ont une étiquette différente sont ignorés.

Si le certificat encodé en PEM et la clé privée se trouvent dans le même texte, utilisez la même chaîne pour certPem et keyPem, par exemple, CreateFromPem(combinedCertAndKey, combinedCertAndKey);. Les certificats et clés encodés en PEM combinés ne nécessitent pas d’ordre spécifique. Pour le certificat, le premier certificat avec une étiquette CERTIFICATE est chargé. Pour la clé privée, la première clé privée avec une étiquette acceptable est chargée. Des scénarios plus avancés de chargement de certificats et de clés privées peuvent être utilisés PemEncoding pour énumérer les valeurs encodées pem et appliquer tout comportement de chargement personnalisé.

Pour les clés encodées pem protégées par mot de passe, utilisez CreateFromEncryptedPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>, ReadOnlySpan<Char>) pour spécifier un mot de passe.