HMAC.Create Metoda

Definicja

Przestrzeń nazw:

System.Security.Cryptography

Zestaw:

System.Security.Cryptography.dll

Tworzy wystąpienie implementacji opartego na skrótach kodu uwierzytelniania komunikatów (HMAC) .

Przeciążenia

Create()	Przestarzałe. Tworzy wystąpienie domyślnej implementacji kodu uwierzytelniania komunikatów opartego na skrótach (HMAC).
Create(String)	Przestarzałe. Tworzy wystąpienie określonej implementacji opartego na skrótach kodu uwierzytelniania komunikatów (HMAC).

Create()

Źródło:

HMAC.cs

Przestroga

The default implementation of this cryptography algorithm is not supported.

Tworzy wystąpienie domyślnej implementacji kodu uwierzytelniania komunikatów opartego na skrótach (HMAC).

public:
 static System::Security::Cryptography::HMAC ^ Create();

[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 ();

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

Public Shared Function Create () As HMAC

Zwraca

HMAC

Nowe wystąpienie SHA-1, chyba że ustawienia domyślne zostały zmienione przy użyciu <elementu cryptoClass>.

Atrybuty

ObsoleteAttribute

Wyjątki

PlatformNotSupportedException

.NET Core 2.0 — 3.1 i .NET 5 i nowsze: we wszystkich przypadkach.

Uwagi

Ta metoda jest przestarzała na platformie .NET 5 i nowszych wersjach.

Domyślnie to przeciążenie używa implementacji ALGORYTMu SHA-1 komputera HMAC. Jeśli chcesz określić inną implementację, użyj Create(String) przeciążenia, które umożliwia określenie nazwy algorytmu.

Ze względu na problemy z kolizją z algorytmem SHA-1 firma Microsoft zaleca model zabezpieczeń oparty na algorytmie SHA-256 lub lepszym.

Create(String)

Źródło:

HMAC.cs

Przestroga

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

Tworzy wystąpienie określonej implementacji opartego na skrótach kodu uwierzytelniania komunikatów (HMAC).

public:
 static System::Security::Cryptography::HMAC ^ Create(System::String ^ algorithmName);

[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);

[<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}")>]
static member Create : string -> System.Security.Cryptography.HMAC

Public Shared Function Create (algorithmName As String) As HMAC

Parametry

algorithmName

String

Implementacja HMAC do użycia. W poniższej tabeli przedstawiono prawidłowe wartości parametru algorithmName i algorytmy, do których są mapowe.

Wartość parametru	Implementuje
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

Zwraca

HMAC

Nowe wystąpienie określonej implementacji HMAC.

Atrybuty

ObsoleteAttribute

Uwagi

Funkcja HMAC obsługuje wiele algorytmów wyznaczania wartości skrótu, w tym MD5, SHA-1, SHA-256 i RIPEMD160. Aby uzyskać pełną listę, zobacz obsługiwane wartości parametru algorithmName .

Ze względu na problemy z kolizjami z rozwiązaniem MD5 i SHA-1 firma Microsoft zaleca model zabezpieczeń oparty na algorytmie SHA-256 lub lepszym.