HMAC Klasse

  • Referenz

Definition

Namespace:
System.Security.Cryptography
Assembly:
System.Security.Cryptography.Primitives.dll
Assembly:
System.Security.Cryptography.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
HMAC.cs
Quelle:
HMAC.cs
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
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class HMAC : System.Security.Cryptography.KeyedHashAlgorithm
type HMAC = class
    inherit KeyedHashAlgorithm
[<System.Runtime.InteropServices.ComVisible(true)>]
type HMAC = class
    inherit KeyedHashAlgorithm
Public MustInherit Class HMAC
Inherits KeyedHashAlgorithm
Vererbung
Object
HashAlgorithm
KeyedHashAlgorithm
HMAC
Abgeleitet
Attribute
ComVisibleAttribute

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.
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.
HashCore(ReadOnlySpan<Byte>)

Leitet die in das Objekt geschriebenen Daten zum Berechnen des Hashs in den Hashalgorithmus weiter.

(Geerbt von HashAlgorithm)
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.
TryHashFinal(Span<Byte>, Int32)

Versucht, die Hashberechnung abzuschließen, nachdem die letzten Daten vom Hashalgorithmus verarbeitet wurden.

(Geerbt von HashAlgorithm)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Gibt die von HashAlgorithm verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von HashAlgorithm)

Gilt für:

Weitere Informationen