HMAC.Create 方法

定义

命名空间:

System.Security.Cryptography

程序集:

netstandard.dll, System.Security.Cryptography.dll

创建基于哈希的消息验证代码 (HMAC) 实现的实例。

重载

Create()	已过时. 创建基于哈希的消息验证代码 (HMAC) 默认实现的实例。
Create(String)	已过时. 创建基于哈希的消息验证代码 (HMAC) 指定实现的实例。

Create()

Source:

HMAC.cs

注意

The default implementation of this cryptography algorithm is not supported.

创建基于哈希的消息验证代码 (HMAC) 默认实现的实例。

C#

[System.Obsolete("The default implementation of this cryptography algorithm is not supported.", DiagnosticId="SYSLIB0007", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Security.Cryptography.HMAC Create();

返回

HMAC

新的 SHA-1 实例，除非已使用 <cryptoClass> 元素更改默认设置。

属性

ObsoleteAttribute

例外

PlatformNotSupportedException

.NET Core 2.0 - 3.1 和 .NET 5 及更高版本：在所有情况下。

注解

此方法在 .NET 5 及更高版本中已过时。

默认情况下，此重载使用 HMAC 的 SHA-1 实现。 如果要指定其他实现，请使用 Create(String) 重载，它允许指定算法名称。

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

Create(String)

Source:

HMAC.cs

注意

Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.

创建基于哈希的消息验证代码 (HMAC) 指定实现的实例。

C#

[System.Obsolete("Cryptographic factory methods accepting an algorithm name are obsolete. Use the parameterless Create factory method on the algorithm type instead.", DiagnosticId="SYSLIB0045", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Security.Cryptography.HMAC? Create(string algorithmName);

参数

algorithmName

String

要使用的 HMAC 实现。 下表显示 algorithmName 参数的有效值以及它们映射到的算法。

参数值	实现为其类型参数
System.Security.Cryptography.HMAC	HMACSHA1
System.Security.Cryptography.KeyedHashAlgorithm	HMACSHA1
HMACMD5	HMACMD5
System.Security.Cryptography.HMACMD5	HMACMD5
HMACRIPEMD160	HMACRIPEMD160
System.Security.Cryptography.HMACRIPEMD160	HMACRIPEMD160
HMACSHA1	HMACSHA1
System.Security.Cryptography.HMACSHA1	HMACSHA1
HMACSHA256	HMACSHA256
System.Security.Cryptography.HMACSHA256	HMACSHA256
HMACSHA384	HMACSHA384
System.Security.Cryptography.HMACSHA384	HMACSHA384
HMACSHA512	HMACSHA512
System.Security.Cryptography.HMACSHA512	HMACSHA512
MACTripleDES	MACTripleDES
System.Security.Cryptography.MACTripleDES	MACTripleDES

返回

HMAC

指定的 HMAC 实现的新实例。

属性

ObsoleteAttribute

注解

HMAC 支持许多哈希算法，包括 MD5、SHA-1、SHA-256 和 RIPEMD160。 有关完整列表，请参阅 参数支持的值 algorithmName 。

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