AsymmetricAlgorithm.ImportEncryptedPkcs8PrivateKey Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Nome | Description |
|---|---|
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32) |
Quando substituído em uma classe derivada, importa o keypair público/privado de uma estrutura PKCS#8 EncryptedPrivateKeyInfo depois de descriptografar com uma senha baseada em bytes, substituindo as chaves desse objeto. |
| ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32) |
Quando substituído em uma classe derivada, importa o keypair público/privado de uma estrutura PKCS#8 EncryptedPrivateKeyInfo depois de descriptografar com uma senha baseada em char, substituindo as chaves desse objeto. |
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Int32)
Quando substituído em uma classe derivada, importa o keypair público/privado de uma estrutura PKCS#8 EncryptedPrivateKeyInfo depois de descriptografar com uma senha baseada em bytes, substituindo as chaves desse objeto.
public:
virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<System::Byte> passwordBytes, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);public virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<byte> passwordBytes, ReadOnlySpan<byte> source, out int bytesRead);abstract member ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unit
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<byte> * ReadOnlySpan<byte> * int -> unitPublic Overridable Sub ImportEncryptedPkcs8PrivateKey (passwordBytes As ReadOnlySpan(Of Byte), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)Parâmetros
- passwordBytes
- ReadOnlySpan<Byte>
Os bytes a serem usados como senha ao descriptografar o material da chave.
- source
- ReadOnlySpan<Byte>
Os bytes de uma estrutura PKCS#8 EncryptedPrivateKeyInfo na codificação ASN.1-BER.
- bytesRead
- Int32
Quando esse método é retornado, contém um valor que indica o número de bytes lidos de source. Esse parâmetro é tratado como não inicializado.
Exceções
A senha está incorreta.
-ou-
O conteúdo de source indicar que a Função de Derivação de Chave (KDF) a ser aplicada é o PKCS nº 12 KDF herdado, que exige senhas Charbaseadas.
-ou-
O conteúdo de source não representar uma estrutura PKCS#8 EncryptedPrivateKeyInfo codificada em ASN.1-BER.
-ou-
O conteúdo da indicação da source chave é para um algoritmo diferente do algoritmo representado por essa instância.
-ou-
O conteúdo de source representar a chave em um formato sem suporte.
-ou-
Falha na importação de chave específica do algoritmo.
Um tipo derivado não substituiu esse membro.
Comentários
Os bytes de senha são passados diretamente para a Função de Derivação de Chave (KDF) usada pelo algoritmo indicado por pbeParameters.
Isso permite a compatibilidade com outros sistemas que usam uma codificação de texto diferente de UTF-8 ao processar senhas com PBKDF2 (Password-Based Função de Derivação de Chave 2).
Esse método só dá suporte à codificação binária (BER/CER/DER) de EncryptedPrivateKeyInfo. Se o valor for codificado em Base64 ou no formato de texto PEM, o chamador deverá decodificar o conteúdo da Base64 antes de chamar esse método.
Como o suporte específico ao algoritmo é necessário para interpretar o conteúdo desse formato de dados, ImportEncryptedPkcs8PrivateKey lança um NotImplementedException por padrão.
Aplica-se a
ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<Char>, ReadOnlySpan<Byte>, Int32)
Quando substituído em uma classe derivada, importa o keypair público/privado de uma estrutura PKCS#8 EncryptedPrivateKeyInfo depois de descriptografar com uma senha baseada em char, substituindo as chaves desse objeto.
public:
virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<System::Byte> source, [Runtime::InteropServices::Out] int % bytesRead);public virtual void ImportEncryptedPkcs8PrivateKey(ReadOnlySpan<char> password, ReadOnlySpan<byte> source, out int bytesRead);abstract member ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unit
override this.ImportEncryptedPkcs8PrivateKey : ReadOnlySpan<char> * ReadOnlySpan<byte> * int -> unitPublic Overridable Sub ImportEncryptedPkcs8PrivateKey (password As ReadOnlySpan(Of Char), source As ReadOnlySpan(Of Byte), ByRef bytesRead As Integer)Parâmetros
- password
- ReadOnlySpan<Char>
A senha a ser usada para descriptografar o material da chave.
- source
- ReadOnlySpan<Byte>
Os bytes de uma estrutura PKCS#8 EncryptedPrivateKeyInfo na codificação ASN.1-BER.
- bytesRead
- Int32
Quando esse método é retornado, contém um valor que indica o número de bytes lidos de source. Esse parâmetro é tratado como não inicializado.
Exceções
A senha está incorreta.
-ou-
O conteúdo de source não representar uma estrutura PKCS#8 EncryptedPrivateKeyInfo codificada em ASN.1-BER.
-ou-
O conteúdo da indicação da source chave é para um algoritmo diferente do algoritmo representado por essa instância.
-ou-
O conteúdo de source representar a chave em um formato sem suporte.
-ou-
Falha na importação de chave específica do algoritmo.
Um tipo derivado não substituiu esse membro.
Comentários
Quando o conteúdo indica source um algoritmo que usa PBKDF1 (Password-Based Key Derivation Function 1) ou PBKDF2 (Password-Based Key Derivation Function 2), a senha é convertida em bytes por meio da codificação UTF-8.
Esse método só dá suporte à codificação binária (BER/CER/DER) de EncryptedPrivateKeyInfo. Se o valor for codificado em Base64 ou no formato de texto PEM, o chamador deverá decodificar o conteúdo da Base64 antes de chamar esse método.
Como o suporte específico ao algoritmo é necessário para interpretar o conteúdo desse formato de dados, ImportEncryptedPkcs8PrivateKey lança um NotImplementedException por padrão.