HMAC generator

Kako izračunati HMAC

1. Zalijepi Poruku. Za webhook to mora biti sirovo tijelo zahtjeva, bajt po bajt.
2. Unesi Tajni ključ i odaberi njegov Format ključa: Tekst (UTF-8), Heksadecimalno ili Base64.
3. Odaberi Algoritam: HMAC-SHA1, HMAC-SHA256, HMAC-SHA384 ili HMAC-SHA512.
4. Rezultat se ažurira dok tipkaš; možeš kliknuti i Generiši HMAC. Dobijaš HMAC (heks), HMAC (Base64) i Zaglavlje potpisa webhooka (GitHub stil), svaki s dugmetom Kopiraj.
5. Da provjeriš potpis koji si primio, zalijepi ga u Uporedi s očekivanim potpisom (heks, Base64 ili sha256=…). Alat kaže odgovara li.

Poruka se kodira kao UTF-8 tačno onako kako je upisana, uključujući razmake i prelome redova. Izračun koristi Web Crypto API tvog preglednika; poruka i ključ nikada ne napuštaju tvoj uređaj.

Šta je HMAC

HMAC (hash-based message authentication code, RFC 2104) kombinuje tajni ključ s heš funkcijom:

HMAC(K, m) = H((K′ ⊕ opad) ‖ H((K′ ⊕ ipad) ‖ m))

gdje je K′ ključ dopunjen do veličine bloka heš funkcije (prvo se hešira ako je duži), a ipad/opad su fiksne konstante. Samo onaj ko zna ključ može proizvesti ispravan kod za poruku, a svaka promjena poruke potpuno mijenja kod. Zato HMAC-ovi potpisuju webhookove, API zahtjeve (na primjer AWS Signature Version 4) i JSON Web Tokene HS256.

HMAC nije šifrovanje: poruka nije skrivena. Nije ni heš lozinke; za pohranu lozinki koristi spor algoritam poput bcrypta ili Argon2.

Dužina izlaza zavisi od algoritma: 20 bajtova za SHA-1, 32 za SHA-256, 48 za SHA-384 i 64 za SHA-512. HMAC-SHA1 se i dalje smatra sigurnim kao MAC, ali za nove sisteme preferiraj SHA-256. Preporučuje se nasumičan ključ barem jednake dužine kao izlaz (32 bajta za HMAC-SHA256); heks ili Base64 ključevi omogućavaju direktan unos takvih nasumičnih bajtova.

Provjera GitHub webhooka

GitHub potpisuje svaku isporuku tvojom tajnom webhooka i šalje rezultat u zaglavlju X-Hub-Signature-256 kao sha256= iza kojeg slijedi heks HMAC-SHA256 tijela. Primjer iz GitHubove dokumentacije koristi tajnu It's a Secret to Everybody i tijelo Hello, World!; unesi ih ovdje s HMAC-SHA256 i zaglavlje prikazuje:

X-Hub-Signature-256: sha256=757107ea0eb2509fc211221cce984b8a37570b6d7586c22c46f4379c8b043e17

Polje za poređenje prihvata cijeli red zaglavlja, vrijednost sha256=… ili goli heks ili Base64 potpis (Stripe, Shopify i Slack koriste slične šeme s vlastitim zaglavljima i potpisanim nizovima). Za SHA-384 i SHA-512 alat prikazuje generičko zaglavlje X-Signature, jer ne postoji zajednički standard.

Poređenje u konstantnom vremenu

Server koji potpise poredi običnim poređenjem nizova staje na prvom različitom znaku. Mjerenjem vremena odgovora napadač bi mogao pogoditi ispravan potpis znak po znak. Poređenje u ovom alatu provjerava svaki bajt bez obzira na rezultat, kao što bi server trebao raditi pomoću crypto.timingSafeEqual u Node.js-u, hmac.compare_digest u Pythonu ili hash_equals u PHP-u.