HMAC-Generator (Base64)

So berechnen Sie einen HMAC in Base64

1. Der Modus HMAC und SHA-256 sind ausgewählt. Wählen Sie unter Algorithmus einen anderen, wenn Ihre API SHA-1, SHA-384, SHA-512 oder MD5 verwendet.
2. Tragen Sie unter Geheimer Schlüssel den Schlüssel ein und stellen Sie Schlüssel als ein: Text (UTF-8) für eine normale Secret-Zeichenkette, Hex oder Base64, wenn der Schlüssel als kodierte Bytes vorliegt.
3. Tippen oder fügen Sie die Nachricht in Text ein, oder stellen Sie Eingabe auf Datei und legen Sie genau die Payload-Datei ab.
4. Kopieren Sie die Signatur als Base64, Base64URL oder Hex. Alle Algorithmen zeigt den HMAC mit allen Hashes auf einmal, was hilft, wenn die Dokumentation vage ist, welcher verwendet wird.

Ein leerer Schlüssel wird akzeptiert und liefert trotzdem ein Ergebnis, mit dem Hinweis, dass ein solcher HMAC nichts schützt.

Beispielwerte

Mit dem Schlüssel key und der Nachricht The quick brown fox jumps over the lazy dog:

Der HMAC-SHA256-Wert in Hex ist f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8, der bekannte Testvektor aus dem Wikipedia-Artikel zu HMAC. Die Kodierung des Schlüssels ändert das Ergebnis: Der Text a2V5 als Schlüssel ergibt 5O+7AtpguFrgIRw1qXGU+m0OaTs1oV1kwRQ/hI1WAUE=, während a2V5 als Base64 gelesen die Bytes von key sind und wieder 97yD9DBT… ergibt.

Webhook-Signaturen: Base64 oder Hex

Anbieter sind sich bei HMAC einig, nicht aber bei der Ausgabekodierung oder bei dem, was signiert wird. Einige gut dokumentierte Beispiele:

Stimmt ein Wert aus diesem Tool mit dem Hex überein, aber Ihr Code vergleicht Base64, oder umgekehrt, dann ist die Berechnung richtig, und nur die Kodierung unterscheidet sich. Was signiert wird, steht in der Dokumentation des Anbieters; die Zeitstempel-Präfixe sollen das Wiederabspielen alter Anfragen verhindern.

Eine Signatur im Code prüfen

Vergleichen Sie rohe Bytes in konstanter Zeit, und hashen Sie den Body genau so, wie er empfangen wurde:

const crypto = require("crypto");

function verifyWebhook(rawBody, secret, signatureHeader) {
  const expected = crypto.createHmac("sha256", secret).update(rawBody).digest();
  const given = Buffer.from(signatureHeader, "base64");
  return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}

Mit rawBody als Buffer des Fuchs-Satzes, dem Secret key und dem Base64-Wert aus der Tabelle gibt die Funktion true zurück. Übergeben Sie stattdessen JSON.stringify(JSON.parse(body)), liefert sie false, sobald das JSON des Anbieters ein Leerzeichen enthielt, das Ihr Serialisierer weglässt. In Express heißt das: Lesen Sie den Body auf der Webhook-Route mit express.raw().

Das Python-Gegenstück verwendet hmac.new(key, body, hashlib.sha256).digest(), kodiert das Ergebnis in Base64 und prüft mit hmac.compare_digest. Auf der Kommandozeile liefert openssl dgst -sha256 -hmac 'key' -binary | base64 dasselbe Base64; verwenden Sie -mac HMAC -macopt hexkey:…, wenn der Schlüssel in Hex vorliegt. Für einen starken Schlüssel erzeugt die Voreinstellung für HMAC-Secrets im Base64-Schlüsselgenerator 32 Zufallsbytes. Für signierte Tokens statt signierter Anfragen siehe den JWT-Encoder.

Häufige Fragen