IncrementalHash.CreateHMAC Methode

Referenz

Definition

Namespace:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.Algorithms.dll

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

CreateHMAC(HashAlgorithmName, Byte[])	Erstellt IncrementalHash für den Algorithmus des hashbasierten Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code) mithilfe des angegebenen Hashalgorithmus und Schlüssels.
CreateHMAC(HashAlgorithmName, ReadOnlySpan<Byte>)	Es wird ein IncrementalHash für den Algorithmus des hashbasierten Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code) mithilfe des durch `hashAlgorithm` angegebenen Hashalgorithmus und eines durch `key` angegebenen Schlüssels erstellt.

CreateHMAC(HashAlgorithmName, Byte[])

Erstellt IncrementalHash für den Algorithmus des hashbasierten Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code) mithilfe des angegebenen Hashalgorithmus und Schlüssels.

public:
 static System::Security::Cryptography::IncrementalHash ^ CreateHMAC(System::Security::Cryptography::HashAlgorithmName hashAlgorithm, cli::array <System::Byte> ^ key);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] key);

public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, byte[] key);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * byte[] -> System.Security.Cryptography.IncrementalHash

static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * byte[] -> System.Security.Cryptography.IncrementalHash

Public Shared Function CreateHMAC (hashAlgorithm As HashAlgorithmName, key As Byte()) As IncrementalHash

Parameter

hashAlgorithm: HashAlgorithmName

Der Name des Hashalgorithmus, der im HMAC ausgeführt werden soll.

key: Byte[]

Der geheime Schlüssel für den HMAC. Der Schlüssel kann von beliebiger Länge sein, doch ein Schlüssel, der länger als die Ausgabegröße des angegebenen Hashalgorithmus ist, wird mit eindeutigem Hashwert berechnet, um den Schlüssel mit richtiger Größe abzuleiten. Daher ist die empfohlene Größe des geheimen Schlüssels die Ausgabegröße des angegebenen Hashalgorithmus.

Gibt zurück

IncrementalHash

Eine Instanz der IncrementalHash-Klasse, die den angegebenen Hashalgorithmus berechnen kann.

Attribute: UnsupportedOSPlatformAttribute

Ausnahmen

ArgumentNullException

key ist null.

ArgumentException

hashAlgorithm.Name ist null oder eine leere Zeichenfolge.

CryptographicException

hashAlgorithm ist kein bekannter Hashalgorithmus.

Gilt für

CreateHMAC(HashAlgorithmName, ReadOnlySpan<Byte>)

Es wird ein IncrementalHash für den Algorithmus des hashbasierten Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code) mithilfe des durch hashAlgorithm angegebenen Hashalgorithmus und eines durch key angegebenen Schlüssels erstellt.

public:
 static System::Security::Cryptography::IncrementalHash ^ CreateHMAC(System::Security::Cryptography::HashAlgorithmName hashAlgorithm, ReadOnlySpan<System::Byte> key);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> key);

public static System.Security.Cryptography.IncrementalHash CreateHMAC (System.Security.Cryptography.HashAlgorithmName hashAlgorithm, ReadOnlySpan<byte> key);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> -> System.Security.Cryptography.IncrementalHash

static member CreateHMAC : System.Security.Cryptography.HashAlgorithmName * ReadOnlySpan<byte> -> System.Security.Cryptography.IncrementalHash

Public Shared Function CreateHMAC (hashAlgorithm As HashAlgorithmName, key As ReadOnlySpan(Of Byte)) As IncrementalHash

Parameter

hashAlgorithm: HashAlgorithmName

Der Name des Hashalgorithmus, der im HMAC ausgeführt werden soll.

key: ReadOnlySpan<Byte>

Der geheime Schlüssel für den HMAC. Der Schlüssel kann von beliebiger Länge sein, doch ein Schlüssel, der länger als die Ausgabegröße des durch hashAlgorithm angegebenen Hashalgorithmus ist, wird (unter Verwendung des durch hashAlgorithm angegebenen Algorithmus) mit eindeutigem Hashwert berechnet, um einen Schlüssel mit richtiger Größe abzuleiten. Daher ist die empfohlene Größe des geheimen Schlüssels die Ausgabegröße des von hashAlgorithm angegebenen Hashwerts.