HMAC Класс

Определение

Абстрактный класс, от которого должны наследоваться все реализации хэш-кода проверки подлинности сообщения (HMAC).Represents the abstract class from which all implementations of Hash-based Message Authentication Code (HMAC) must derive.

public ref class HMAC abstract : System::Security::Cryptography::KeyedHashAlgorithm
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HMAC : System.Security.Cryptography.KeyedHashAlgorithm
type HMAC = class
    inherit KeyedHashAlgorithm
Public MustInherit Class HMAC
Inherits KeyedHashAlgorithm
Наследование
Производный
Атрибуты

Комментарии

Хэш-код проверки подлинности сообщения (HMAC) можно использовать для определения того, было ли сообщение, переданное по незащищенному каналу, было изменено при условии, что отправитель и получатель совместно используют секретный ключ.A Hash-based Message Authentication Code (HMAC) can be used to determine whether a message sent over an insecure channel has been tampered with, provided that the sender and receiver share a secret key. Отправитель рассчитывает хэш-значение для исходных данных и отправляет исходные данные и HMAC как одно сообщение.The sender computes the hash value for the original data and sends both the original data and the HMAC as a single message. Получатель повторно выполняет вычисление хэш-значения в полученном сообщении и проверяет, соответствует ли вычисленное значение хэша переданному значению хэша.The receiver recomputes the hash value on the received message and checks that the computed hash value matches the transmitted hash value.

HMAC можно использовать с любой итеративной криптографической хэш-функцией, такой как MD5 или SHA-1, в сочетании с секретным общим ключом.HMAC can be used with any iterative cryptographic hash function, such as MD5 or SHA-1, in combination with a secret shared key. Стойкость криптографического кода HMAC зависит от свойств базовой хэш-функции.The cryptographic strength of HMAC depends on the properties of the underlying hash function.

Любое изменение данных или хэш-значения приводит к несовпадению, так как знание секретного ключа требуется для изменения сообщения и воспроизведения правильного хэш-значения.Any change to the data or the hash value results in a mismatch, because knowledge of the secret key is required to change the message and reproduce the correct hash value. Таким образом, если исходные и вычисленные хэш-значения совпадают, сообщение проходит проверку подлинности.Therefore, if the original and computed hash values match, the message is authenticated.

Из-за проблем с MD5 и SHA-1 Корпорация Майкрософт рекомендует использовать модель безопасности на основе SHA-256 или более высокого уровня.Due to collision problems with MD5 and SHA-1, Microsoft recommends a security model based on SHA-256 or better.

Конструкторы

HMAC()

Инициализирует новый экземпляр класса HMAC.Initializes a new instance of the HMAC class.

Поля

HashSizeValue

Представляет размер вычисленного хэш-кода в битах.Represents the size, in bits, of the computed hash code.

(Унаследовано от HashAlgorithm)
HashValue

Представляет значение вычисляемого хэш-кода.Represents the value of the computed hash code.

(Унаследовано от HashAlgorithm)
KeyValue

Ключ, используемый в хэш-алгоритме.The key to use in the hash algorithm.

(Унаследовано от KeyedHashAlgorithm)
State

Представляет состояние процесса вычисления хэша.Represents the state of the hash computation.

(Унаследовано от HashAlgorithm)

Свойства

BlockSizeValue

Получает или задает размер блока, используемый в значении хэша.Gets or sets the block size to use in the hash value.

CanReuseTransform

Возвращает значение, указывающее, возможно ли повторное использование текущего преобразования.Gets a value indicating whether the current transform can be reused.

(Унаследовано от HashAlgorithm)
CanTransformMultipleBlocks

Если переопределено в производном классе, возвращает значение, указывающее, возможно ли преобразование нескольких блоков.When overridden in a derived class, gets a value indicating whether multiple blocks can be transformed.

(Унаследовано от HashAlgorithm)
Hash

Получает значение вычисленного хэш-кода.Gets the value of the computed hash code.

(Унаследовано от HashAlgorithm)
HashName

Получает или задает имя используемого хэш-алгоритма.Gets or sets the name of the hash algorithm to use for hashing.

HashSize

Получает размер вычисленного хэш-кода в битах.Gets the size, in bits, of the computed hash code.

(Унаследовано от HashAlgorithm)
InputBlockSize

При переопределении в производном классе получает размер входного блока.When overridden in a derived class, gets the input block size.

(Унаследовано от HashAlgorithm)
Key

Получает или задает ключ, используемый в хэш-алгоритме.Gets or sets the key to use in the hash algorithm.

OutputBlockSize

При переопределении в производном классе получает размер выходного блока.When overridden in a derived class, gets the output block size.

(Унаследовано от HashAlgorithm)

Методы

Clear()

Освобождает все ресурсы, используемые классом HashAlgorithm.Releases all resources used by the HashAlgorithm class.

(Унаследовано от HashAlgorithm)
ComputeHash(Byte[])

Вычисляет хэш-значение для заданного массива байтов.Computes the hash value for the specified byte array.

(Унаследовано от HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)

Вычисляет хэш-значение для заданной области заданного массива байтов.Computes the hash value for the specified region of the specified byte array.

(Унаследовано от HashAlgorithm)
ComputeHash(Stream)

Вычисляет хэш-значение для заданного объекта Stream.Computes the hash value for the specified Stream object.

(Унаследовано от HashAlgorithm)
Create()

Создает экземпляр реализации хэш-кода проверки подлинности сообщения (HMAC) по умолчанию.Creates an instance of the default implementation of a Hash-based Message Authentication Code (HMAC).

Create(String)

Создает экземпляр заданной реализации хэш-кода проверки подлинности сообщения (HMAC).Creates an instance of the specified implementation of a Hash-based Message Authentication Code (HMAC).

Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса HashAlgorithm.Releases all resources used by the current instance of the HashAlgorithm class.

(Унаследовано от HashAlgorithm)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом HMAC, и, если допускается изменение ключа, при необходимости также освобождает управляемые ресурсы.Releases the unmanaged resources used by the HMAC class when a key change is legitimate and optionally releases the managed resources.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HashCore(Byte[], Int32, Int32)

При переопределении в производном классе передает данные, записанные в объект, на вход хэш-алгоритма HMAC по умолчанию для вычисления значения хэша.When overridden in a derived class, routes data written to the object into the default HMAC hash algorithm for computing the hash value.

HashCore(ReadOnlySpan<Byte>)
HashFinal()

Если переопределено в производном классе, завершает вычисление хэша после обработки последних данных криптографическим потоковым объектом.When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.

Initialize()

Инициализирует новый экземпляр реализации по умолчанию класса HMAC.Initializes an instance of the default implementation of HMAC.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)

Вычисляет хэш-значение для заданной области входного массива байтов и копирует указанную область входного массива байтов в заданную область выходного массива байтов.Computes the hash value for the specified region of the input byte array and copies the specified region of the input byte array to the specified region of the output byte array.

(Унаследовано от HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)

Вычисляет хэш-значение для заданной области заданного массива байтов.Computes the hash value for the specified region of the specified byte array.

(Унаследовано от HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32) (Унаследовано от HashAlgorithm)
TryHashFinal(Span<Byte>, Int32)

Явные реализации интерфейса

IDisposable.Dispose()

Освобождает неуправляемые ресурсы, используемые объектом HashAlgorithm, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the HashAlgorithm and optionally releases the managed resources.

(Унаследовано от HashAlgorithm)

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

Дополнительно