X509Certificate2.CreateFromPemFile(String, String) Metodo

Definizione

Spazio dei nomi:

System.Security.Cryptography.X509Certificates

Assembly:

System.Security.Cryptography.dll

Source:

X509Certificate2.cs

Consente di creare un nuovo certificato X509 dal contenuto del file di un certificato RFC 7468 con codifica PEM e una chiave privata.

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.X509Certificates.X509Certificate2 CreateFromPemFile (string certPemFilePath, string? keyPemFilePath = default);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateFromPemFile : string * string -> System.Security.Cryptography.X509Certificates.X509Certificate2

Public Shared Function CreateFromPemFile (certPemFilePath As String, Optional keyPemFilePath As String = Nothing) As X509Certificate2

Parametri

certPemFilePath

String

Percorso del certificato X509 con codifica PEM.

keyPemFilePath

String

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

Restituisce

X509Certificate2

Nuovo certificato con la chiave privata.

Attributi

UnsupportedOSPlatformAttribute

Eccezioni

CryptographicException

Il contenuto del percorso file in certPemFilePath non include un certificato con codifica PEM o ha un formato non corretto

-oppure-

Il contenuto del percorso file in keyPemFilePath non include una chiave privata con codifica PEM o ha un formato non corretto.

-oppure-

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

-oppure-

Il certificato usa un algoritmo a chiave pubblica sconosciuto.

ArgumentNullException

certPemFilePath è null.

Commenti

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

SubjectPublicKeyInfo dal certificato determina quali etichette PEM vengono accettate per la chiave privata. Per i certificati RSA, le etichette PEM a chiave privata accettate sono "RSA PRIVATE KEY" e "PRIVATE KEY". Per i certificati ECDSA, le etichette PEM della chiave privata accettate sono "EC PRIVATE KEY" e "PRIVATE KEY". Per i certificati DSA, l'etichetta PEM della chiave privata accettata è "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 un'etichetta accettabile. 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 protette da password, usare CreateFromEncryptedPemFile(String, ReadOnlySpan<Char>, String) per specificare una password.