HMAC 类

定义

命名空间:: System.Security.Cryptography

程序集:: netstandard.dll, System.Security.Cryptography.dll

程序集:: netstandard.dll, System.Security.Cryptography.Primitives.dll

程序集:: System.Security.Cryptography.Primitives.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

Source:: HMAC.cs

Source:: HMAC.cs

Source:: HMAC.cs

Source:: HMAC.cs

Source:: HMAC.cs

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

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

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

[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HMAC : System.Security.Cryptography.KeyedHashAlgorithm

type HMAC = class
    inherit KeyedHashAlgorithm

[<System.Runtime.InteropServices.ComVisible(true)>]
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

更多…

属性: ComVisibleAttribute

注解

基于哈希的消息身份验证代码（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[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。 (继承自 HashAlgorithm)
ComputeHash(Byte[])	计算指定字节数组的哈希值。 (继承自 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 计算。

显式接口实现

名称	说明
IDisposable.Dispose()	释放由托管资源使用 HashAlgorithm 的非托管资源，并选择性地释放托管资源。 (继承自 HashAlgorithm)

适用于

另请参阅

加密服务

反馈

此页面是否有帮助？