X509Certificate2.CreateFromEncryptedPem Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente di creare un nuovo certificato X509 dal contenuto di un certificato RFC 7468 con codifica PEM e una chiave privata protetta da password.
public:
static System::Security::Cryptography::X509Certificates::X509Certificate2 ^ CreateFromEncryptedPem(ReadOnlySpan<char> certPem, ReadOnlySpan<char> keyPem, ReadOnlySpan<char> password);
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);
static member CreateFromEncryptedPem : ReadOnlySpan<char> * ReadOnlySpan<char> * ReadOnlySpan<char> -> System.Security.Cryptography.X509Certificates.X509Certificate2
[<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
Parametri
- certPem
- ReadOnlySpan<Char>
Testo del certificato X509 con codifica PEM.
- keyPem
- ReadOnlySpan<Char>
Testo della chiave privata con codifica PEM protetta da password.
- password
- ReadOnlySpan<Char>
Password per la codifica PEM crittografata.
Restituisce
Nuovo certificato con la chiave privata.
- Attributi
Eccezioni
Il contenuto di certPem
non include un certificato con codifica PEM o ha un formato non corretto
-oppure-
Il contenuto di keyPem
non include una chiave privata con codifica PEM protetta da password o ha un formato non corretto.
-oppure-
Il contenuto di keyPem
include una chiave che non corrisponde alla chiave pubblica nel certificato.
-oppure-
Il certificato usa un algoritmo a chiave pubblica sconosciuto.
-oppure-
La password specificata per la chiave privata non è corretta.
Commenti
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.
Se il certificato con codifica PEM e la chiave privata sono nello stesso testo, usare la stessa stringa per entrambi certPem
e keyPem
, ad esempio , CreateFromEncryptedPem(combinedCertAndKey, combinedCertAndKey, theKeyPassword);
. I certificati e le chiavi con codifica PEM combinati non richiedono un ordine specifico. Per il certificato, il primo certificato con un'etichetta CERTIFICATE viene caricato. Per la chiave privata, viene caricata la prima chiave privata con l'etichetta "ENCRYPTED PRIVATE KEY". 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 CreateFromPem(ReadOnlySpan<Char>, ReadOnlySpan<Char>).