ECDiffieHellman.DeriveKeyFromHmac 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.
Executa a derivação de chave usando um algoritmo HMAC (Código de Autenticação de Mensagem baseado em Hash) especificado.
Sobrecargas
| Nome | Description |
|---|---|
| DeriveKeyFromHmac(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[]) |
Executa a derivação de chave usando um algoritmo HMAC (Código de Autenticação de Mensagem baseado em Hash) especificado. |
| DeriveKeyFromHmac(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[], Byte[], Byte[]) |
Quando implementado em uma classe derivada, executa a derivação de chave usando um algoritmo HMAC (Código de Autenticação de Mensagem baseado em Hash) especificado com dados opcionais pré-anexados ou acrescentados. |
DeriveKeyFromHmac(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[])
Executa a derivação de chave usando um algoritmo HMAC (Código de Autenticação de Mensagem baseado em Hash) especificado.
public:
cli::array <System::Byte> ^ DeriveKeyFromHmac(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ hmacKey);public byte[] DeriveKeyFromHmac(System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] hmacKey);member this.DeriveKeyFromHmac : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] -> byte[]Public Function DeriveKeyFromHmac (otherPartyPublicKey As ECDiffieHellmanPublicKey, hashAlgorithm As HashAlgorithmName, hmacKey As Byte()) As Byte()Parâmetros
- otherPartyPublicKey
- ECDiffieHellmanPublicKey
A chave pública da outra parte.
- hashAlgorithm
- HashAlgorithmName
O algoritmo de hash a ser usado para derivar o material da chave.
- hmacKey
- Byte[]
A chave para o HMAC.
Retornos
O HMAC do segredo compartilhado.
Exceções
A curva usada tem otherPartyPublicKey um tamanho diferente da curva dessa chave.
-ou-
O hashAlgorithm parâmetro não especifica um hash.
otherPartyPublicKey é null.
A curva usada é otherPartyPublicKey diferente da curva dessa chave.
-ou-
Essa instância representa apenas uma chave pública.
Comentários
Essa sobrecarga chama o DeriveKeyFromHmac método que passa null como os valores de prefixo e acréscimo.
Aplica-se a
DeriveKeyFromHmac(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[], Byte[], Byte[])
Quando implementado em uma classe derivada, executa a derivação de chave usando um algoritmo HMAC (Código de Autenticação de Mensagem baseado em Hash) especificado com dados opcionais pré-anexados ou acrescentados.
public:
virtual cli::array <System::Byte> ^ DeriveKeyFromHmac(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ hmacKey, cli::array <System::Byte> ^ secretPrepend, cli::array <System::Byte> ^ secretAppend);public virtual byte[] DeriveKeyFromHmac(System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] hmacKey, byte[] secretPrepend, byte[] secretAppend);abstract member DeriveKeyFromHmac : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] * byte[] -> byte[]
override this.DeriveKeyFromHmac : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] * byte[] -> byte[]Public Overridable Function DeriveKeyFromHmac (otherPartyPublicKey As ECDiffieHellmanPublicKey, hashAlgorithm As HashAlgorithmName, hmacKey As Byte(), secretPrepend As Byte(), secretAppend As Byte()) As Byte()Parâmetros
- otherPartyPublicKey
- ECDiffieHellmanPublicKey
A chave pública da outra parte.
- hashAlgorithm
- HashAlgorithmName
O algoritmo de hash a ser usado para derivar o material da chave.
- hmacKey
- Byte[]
A chave para o HMAC.
- secretPrepend
- Byte[]
Um valor a ser anexado ao segredo derivado antes do hash.
- secretAppend
- Byte[]
Um valor a ser acrescentado ao segredo derivado antes do hash.
Retornos
O HMAC do segredo compartilhado depois de anexar ou acrescentar dados conforme solicitado.
Exceções
Uma classe derivada deve substituir esse método.
A curva usada tem otherPartyPublicKey um tamanho diferente da curva dessa chave.
-ou-
O hashAlgorithm parâmetro não especifica um hash.
otherPartyPublicKey é null.
A curva usada é otherPartyPublicKey diferente da curva dessa chave.
-ou-
Essa instância representa apenas uma chave pública.
Comentários
Esse método executa internamente a curva elíptica Diffie-Hellman contrato de chave para produzir o segredo compartilhado (z).
Quando hmacKey é null, o valor retornado desse método é o resultado do uso do HMAC-HASH(z, secretPrepend || z || secretAppend) algoritmo HMAC especificado, em || que significa concatenação. Caso contrário, o valor retornado desse método é o resultado de HMAC-HASH(hmacKey, secretPrepend || z || secretAppend).
Se o valor de secretPrepend ou secretAppend for null, eles serão tratados como matrizes vazias.