IncrementalHash.CreateHMAC Метод

Ссылка

Определение

Пространство имен:: System.Security.Cryptography

Сборка:: System.Security.Cryptography.Algorithms.dll

Сборка:: System.Security.Cryptography.dll

Сборка:: System.Core.dll

Сборка:: netstandard.dll

Сборка:: mscorlib.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

CreateHMAC(HashAlgorithmName, Byte[])	Создает IncrementalHash для алгоритма HMAC с помощью указанного алгоритма хэширования и ключа.
CreateHMAC(HashAlgorithmName, ReadOnlySpan<Byte>)	Создает IncrementalHash для алгоритма HMAC (код проверки подлинности сообщений с помощью хэш-функций), используя хэш-алгоритм, заданный в `hashAlgorithm`, и ключ, заданный в `key`.

CreateHMAC(HashAlgorithmName, Byte[])

Создает IncrementalHash для алгоритма HMAC с помощью указанного алгоритма хэширования и ключа.

public:
 static System::Security::Cryptography::IncrementalHash ^ CreateHMAC(System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ key);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] key);

public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] key);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * byte[] -> System.Security.Cryptography.IncrementalHash

static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * byte[] -> System.Security.Cryptography.IncrementalHash

Public Shared Function CreateHMAC (hashAlgorithm As HashAlgorithmName, key As Byte()) As IncrementalHash

Параметры

hashAlgorithm: HashAlgorithmName

Имя алгоритма хэширования для выполнения в HMAC.

key: Byte[]

Секретный ключ для HMAC. Ключ может иметь любую длину, но ключ, длина которого превышает выходной размер указанного алгоритма хэширования, будет хэшироваться для получения правильного размера. Таким образом, рекомендуемым размером секретного ключа является выходной размер указанного алгоритма хэширования.

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

IncrementalHash

Экземпляр класса IncrementalHash готов для вычисления указанного алгоритма хэширования.

Атрибуты: UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

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

ArgumentException

hashAlgorithm.Name имеет значение null или является пустой строкой.

CryptographicException

hashAlgorithm — неизвестный алгоритм хэширования.

Применяется к

CreateHMAC(HashAlgorithmName, ReadOnlySpan<Byte>)

Создает IncrementalHash для алгоритма HMAC (код проверки подлинности сообщений с помощью хэш-функций), используя хэш-алгоритм, заданный в hashAlgorithm, и ключ, заданный в key.

public:
 static System::Security::Cryptography::IncrementalHash ^ CreateHMAC(System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<System::Byte> key);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> key);

public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> key);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> -> System.Security.Cryptography.IncrementalHash

static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> -> System.Security.Cryptography.IncrementalHash

Public Shared Function CreateHMAC (hashAlgorithm As HashAlgorithmName, key As ReadOnlySpan(Of Byte)) As IncrementalHash

Параметры

hashAlgorithm: HashAlgorithmName

Имя алгоритма хэширования для выполнения в HMAC.

key: ReadOnlySpan<Byte>

Секретный ключ для HMAC. Ключ может иметь любую длину. При этом ключ, превышающий размер выходных данных хэш-алгоритма, заданного в алгоритме hashAlgorithm, будет хэширован (с использованием алгоритма, заданного hashAlgorithm) для получения ключа правильного размера. Поэтому рекомендуемый размер секретного ключа — это размер выходных данных хэша, указанного в hashAlgorithm.