HMACSHA1 类

定义

命名空间:

System.Security.Cryptography

程序集:

System.Security.Cryptography.dll

Source:

HMACSHA1.cs

使用 SHA1 哈希函数计算基于哈希值的消息验证代码 (HMAC)。

public ref class HMACSHA1 : System::Security::Cryptography::HMAC

public class HMACSHA1 : System.Security.Cryptography.HMAC

type HMACSHA1 = class
    inherit HMAC

Public Class HMACSHA1
Inherits HMAC

继承

Object

HashAlgorithm

KeyedHashAlgorithm

HMAC

HMACSHA1

注解

HMACSHA1 是一种键控哈希算法，它由 SHA1 哈希函数构造，用作 HMAC 或基于哈希的消息身份验证代码。 HMAC 进程将密钥与消息数据混合，使用哈希函数对结果进行哈希处理，再次将哈希值与机密密钥混合，然后第二次应用哈希函数。 输出哈希的长度为 160 位。

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

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

SHA-1 (安全哈希算法，也称为 SHS，安全哈希标准) 是美国政府发布的加密哈希算法。 它从任意长度字符串生成 160 位哈希值。

HMACSHA1 接受任何大小的密钥，并生成长度为 160 位的哈希序列。

由于与 SHA1 冲突，Microsoft 建议使用 SHA256。

构造函数

HMACSHA1()	使用随机生成的密钥初始化 HMACSHA1 类的新实例。
HMACSHA1(Byte[])	使用指定的密钥数据初始化 HMACSHA1 类的新实例。
HMACSHA1(Byte[], Boolean)	已过时. 使用指定的密钥数据和一个指定是否使用 SHA1 算法托管版本的值，来初始化 HMACSHA1 类的新实例。

字段

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

属性

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

方法

Clear()	释放 HashAlgorithm 类使用的所有资源。 (继承自 HashAlgorithm)
ComputeHash(Byte[])	计算指定字节数组的哈希值。 (继承自 HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。 (继承自 HashAlgorithm)
ComputeHash(Stream)	计算指定 Stream 对象的哈希值。 (继承自 HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	异步计算指定 Stream 对象的哈希值。 (继承自 HashAlgorithm)
Dispose()	释放 HashAlgorithm 类的当前实例所使用的所有资源。 (继承自 HashAlgorithm)
Dispose(Boolean)	此成员替代 Dispose(Boolean) 且该主题可能包括更完整的文档。 释放由 KeyedHashAlgorithm 占用的非托管资源，还可以另外再释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
HashCore(Byte[], Int32, Int32)	将写入对象的数据路由到 SHA1 哈希算法以计算基于哈希的消息验证代码 (HMAC)。
HashCore(ReadOnlySpan<Byte>)	将写入对象的数据路由到 HMAC 算法以计算 HMAC 。
HashData(Byte[], Byte[])	使用 SHA1 算法计算数据的 HMAC。
HashData(Byte[], Stream)	使用 SHA1 算法计算流的 HMAC。
HashData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>)	使用 SHA1 算法计算数据的 HMAC。
HashData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>)	使用 SHA1 算法计算数据的 HMAC。
HashData(ReadOnlySpan<Byte>, Stream)	使用 SHA1 算法计算流的 HMAC。
HashData(ReadOnlySpan<Byte>, Stream, Span<Byte>)	使用 SHA1 算法计算流的 HMAC。
HashDataAsync(Byte[], Stream, CancellationToken)	使用 SHA1 算法异步计算流的 HMAC。
HashDataAsync(ReadOnlyMemory<Byte>, Stream, CancellationToken)	使用 SHA1 算法异步计算流的 HMAC。
HashDataAsync(ReadOnlyMemory<Byte>, Stream, Memory<Byte>, CancellationToken)	使用 SHA1 算法异步计算流的 HMAC。
HashFinal()	在算法处理最后一个数据后，结束 HMAC 计算。
Initialize()	将哈希算法重置为其初始状态。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	计算输入字节数组指定区域的哈希值，并将输入字节数组指定区域复制到输出字节数组的指定区域。 (继承自 HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)	计算指定字节数组的指定区域的哈希值。 (继承自 HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	尝试计算指定字节数组的哈希值。 (继承自 HashAlgorithm)
TryHashData(ReadOnlySpan<Byte>, ReadOnlySpan<Byte>, Span<Byte>, Int32)	尝试使用 SHA1 算法计算数据的 HMAC。
TryHashFinal(Span<Byte>, Int32)	在 HMAC 算法处理最后一个数据后，尝试结束 HMAC 计算。

另请参阅

• 加密服务