X509Certificate2.CreateFromEncryptedPemFile Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un certificat x509 à partir du contenu de fichier 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 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromEncryptedPemFile (string certPemFilePath, ReadOnlySpan<char> password, string? keyPemFilePath = default);static member CreateFromEncryptedPemFile : string * ReadOnlySpan<char> * string -> System.Security.Cryptography.X509Certificates.X509Certificate2[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static 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 X509Certificate2Paramètres
- certPemFilePath
- String
Chemin pour le certificat x509 encodé PEM.
- password
- ReadOnlySpan<Char>
Mot de passe du PEM chiffré.
- keyPemFilePath
- String
S’il est spécifié, il s’agit du chemin d'accès de la clé privée codée en PEM protégée par mot de passe.
S’il n’est pas spécifié, le fichier certPemFilePath sera utilisé pour charger la clé privée.
Retours
Nouveau certificat avec la clé privée.
- Attributs
Exceptions
Le contenu du chemin de fichier dans certPemFilePath ne contient pas de certificat encodé PEM, ou il est incorrect.
- ou -
Le contenu du chemin de fichier dans keyPemFilePath ne comprend pas de clé privée encodée PEM protégée par mot de passe, ou elle est incorrecte.
- ou -
Le contenu du chemin de fichier dans keyPemFilePath 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.
certPemFilePath a la valeur null.
Remarques
Consultez ReadAllText(String) la documentation supplémentaire sur les exceptions qui peuvent être levées.
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.
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 CreateFromPemFile(String, String).
