X509Certificate2.CreateFromEncryptedPemFile Metodo

Definizione

Crea un nuovo certificato X509 dal contenuto del file di un certificato con codifica PEM RFC 7468 e da una chiave privata protetta da password.

[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.X509Certificate2
static member CreateFromEncryptedPemFile : string * ReadOnlySpan<char> * string -> System.Security.Cryptography.X509Certificates.X509Certificate2
Public Shared Function CreateFromEncryptedPemFile (certPemFilePath As String, password As ReadOnlySpan(Of Char), Optional keyPemFilePath As String = Nothing) As X509Certificate2

Parametri

certPemFilePath
String

Percorso del certificato X509 con codifica PEM.

password
ReadOnlySpan<Char>

Password per il pem crittografato.

keyPemFilePath
String

Se specificato, il percorso della chiave privata con codifica PEM protetta da password. Se non specificato, il certPemFilePath file verrà usato per caricare la chiave privata.

Valori restituiti

Nuovo certificato con la chiave privata.

Attributi

Eccezioni

Il contenuto del percorso del file in certPemFilePath non contiene un certificato con codifica PEM o è in formato non valido.

oppure

Il contenuto del percorso del file in keyPemFilePath non contiene una chiave privata con codifica PEM protetta da password o è in formato non valido.

oppure

Il contenuto del percorso del file in keyPemFilePath contiene una chiave che non corrisponde alla chiave pubblica nel certificato.

oppure

Il certificato usa un algoritmo di chiave pubblica sconosciuto.

oppure

La password specificata per la chiave privata non è corretta.

certPemFilePath è null.

Commenti

Per ReadAllText(String) altre informazioni sulle eccezioni che possono essere generate, vedere la documentazione aggiuntiva.

Le chiavi con codifica PEM protette da password devono sempre avere l'etichetta PEM "ENCRYPTED PRIVATE KEY".

Gli elementi con codifica PEM con un'etichetta diversa vengono ignorati.

I certificati e le chiavi con codifica PEM combinati non richiedono un ordine specifico. Per il certificato, viene caricato il primo certificato con un'etichetta CERTIFICATE. Per la chiave privata, viene caricata la prima chiave privata con l'etichetta "ENCRYPTED PRIVATE KEY". Gli scenari più avanzati per il caricamento di certificati e chiavi private possono sfruttare PemEncoding per enumerare i valori con codifica PEM e applicare qualsiasi comportamento di caricamento personalizzato.

Per le chiavi con codifica PEM senza password, usare CreateFromPemFile(String, String).

Si applica a