ECDiffieHellman.DeriveKeyFromHash Метод

Определение

Пространство имен:

System.Security.Cryptography

Сборка:

System.Security.Cryptography.dll

Выполняет формирование ключа с использованием указанного хэш-алгоритма.

Перегрузки

DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName)	Выполняет формирование ключа с использованием указанного хэш-алгоритма.
DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[], Byte[])	При реализации в производном классе выполняет формирование ключа с использованием указанного хэш-алгоритма с дополнительными данными, добавленными в начале или конце.

DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName)

Исходный код:

ECDiffieHellman.cs

Выполняет формирование ключа с использованием указанного хэш-алгоритма.

public:
 cli::array <System::Byte> ^ DeriveKeyFromHash(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey, System::Security::Cryptography::HashAlgorithmName hashAlgorithm);

public byte[] DeriveKeyFromHash (System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm);

member this.DeriveKeyFromHash : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName -> byte[]

Public Function DeriveKeyFromHash (otherPartyPublicKey As ECDiffieHellmanPublicKey, hashAlgorithm As HashAlgorithmName) As Byte()

Параметры

otherPartyPublicKey

ECDiffieHellmanPublicKey

Открытый ключ другой стороны.

hashAlgorithm

HashAlgorithmName

Хэш-алгоритм, используемый для получения материала ключа.

Возвращаемое значение

Byte[]

Хэш общего секрета.

Исключения

ArgumentException

Размер кривой, используемой параметром otherPartyPublicKey, отличается от размера кривой из этого ключа.

-или-

В параметре hashAlgorithm не указан хэш.

ArgumentNullException

otherPartyPublicKey имеет значение null.

CryptographicException

Кривая, используемая параметром otherPartyPublicKey, отличается от кривой из этого ключа.

-или-

Этот экземпляр представляет только открытый ключ.

Комментарии

Эта перегрузка вызывает метод, DeriveKeyFromHash передающий null в качестве значений prepend и append.

DeriveKeyFromHash(ECDiffieHellmanPublicKey, HashAlgorithmName, Byte[], Byte[])

Исходный код:

ECDiffieHellman.cs

При реализации в производном классе выполняет формирование ключа с использованием указанного хэш-алгоритма с дополнительными данными, добавленными в начале или конце.

public:
 virtual cli::array <System::Byte> ^ DeriveKeyFromHash(System::Security::Cryptography::ECDiffieHellmanPublicKey ^ otherPartyPublicKey, System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ secretPrepend, cli::array <System::Byte> ^ secretAppend);

public virtual byte[] DeriveKeyFromHash (System.Security.Cryptography.ECDiffieHellmanPublicKey otherPartyPublicKey, System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[]? secretPrepend, byte[]? secretAppend);

abstract member DeriveKeyFromHash : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] -> byte[]
override this.DeriveKeyFromHash : System.Security.Cryptography.ECDiffieHellmanPublicKey * System.Security.Cryptography.HashAlgorithmName * byte[] * byte[] -> byte[]

Public Overridable Function DeriveKeyFromHash (otherPartyPublicKey As ECDiffieHellmanPublicKey, hashAlgorithm As HashAlgorithmName, secretPrepend As Byte(), secretAppend As Byte()) As Byte()

Параметры

otherPartyPublicKey

ECDiffieHellmanPublicKey

Открытый ключ другой стороны.

hashAlgorithm

HashAlgorithmName

Хэш-алгоритм, используемый для получения материала ключа.

secretPrepend

Byte[]

Значение, добавляемое к производному секрету (в начало) перед хэшированием.

secretAppend

Byte[]

Значение, добавляемое к производному секрету перед хэшированием.

Возвращаемое значение

Byte[]

Хэш общего секрета после добавления данных по запросу в начале или конце.

Исключения

NotImplementedException

Производный класс должен переопределять этот метод.

ArgumentException

Размер кривой, используемой параметром otherPartyPublicKey, отличается от размера кривой из этого ключа.

-или-

В параметре hashAlgorithm не указан хэш.

ArgumentNullException

otherPartyPublicKey имеет значение null.

CryptographicException

Кривая, используемая параметром otherPartyPublicKey, отличается от кривой из этого ключа.

-или-

Этот экземпляр представляет только открытый ключ.

Комментарии

Этот метод внутренне выполняет соглашение ключа Diffie-Hellman эллиптической кривой для создания общего секрета (z). Возвращаемое из этого метода значение является результатом использования указанного HASH(secretPrepend || z || secretAppend) хэш-алгоритма, где || обозначает объединение.

Если значение secretPrepend или secretAppend равно null, они обрабатываются как пустые массивы.