ECDiffieHellmanCng.DeriveKeyMaterial Método

Definição

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.Cng.dll

Assembly:

System.Security.Cryptography.dll

Assembly:

System.Core.dll

Deriva o material da chave que é gerado com base no acordo secreto entre duas partes.

Sobrecargas

DeriveKeyMaterial(CngKey)	Deriva o material da chave que é gerado com base no acordo secreto entre duas partes, dado um objeto CngKey que contém a chave pública do segundo participante.
DeriveKeyMaterial(ECDiffieHellmanPublicKey)	Deriva o material da chave que é gerado com base no acordo secreto entre duas partes, dado um objeto ECDiffieHellmanPublicKey que contém a chave pública do segundo participante.

Comentários

O algoritmo ECDH (ECDH) da Diffie-Hellman Curva Elíptica aceita a chave privada e a chave pública da outra parte como entrada e produz o acordo secreto como saída. A função de derivação chave (KDF) usa o contrato secreto e produz o material de chave como saída.

DeriveKeyMaterial(CngKey)

Deriva o material da chave que é gerado com base no acordo secreto entre duas partes, dado um objeto CngKey que contém a chave pública do segundo participante.

public:
 cli::array <System::Byte> ^ DeriveKeyMaterial(System::Security::Cryptography::CngKey ^ otherPartyPublicKey);

public byte[] DeriveKeyMaterial (System.Security.Cryptography.CngKey otherPartyPublicKey);

[System.Security.SecurityCritical]
public byte[] DeriveKeyMaterial (System.Security.Cryptography.CngKey otherPartyPublicKey);

override this.DeriveKeyMaterial : System.Security.Cryptography.CngKey -> byte[]

[<System.Security.SecurityCritical>]
override this.DeriveKeyMaterial : System.Security.Cryptography.CngKey -> byte[]

Public Function DeriveKeyMaterial (otherPartyPublicKey As CngKey) As Byte()

Parâmetros

otherPartyPublicKey

CngKey

Um objeto que contém a parte pública da chave ECDH (Diffie-Hellman de curva elíptica) da outra parte na troca de chaves.

Retornos

Byte[]

Uma matriz de bytes que contém o material da chave. Essa informação é gerada do contrato secreto que é calculado usando a chave privada do objeto atual e a chave pública especificada.

Atributos

SecurityCriticalAttribute

Exceções

ArgumentNullException

otherPartyPublicKey é null.

ArgumentException

otherPartyPublicKey é inválido. A propriedade AlgorithmGroup não especifica ECDiffieHellman ou o tamanho da chave não corresponde ao tamanho da chave desta instância.

InvalidOperationException

Esta propriedade KeyDerivationFunction do objeto especifica a função de derivação de chaves Tls, mas Label ou Seed é null.

CryptographicException

Todos os outros erros.

DeriveKeyMaterial(ECDiffieHellmanPublicKey)

Deriva o material da chave que é gerado com base no acordo secreto entre duas partes, dado um objeto ECDiffieHellmanPublicKey que contém a chave pública do segundo participante.

public:
 override cli::array <System::Byte> ^ DeriveKeyMaterial(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey);

public override byte[] DeriveKeyMaterial (System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey);

override this.DeriveKeyMaterial : System.Security.Cryptography.ECDiffieHellmanPublicKey -> byte[]

Public Overrides Function DeriveKeyMaterial (otherPartyPublicKey As ECDiffieHellmanPublicKey) As Byte()

Parâmetros

otherPartyPublicKey

ECDiffieHellmanPublicKey

A chave pública da outra parte na troca de chaves.

Retornos

Byte[]

Uma matriz de bytes que contém o material da chave. Essa informação é gerada do contrato secreto que é calculado usando a chave privada do objeto atual e a chave pública especificada.

Exceções

ArgumentNullException

otherPartyPublicKey é null.

ArgumentException

otherPartyPublicKey não é uma chave ECDiffieHellmanCngPublicKey.