X509Certificate2.CreateFromEncryptedPem Méthode

Définition

Espace de noms:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Source:

X509Certificate2.cs

Crée un certificat x509 à partir du contenu d’un certificat RFC 7468 encodé PEM et de la clé privée protégée par mot de 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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
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

Paramètres

certPem

ReadOnlySpan<Char>

Texte du certificat X509 encodé pem.

keyPem

ReadOnlySpan<Char>

Texte de la clé privée encodée PEM protégée par mot de passe.

password

ReadOnlySpan<Char>

Mot de passe du PEM chiffré.

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 protégée par mot de passe, 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.

- ou -

Le mot de passe spécifié pour la clé privée est incorrect.

Remarques

Les clés pem protégées par mot de passe sont toujours censées avoir l’étiquette PEM « ENCRYPTED PRIVATE KEY ».

Les éléments encodés 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 et certPemkeyPem, par exemple, CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);. Les clés et certificats 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 portant l’étiquette « ENCRYPTED PRIVATE KEY » 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 sans mot de passe, utilisez CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).