HMAC Klasse

Definition

Namespace:

System.Security.Cryptography

Assembly:

System.Security.Cryptography.dll

Quelle:

HMAC.cs

Stellt die abstrakte Klasse dar, von der alle Implementierungen von Hash-Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code) abgeleitet werden müssen.

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

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

type HMAC = class
    inherit KeyedHashAlgorithm

Public MustInherit Class HMAC
Inherits KeyedHashAlgorithm

Vererbung

Object

HashAlgorithm

KeyedHashAlgorithm

HMAC

Abgeleitet

System.Security.Cryptography.HMACMD5

System.Security.Cryptography.HMACRIPEMD160

System.Security.Cryptography.HMACSHA1

System.Security.Cryptography.HMACSHA256

System.Security.Cryptography.HMACSHA3_256

System.Security.Cryptography.HMACSHA3_384

System.Security.Cryptography.HMACSHA3_512

System.Security.Cryptography.HMACSHA384

System.Security.Cryptography.HMACSHA512

Hinweise

Ein Hashbasierter Nachrichtenauthentifizierungscode (Hash-based Message Authentication Code, HMAC) kann verwendet werden, um zu bestimmen, ob eine über einen unsicheren Kanal gesendete Nachricht manipuliert wurde, vorausgesetzt, der Absender und Empfänger teilen einen geheimen Schlüssel. Der Absender berechnet den Hashwert für die ursprünglichen Daten und sendet sowohl die Originaldaten als auch den HMAC als einzelne Nachricht. Der Empfänger berechnet den Hashwert für die empfangene Nachricht neu und überprüft, ob der berechnete Hashwert mit dem übertragenen Hashwert übereinstimmt.

HMAC kann mit jeder iterativen kryptografischen Hashfunktion wie MD5 oder SHA-1 in Kombination mit einem gemeinsam genutzten Geheimschlüssel verwendet werden. Die kryptografische Stärke von HMAC hängt von den Eigenschaften der zugrunde liegenden Hashfunktion ab.

Jede Änderung der Daten oder des Hashwerts führt zu einem Konflikt, da Kenntnisse des geheimen Schlüssels erforderlich sind, um die Nachricht zu ändern und den richtigen Hashwert zu reproduzieren. Wenn also die ursprünglichen und berechneten Hashwerte übereinstimmen, wird die Nachricht authentifiziert.

Aufgrund von Kollisionsproblemen mit MD5 und SHA-1 empfiehlt Microsoft ein Sicherheitsmodell, das auf SHA-256 oder höher basiert.

Konstruktoren

HMAC()

Initialisiert eine neue Instanz der HMAC-Klasse.

Felder

HashSizeValue	Stellt die Größe des berechneten Hashcodes in Bits dar. (Geerbt von HashAlgorithm)
HashValue	Stellt den Wert des errechneten Hashcodes dar. (Geerbt von HashAlgorithm)
KeyValue	Der im Hashalgorithmus zu verwendende Schlüssel. (Geerbt von KeyedHashAlgorithm)
State	Stellt den Zustand der Hashberechnung dar. (Geerbt von HashAlgorithm)

Eigenschaften

BlockSizeValue	Ruft die für den Hashwert verwendete Blockgröße ab oder legt diese fest.
CanReuseTransform	Ruft einen Wert ab, der angibt, ob die aktuelle Transformation wiederverwendet werden kann. (Geerbt von HashAlgorithm)
CanTransformMultipleBlocks	Ruft beim Überschreiben in einer abgeleiteten Klasse einen Wert ab, der angibt, ob mehrere Blöcke transformiert werden können. (Geerbt von HashAlgorithm)
Hash	Ruft den Wert des berechneten Hashcodes ab. (Geerbt von HashAlgorithm)
HashName	Ruft den Namen des für die Hashoperation verwendeten Hashalgorithmus ab oder legt diesen fest.
HashSize	Ruft die Größe des berechneten Hashcodes in Bits ab. (Geerbt von HashAlgorithm)
InputBlockSize	Ruft beim Überschreiben in einer abgeleiteten Klasse die Eingabeblockgröße ab. (Geerbt von HashAlgorithm)
Key	Ruft den Schlüssel für die HMAC-Berechnung ab oder legt diesen fest.
OutputBlockSize	Ruft beim Überschreiben in einer abgeleiteten Klasse die Ausgabeblockgröße ab. (Geerbt von HashAlgorithm)

Methoden

Clear()	Gibt alle von der HashAlgorithm-Klasse verwendeten Ressourcen frei. (Geerbt von HashAlgorithm)
ComputeHash(Byte[])	Errechnet den Hashwert für das angegebene Bytearray. (Geerbt von HashAlgorithm)
ComputeHash(Byte[], Int32, Int32)	Berechnet den Hashwert für den angegebenen Bereich des angegebenen Bytearrays. (Geerbt von HashAlgorithm)
ComputeHash(Stream)	Berechnet den Hashwert für das angegebene Stream-Objekt. (Geerbt von HashAlgorithm)
ComputeHashAsync(Stream, CancellationToken)	Berechnet den Hashwert für das angegebene Stream-Objekt asynchron. (Geerbt von HashAlgorithm)
Create()	Veraltet. Erstellt eine Instanz der Standardimplementierung eines Hash-Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code).
Create(String)	Veraltet. Erstellt eine Instanz der angegebenen Implementierung eines Hash-Nachrichtenauthentifizierungscodes (HMAC, Hash-based Message Authentication Code).
Dispose()	Gibt alle von der aktuellen Instanz der HashAlgorithm-Klasse verwendeten Ressourcen frei. (Geerbt von HashAlgorithm)
Dispose(Boolean)	Gibt die von der HMAC-Klasse verwendeten nicht verwalteten Ressourcen frei, wenn eine Schlüsseländerung zulässig ist, und gibt optional auch die verwalteten Ressourcen frei.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HashCore(Byte[], Int32, Int32)	Leitet beim Überschreiben in einer abgeleiteten Klasse die in das Objekt geschriebenen Daten zum Berechnen des HMAC-Werts an den HMAC-Algorithmus weiter.
HashCore(ReadOnlySpan<Byte>)	Leitet in das Objekt geschriebene Daten in den HMAC-Algorithmus für die Berechnung vom HMAC weiter.
HashFinal()	Schließt beim Überschreiben in einer abgeleiteten Klasse die HMAC-Berechnung ab, nachdem die letzten Daten vom Algorithmus verarbeitet wurden.
Initialize()	Initialisiert eine Instanz der Standardimplementierung des HMAC.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TransformBlock(Byte[], Int32, Int32, Byte[], Int32)	Errechnet den Hashwert für den angegebenen Bereich des Eingabebytearrays und kopiert den angegebenen Bereich des Eingabebytearrays in den angegebenen Bereich des Ausgabebytearrays. (Geerbt von HashAlgorithm)
TransformFinalBlock(Byte[], Int32, Int32)	Berechnet den Hashwert für den angegebenen Bereich des angegebenen Bytearrays. (Geerbt von HashAlgorithm)
TryComputeHash(ReadOnlySpan<Byte>, Span<Byte>, Int32)	Versucht, den Hashwert für das angegebene Bytearray zu berechnen. (Geerbt von HashAlgorithm)
TryHashFinal(Span<Byte>, Int32)	Versucht, die HMAC-Berechnung abzuschließen, nachdem die letzten Daten vom HMAC-Algorithmus verarbeitet wurden.

Weitere Informationen

• Kryptografische Dienste