Generator HMAC

Kako izračunati HMAC

1. Prilepi Sporočilo. Pri webhooku mora biti to surovo telo zahteve, bajt za bajtom.
2. Vnesi Skrivni ključ in izberi njegov Format ključa: Besedilo (UTF-8), Šestnajstiško ali Base64.
3. Izberi Algoritem: HMAC-SHA1, HMAC-SHA256, HMAC-SHA384 ali HMAC-SHA512.
4. Rezultat se osvežuje med tipkanjem; lahko tudi klikneš Ustvari HMAC. Dobiš HMAC (šestnajstiško), HMAC (Base64) in Glava podpisa webhooka (v slogu GitHub), vsakega z gumbom Kopiraj.
5. Če želiš preveriti prejeti podpis, ga prilepi v Primerjaj s pričakovanim podpisom (hex, Base64 ali sha256=…). Orodje pove, ali se ujema.

Sporočilo je kodirano v UTF-8 natančno tako, kot je vneseno, vključno s presledki in prelomi vrstic. Izračun uporablja vmesnik Web Crypto API tvojega brskalnika; sporočilo in ključ nikoli ne zapustita tvoje naprave.

Kaj je HMAC

HMAC (koda za overjanje sporočila na osnovi zgoščevanja, RFC 2104) združuje skrivni ključ z zgoščevalno funkcijo:

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

pri čemer je K′ ključ, dopolnjen na velikost bloka zgoščevalne funkcije (najprej zgoščen, če je daljši), ipad/opad pa sta stalni konstanti. Pravo kodo za sporočilo lahko ustvari samo tisti, ki pozna ključ, vsaka sprememba sporočila pa kodo popolnoma spremeni. Zato HMAC podpisujejo webhooke, zahteve API (na primer AWS Signature Version 4) in žetone JSON Web Token HS256.

HMAC ni šifriranje: sporočilo ni skrito. Ni tudi zgostitev gesla; za shranjevanje gesel uporabi počasno funkcijo, kot sta bcrypt ali Argon2.

Dolžina izhoda je odvisna od algoritma: 20 bajtov za SHA-1, 32 za SHA-256, 48 za SHA-384 in 64 za SHA-512. HMAC-SHA1 se kot MAC še vedno šteje za varnega, vendar za nove sisteme raje izberi SHA-256. Priporočen je naključen ključ, vsaj tako dolg kot izhod (32 bajtov za HMAC-SHA256); šestnajstiški ali Base64 ključi omogočajo neposreden vnos takih naključnih bajtov.

Preverjanje webhooka GitHub

GitHub vsako dostavo podpiše z geslom tvojega webhooka in rezultat pošlje v glavi X-Hub-Signature-256 kot sha256=, ki mu sledi šestnajstiški HMAC-SHA256 telesa. V GitHubovem primeru iz dokumentacije se uporabljata skrivnost It's a Secret to Everybody in telo Hello, World!; vnesi ju tu s HMAC-SHA256 in glava prikaže:

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

Polje za primerjavo sprejme celotno vrstico glave, vrednost sha256=… ali goli šestnajstiški ali Base64 podpis (Stripe, Shopify in Slack uporabljajo podobne sheme z lastnimi glavami in podpisanimi nizi). Za SHA-384 in SHA-512 orodje prikaže splošno glavo X-Signature, saj skupnega standarda ni.

Primerjava v konstantnem času

Strežnik, ki podpise primerja z navadno primerjavo nizov, se ustavi pri prvem različnem znaku. Z merjenjem odzivnih časov bi napadalec lahko ugibal veljaven podpis znak za znakom. Primerjava v tem orodju preveri vsak bajt, ne glede na rezultat, kot bi moral strežnik s crypto.timingSafeEqual v Node.js, hmac.compare_digest v Pythonu ali hash_equals v PHP.