HMAC 类

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

Source:

HMAC.cs

表示基于哈希的消息验证代码 (HMAC) 的所有实现必须从中派生的抽象类。

public ref class HMAC abstract : System::Security::Cryptography::KeyedHashAlgorithm

public abstract class HMAC : System.Security.Cryptography.KeyedHashAlgorithm

type HMAC = class
    inherit KeyedHashAlgorithm

Public MustInherit Class HMAC
Inherits KeyedHashAlgorithm

继承

Object

HashAlgorithm

KeyedHashAlgorithm

HMAC

派生

System.Security.Cryptography.HMACMD5

System.Security.Cryptography.HMACRIPEMD160

System.Security.Cryptography.HMACSHA1

System.Security.Cryptography.HMACSHA256

System.Security.Cryptography.HMACSHA3_256

System.Security.Cryptography.HMACSHA3_384

System.Security.Cryptography.HMACSHA3_512

System.Security.Cryptography.HMACSHA384

System.Security.Cryptography.HMACSHA512

注解

基于哈希的消息身份验证代码 (HMAC) 可用于确定通过不安全通道发送的消息是否已被篡改，前提是发送方和接收方共享密钥。 发送方计算原始数据的哈希值，并将原始数据和 HMAC 作为单个消息发送。 接收方重新计算收到的消息上的哈希值，并检查计算的哈希值是否与传输的哈希值匹配。

HMAC 可与任何迭代加密哈希函数（如 MD5 或 SHA-1）结合使用，并结合机密共享密钥。 HMAC 的加密强度取决于基础哈希函数的属性。

对数据或哈希值的任何更改都会导致不匹配，因为需要知道密钥才能更改消息并重现正确的哈希值。 因此，如果原始哈希值和计算的哈希值匹配，则会对消息进行身份验证。

由于 MD5 和 SHA-1 的冲突问题，Microsoft 建议使用基于 SHA-256 或更高版本的安全模型。

构造函数

HMAC()

初始化 HMAC 类的新实例。

字段

HashSizeValue	表示计算所得的哈希代码的大小（以位为单位）。 (继承自 HashAlgorithm)
HashValue	表示计算所得的哈希代码的值。 (继承自 HashAlgorithm)
KeyValue	用于哈希算法的密钥。 (继承自 KeyedHashAlgorithm)
State	表示哈希计算的状态。 (继承自 HashAlgorithm)

属性

BlockSizeValue	获取或设置哈希值中使用的块大小。
CanReuseTransform	获取一个值，该值指示是否可重复使用当前转换。 (继承自 HashAlgorithm)
CanTransformMultipleBlocks	当在派生类中重写时，获取一个值，该值指示是否可以转换多个块。 (继承自 HashAlgorithm)
Hash	获取计算所得的哈希代码的值。 (继承自 HashAlgorithm)
HashName	获取或设置用于哈希计算的哈希算法的名称。
HashSize	获取计算所得的哈希代码的大小（以位为单位）。 (继承自 HashAlgorithm)
InputBlockSize	当在派生类中重写时，获取输入块的大小。 (继承自 HashAlgorithm)
Key	获取或设置要在 HMAC 计算中使用的密钥。
OutputBlockSize	当在派生类中重写时，获取输出块的大小。 (继承自 HashAlgorithm)

方法

Clear()	释放 HashAlgorithm 类使用的所有资源。 (继承自 HashAlgorithm)
ComputeHash(Byte[])	计算指定字节数组的哈希值。 (继承自 HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。 (继承自 HashAlgorithm)
ComputeHash(Stream)	计算指定 Stream 对象的哈希值。 (继承自 HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	异步计算指定 Stream 对象的哈希值。 (继承自 HashAlgorithm)
Create()	已过时. 创建基于哈希的消息验证代码 (HMAC) 默认实现的实例。
Create(String)	已过时. 创建基于哈希的消息验证代码 (HMAC) 指定实现的实例。
Dispose()	释放 HashAlgorithm 类的当前实例所使用的所有资源。 (继承自 HashAlgorithm)
Dispose(Boolean)	密钥更改合法时释放由 HMAC 类使用的非托管资源，并可选择释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
HashCore(Byte[], Int32, Int32)	在派生类中重写时，将写入对象的数据路由到 HMAC 算法以计算 HMAC 值。
HashCore(ReadOnlySpan<Byte>)	将写入对象的数据路由到 HMAC 算法以计算 HMAC 。
HashFinal()	在派生类中重写时，在算法处理最后一个数据后结束 HMAC 计算。
Initialize()	初始化默认 HMAC 实现的实例。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	计算输入字节数组指定区域的哈希值，并将输入字节数组指定区域复制到输出字节数组的指定区域。 (继承自 HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。 (继承自 HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	尝试计算指定字节数组的哈希值。 (继承自 HashAlgorithm)
TryHashFinal(Span<Byte>, Int32)	在 HMAC 算法处理最后一个数据后，尝试结束 HMAC 计算。

另请参阅

• 加密服务