ECDiffieHellman.ImportEncryptedPkcs8PrivateKey Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Importa el par de claves pública/privada desde una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en bytes, reemplazando las claves de este objeto. |
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Importa el par de claves pública/privada desde una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en caracteres, reemplazando las claves de este objeto. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Importa el par de claves pública/privada desde una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en bytes, reemplazando las claves de este objeto.
public:
override void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<System::Byte> passwordBytes, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);public override void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unitPublic Overrides Sub ImportEncryptedPkcs8PrivateKey (passwordBytes As ReadOnlySpan(Of Byte), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)Parámetros
- passwordBytes
- ReadOnlySpan<Byte>
Bytes que se van a usar como contraseña al descifrar el material de clave.
- source
- ReadOnlySpan<Byte>
Bytes de una estructura EncryptedPrivateKeyInfo de PKCS#8 en la codificación ASN.1-BER.
- bytesRead
- Int32
El resultado que devuelve este método contiene un valor que indica el número de bytes leídos de source. Este parámetro se trata como sin inicializar.
Excepciones
La contraseña es incorrecta.
O bien
El contenido de source indica que la función de derivación de claves (KDF) que se va a aplicar es la heredada de PKCS#12, que requiere contraseñas basadas en Char.
O bien
El contenido de source no representa una estructura EncryptedPrivateKeyInfo de PKCS#8 codificada con ASN.1-BER.
O bien
El contenido de source indica que la clave es para un algoritmo distinto del algoritmo que representa esta instancia.
O bien
El contenido de source representa la clave en un formato que no se admite.
O bien
No se ha podido importar la clave específica del algoritmo.
Comentarios
Los bytes de contraseña se pasan directamente a la función de derivación de claves (KDF) usada por el algoritmo indicado por el contenido de EncryptedPrivateKeyInfo. Esto permite la compatibilidad con otros sistemas que usan una codificación de texto distinta de UTF-8 al procesar contraseñas con PBKDF2 (función de derivación de claves basada en contraseña 2). Este método solo admite la codificación binaria (BER/CER/DER) de EncryptedPrivateKeyInfo. Si el valor está codificado en Base64 o en el formato de texto PEM, el autor de la llamada debe descodificar el contenido antes de llamar a este método.
Se aplica a
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Importa el par de claves pública/privada desde una estructura EncryptedPrivateKeyInfo de PKCS#8 después de descifrar con una contraseña basada en caracteres, reemplazando las claves de este objeto.
public:
override void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);public override void ImportEncryptedPkcs8PrivateKey (ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unitPublic Overrides Sub ImportEncryptedPkcs8PrivateKey (password As ReadOnlySpan(Of Char), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)Parámetros
- password
- ReadOnlySpan<Char>
Contraseña que se va a usar para descifrar el material de clave.
- source
- ReadOnlySpan<Byte>
Bytes de una estructura EncryptedPrivateKeyInfo de PKCS#8 en la codificación ASN.1-BER.
- bytesRead
- Int32
El resultado que devuelve este método contiene un valor que indica el número de bytes leídos de source. Este parámetro se trata como sin inicializar.
Excepciones
La contraseña es incorrecta.
O bien
El contenido de source no representa una estructura EncryptedPrivateKeyInfo de PKCS#8 codificada con ASN.1-BER.
O bien
El contenido de source indica que la clave es para un algoritmo distinto del algoritmo que representa esta instancia.
O bien
El contenido de source representa la clave en un formato que no se admite.
O bien
No se ha podido importar la clave específica del algoritmo.
Comentarios
Cuando el contenido de source indica un algoritmo que usa PBKDF1 (función de derivación de claves basada en contraseña 1) o PBKDF2 (función de derivación de claves basada en contraseña 2), la contraseña se convierte en bytes mediante la codificación UTF-8.
Este método solo admite la codificación binaria (BER/CER/DER) de EncryptedPrivateKeyInfo.
Si el valor está codificado en Base64 o en el formato de texto PEM, el autor de la llamada debe descodificar el contenido antes de llamar a este método.