Generator i Weryfikator HMAC

Generuj i weryfikuj podpisy RFC 2104 HMAC-SHA256, SHA-384, SHA-512, SHA-1 i MD5 w formatach Hex, Base64 oraz Base64URL w przeglądarce przez Web Crypto.

Bez przesyłania plikówBez rejestracjiNatychmiastowe wyniki
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URL100% Lokalnie • Zero Wysyłania
Oblicz HMAC
Silnik offline gotowy100% prywatna praca w przeglądarce • Bez wysyłania do chmury
100% prywatności • Zero wysyłania plików na serwer

Dlaczego warto używać darmowego Generator i Weryfikator HMAC od Utiliome?

Stworzone od podstaw dla pełnej prywatności i natychmiastowego działania. Bez subskrypcji, opłat i rejestracji.

Konstrukcja zgodna z RFC 2104 i FIPS 198-1

Implementuje standardowe dopełnianie klucza operacją XOR o rozmiarze bloku wewnętrznego (0x36) i zewnętrznego (0x5c) dla algorytmów HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 oraz HMAC-MD5, zweryfikowane z wektorami testowymi IETF RFC 2202 i RFC 4231.

Dekodowanie tajnego klucza UTF-8, Hex i Base64

Parsuje klucze podpisujące jako tekst UTF-8, surowe oktety szesnastkowe lub bufory bajtów RFC 4648 Base64, dzięki czemu binarne klucze API są dekodowane do dokładnych bajtów klucza przed wyprowadzeniem kodu HMAC.

Tryb weryfikacji podpisu w stałym czasie (Constant-Time)

Waliduje przychodzące nagłówki MAC webhooków lub API względem obliczonych podpisów za pomocą crypto.subtle.verify z Web Crypto oraz bitowego porównania XOR o stałej długości, bez wycieku informacji o czasie przetwarzania prefiksu.

Formaty wyjściowe Hex, Base64 i Base64URL dla webhooków

Generuje skróty w formacie Hex małymi/wielkimi literami (GitHub, Stripe, Slack), standardowym Base64 z dopełnieniem (Shopify, AWS) oraz Base64URL bez dopełnienia (segmenty JWS/JWT) całkowicie offline w lokalnej pamięci przeglądarki.

Utiliome kontra tradycyjne narzędzia w chmurze

Porównaj nasz lokalny silnik WebAssembly ze starymi narzędziami chmurowymi.

Funkcja Utiliome (Lokalnie w przeglądarce) Tradycyjne konwertery chmurowe
Konstrukcja zgodna z RFC 2104 i FIPS 198-1 Implementuje standardowe dopełnianie klucza operacją XOR o rozmiarze bloku wewnętrznego (0x36) i zewnętrznego (0x5c) dla algorytmów HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 oraz HMAC-MD5, zweryfikowane z wektorami testowymi IETF RFC 2202 i RFC 4231. Ograniczone opcje bez zaawansowanej konfiguracji
Dekodowanie tajnego klucza UTF-8, Hex i Base64 Parsuje klucze podpisujące jako tekst UTF-8, surowe oktety szesnastkowe lub bufory bajtów RFC 4648 Base64, dzięki czemu binarne klucze API są dekodowane do dokładnych bajtów klucza przed wyprowadzeniem kodu HMAC. Wymaga zewnętrznych narzędzi lub ręcznej obróbki
Prywatność i przetwarzanie danych 100% lokalnie w przeglądarce (zero wysyłania na serwer) Przesyła dane na zewnętrzne serwery w chmurze
Cena i wymóg konta 100% za darmo na zawsze bez rejestracji Wymaga rejestracji konta lub płatnej subskrypcji
Jak to działa

Generator i Weryfikator HMAC – instrukcja w 3 prostych krokach

Instalacja oprogramowania nie jest wymagana. Wszystko działa w Twojej przeglądarce.

1

Wprowadź dokładny ładunek wiadomości (Payload)

Wklej surowe, niesformatowane ciało żądania HTTP lub kanoniczny ciąg znaków do podpisania — zachowując dokładne białe znaki i kolejność kluczy — albo upuść przechwycony plik ładunku.

2

Skonfiguruj kodowanie tajnego klucza i funkcję skrótu

Wprowadź współdzielony sekret (shared secret), wybierz jego reprezentację bajtową (zwykły tekst UTF-8, Hex lub Base64) i wskaż algorytm HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 lub HMAC-MD5.

3

Skopiuj kod MAC lub zweryfikuj przychodzący podpis

Skopiuj wynikowy skrót w formacie Hex, Base64 lub Base64URL albo wklej oczekiwany podpis (usuwając prefiksy transportowe takie jak sha256= czy v0=), aby uruchomić weryfikację w stałym czasie.

Obliczanie i weryfikacja podpisów HMAC dla webhooków i API: Praktyczny przewodnik

Szybka odpowiedź: Podpisanie wiadomości what do ya want for nothing? 4-bajtowym sekretem Jefe (przypadek testowy 2 z IETF RFC 4231) za pomocą HMAC-SHA256 daje 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 w formacie Hex oraz W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= w Base64 niezależnie od tego, czy klucz podano w trybie UTF-8, Hex (4a656665) czy Base64 (SmVmZQ==).

Kod uwierzytelniania wiadomości oparty na funkcji skrótu z kluczem (Keyed-Hash Message Authentication Code — HMAC) dowodzi zarówno integralności danych (ładunek nie został zmodyfikowany podczas transmisji), jak i autentyczności (nadawca posiada współdzielony tajny klucz). Odtworzenie podpisu dostawcy wymaga zgodności trzech dokładnych parametrów: bazowej funkcji skrótu, surowego zdekodowania bajtów tajnego klucza oraz dokładnej sekwencji bajtów podpisywanego ładunku.

Przykład 1: Przypadek testowy 2 z IETF RFC 2104 / RFC 2202 / RFC 4231

Niezależnie od tego, czy wprowadzisz 4-bajtowy tajny klucz jako tekst UTF-8 Jefe, zapis szesnastkowy 4a656665 czy Base64 SmVmZQ==, zostanie on zdekodowany do identycznego bufora klucza [0x4a, 0x65, 0x66, 0x65]. Podpisanie 28-bajtowej wiadomości UTF-8 what do ya want for nothing? zwraca:

{
  "keyUtf8": "Jefe",
  "keyHex": "4a656665",
  "keyBase64": "SmVmZQ==",
  "message": "what do ya want for nothing?",
  "signatures": {
    "hmac_md5_hex": "750c783e6ab0b503eaa86e310a5db738",
    "hmac_sha1_hex": "effcdf6ae5eb2fa2d27416d5f184df9c259a7c79",
    "hmac_sha256_hex": "5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843",
    "hmac_sha256_base64": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=",
    "hmac_sha256_base64url": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM",
    "hmac_sha384_hex": "af45d2e376484031617f78d2b58a6b1b9c7ef464f5a01b47e42ec3736322445e8e2240ca5e69e2c78b3239ecfab21649",
    "hmac_sha512_hex": "164b7a7bfcf819e2e395fbe73b56e0a387bd64222e831fd610270cd7ea2505549758bf75c05a994a6d034f65f8f0e6fdcaeab1a34d4a6b4b636e070a38bce737"
  }
}

Przykład 2: Base64 kontra Base64URL i kanoniczne ładunki webhooków

Standardowy format Base64 (RFC 4648 sekcja 4) używa znaków +, / oraz końcowego dopełnienia =, natomiast bezpieczny dla adresów URL format Base64URL (RFC 4648 sekcja 5, stosowany w podpisach JWS/JWT i podpisanych URL-ach) zastępuje + znakiem -, / znakiem _ i usuwa znaki dopełnienia =. Podpisanie ciągu The quick brown fox jumps over the lazy dog kluczem UTF-8 key w algorytmie HMAC-SHA256 bezpośrednio obrazuje różnicę w kodowaniu:

Key (UTF-8):     key
Message (UTF-8): The quick brown fox jumps over the lazy dog

HMAC-SHA256 Hex:       f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
HMAC-SHA256 Base64:    97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg=
HMAC-SHA256 Base64URL: 97yD9DBThCSxMpjmqm-xQ-9NWaFJRhdZl0edvC0aPNg

Podczas weryfikacji rzeczywistych nagłówków webhooków skonstruuj dokładny ładunek wejściowy do podpisu zdefiniowany przez danego dostawcę przed usunięciem prefiksów nagłówka:

GitHub (X-Hub-Signature-256: sha256=<hex>):
  Signed input = <raw_http_body>

Stripe (Stripe-Signature: t=1730419200,v1=<hex>):
  Signed input = 1730419200.<raw_http_body>

Slack (X-Slack-Signature: v0=<hex>):
  Signed input = v0:1730419200:<raw_http_body>

Shopify (X-Shopify-Hmac-Sha256: <base64>):
  Signed input = <raw_http_body>

Konstrukcja RFC 2104, zasady normalizacji klucza i odporność na ataki czasowe (Timing Attacks)

Szybka odpowiedź: Standard RFC 2104 definiuje HMAC jako H((K_0 XOR opad) || H((K_0 XOR ipad) || m)), normalizując tajne klucze względem wewnętrznego rozmiaru bloku kompresji funkcji skrótu B (64 bajty dla MD5/SHA-1/SHA-256; 128 bajtów dla SHA-384/SHA-512), a nie względem długości wyjściowej skrótu L.

Zdefiniowany w IETF RFC 2104 oraz NIST FIPS 198-1, algorytm HMAC opakowuje dowolną iteracyjną kryptograficzną funkcję skrótu H w zagnieżdżoną dwuprzebiegową strukturę, która zapobiega atakom polegającym na wydłużeniu wiadomości (length-extension attacks) w konstrukcjach Merkle-Damgarda:

HMAC(K, m) = H( (K_0 XOR opad) || H( (K_0 XOR ipad) || m ) )

Rozmiar bloku (`B`) a długość wyjściowa (`L`) i normalizacja klucza

Częstym błędem implementacyjnym w niestandardowym kodzie HMAC jest normalizacja tajnego klucza K względem długości bajtowej wyjściowego skrótu L zamiast długości bajtowej bloku kompresji B:

  • MD5 (L = 16), SHA-1 (L = 20), SHA-256 (L = 32): Wewnętrzny rozmiar bloku B = 64 bajty (512 bitów).
  • SHA-384 (L = 48), SHA-512 (L = 64): Wewnętrzny rozmiar bloku B = 128 bajtów (1024 bity).

Przed wykonaniem operacji XOR ze stałymi ipad (0x36 powtórzone B razy) oraz opad (0x5c powtórzone B razy), surowe bajty klucza K są normalizowane do dokładnego B-bajtowego bloku K_0:

  1. Krótkie klucze (len(K) < B): Dołącz B - len(K) bajtów zerowych (0x00) z prawej strony klucza K.
  2. Klucze wyrównane do bloku (len(K) == B): Użyj klucza K bez modyfikacji (K_0 = K).
  3. Klucze przekraczające rozmiar bloku (len(K) > B): Oblicz jednokrotnie skrót z klucza K za pomocą H(K), uzyskując L-bajtowy skrót, a następnie dołącz B - L bajtów zerowych (0x00), aby osiągnąć długość B bajtów.

Zgodnie z RFC 2104 sekcja 3, tajne klucze powinny zawierać co najmniej L bajtów entropii kryptograficznej (>= 32 bajty z generatora CSPRNG dla HMAC-SHA256, >= 64 bajty z CSPRNG dla HMAC-SHA512). Klucze krótsze niż L obniżają efektywne bezpieczeństwo przed atakami siłowymi (brute-force) poniżej granicy paradoksu urodzin funkcji skrótu.

Pułapki kodowania klucza i weryfikacja w stałym czasie

  • Ciąg znaków Hex a surowe bajty Hex: Jeśli API wydaje 64-znakowy sekret szesnastkowy, np. 4a656665..., sprawdź, czy oficjalne SDK traktuje ten ciąg jako 64 bajty ASCII UTF-8 (0x34 0x61...), czy też dekoduje go z formatu szesnastkowego do 32 surowych bajtów (0x4a 0x65...) przed wywołaniem importKey. Przełączanie selektora kodowania klucza pomiędzy UTF-8, Hex a Base64 pozwala natychmiast wyizolować niezgodności dekodowania klucza podczas debugowania integracji.
  • Weryfikacja w stałym czasie (Constant-Time): Nigdy nie waliduj niezaufanego kodu MAC w kodzie serwerowym za pomocą standardowego porównania ciągów znaków (computedHex === headerHex). Standardowe porównanie zwraca false przy pierwszym niezgodnym bajcie, tworząc wyrocznię czasową (timing oracle) w skali nanosekund, która pozwala zdalnym atakującym na odgadnięcie prawidłowego kodu MAC metodą brute-force bajt po bajcie (256 * L prób zamiast 2^(8*L)). Weryfikacja w przeglądarce wykorzystuje crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer) (lub bitową akumulację XOR o stałej długości na zdekodowanych tablicach bajtów), co odpowiada funkcjom crypto.timingSafeEqual w Node.js oraz hmac.compare_digest w języku Python.

Generator HMAC vs Generator Skrótów Kryptograficznych vs Generator JWT: Którego narzędzia potrzebujesz?

Szybka odpowiedź: Użyj Generatora HMAC do podpisywania lub weryfikacji surowych ładunków (ciał HTTP, ciągów kanonicznych, zdarzeń webhooków) przy użyciu współdzielonego tajnego klucza. Użyj Generatora Skrótów Kryptograficznych do obliczania skrótów ciągów znaków lub plików bez klucza, a Generatora JWT do tworzenia ustrukturyzowanych tokenów RFC 7519 JSON Web Token podpisywanych algorytmami HS256, HS384 lub HS512.

Chociaż skróty bezkluczowe, surowe kody HMAC oraz symetryczne tokeny JSON Web Token współdzielą te same bazowe prymitywy SHA-2, rozwiązują one problemy w różnych warstwach bezpieczeństwa protokołów:

Funkcja Generator i Weryfikator HMAC (To narzędzie) Generator Skrótów Kryptograficznych Generator JWT
Prymityw kryptograficzny Kod MAC z kluczem (RFC 2104 / FIPS 198-1) Skrót bez klucza (FIPS 180-4 / RFC 1321) Koperta tokenu JWS / JWT (RFC 7515 / RFC 7519)
Wymaga tajnego klucza Tak (współdzielony sekret UTF-8, Hex lub Base64) Nie Tak (sekret symetryczny lub para kluczy RSA/ECDSA)
Gwarancja bezpieczeństwa Autentyczność + integralność danych Wyłącznie integralność danych (przypadkowa / publiczna) Uwierzytelnione ustrukturyzowane roszczenia (iss, sub, exp)
Obsługiwane algorytmy HMAC-SHA256, SHA384, SHA512, SHA1, MD5 MD5, SHA-1, SHA-256, SHA-384, SHA-512 HS256, HS384, HS512 (oraz zestawy asymetryczne JWS)
Format wyjściowy Hex, Base64, Base64URL Małe/Wielkie litery Hex, Base64 <header>.<payload>.<signature> (Base64URL)

Wybór odpowiedniego narzędzia

  • Debugujesz bezkluczowe skróty plików, hasze W3C SRI lub klucze ETag / pamięci podręcznej? Nie występuje tu tajny klucz — skorzystaj z narzędzia Generator Skrótów Kryptograficznych.
  • Budujesz lub analizujesz tokeny uwierzytelniające typu Bearer (HS256, HS384, HS512)? Zgodnie z RFC 7515 podpis JWT HS256 jest ściśle pozbawionym dopełnienia wynikiem Base64URL z operacji HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))). Choć możesz zweryfikować surowy trzeci segment bezpośrednio tutaj, wklejając <base64url_header>.<base64url_payload> jako wiadomość i wybierając format wyjściowy Base64URL, użyj narzędzia Generator JWT, aby edytować nagłówki JSON, walidować znaczniki czasu exp/nbf i składać kompletne trzyczęściowe tokeny.
  • Symetryczny HMAC a podpisy asymetryczne: Ponieważ HMAC jest algorytmem symetrycznym, każda usługa weryfikująca podpis posiada dokładnie ten sam sekret, który jest potrzebny do podrabiania (generowania) nowych podpisów. Stosuj HMAC dla webhooków typu punkt-punkt i zaufanych usług wewnętrznych; gdy niezaufane podmioty zewnętrzne muszą weryfikować tokeny bez uprawnień do podpisywania, użyj kluczy asymetrycznych (RS256, ES256, EdDSA) w narzędziu Generator JWT.
FAQ

Generator i Weryfikator HMAC – FAQ i przewodnik techniczny

Wszystko, co musisz wiedzieć o darmowym narzędziu online generator hmac od Utiliome.

Dlaczego weryfikacja HMAC mojego webhooka kończy się niepowodzeniem, mimo że tajny klucz i pola JSON wyglądają identycznie?

Dwie przyczyny odpowiadają za ponad 90% niezgodności kodów HMAC w webhookach. Po pierwsze, oprogramowanie pośredniczące (middleware), takie jak express.json() w Express, parsuje i ponownie serializuje strukturę JSON, zmieniając białe znaki, sekwencje ucieczki Unicode lub kolejność kluczy względem surowego strumienia bajtów TCP podpisanego przez nadawcę — zawsze podpisuj surowy, nieprzetworzony bufor żądania i uwzględniaj wymagane przez dostawcę prefiksy znaczników czasu (takie jak <timestamp>.<body> w Stripe lub v0:<timestamp>:<body> w Slacku). Po drugie, sprawdź, czy sekret dostawcy nie musi zostać zdekodowany z formatu Base64 lub Hex do surowych bajtów zamiast odczytywania go jako ciąg znaków UTF-8.

Dlaczego konstrukcja SHA256(secret + message) jest niebezpieczna w porównaniu ze standardem RFC 2104 HMAC-SHA256?

Algorytmy MD5, SHA-1, SHA-256 i SHA-512 wykorzystują konstrukcję Merkle-Damgarda, której końcowy skrót ujawnia pełny wewnętrzny stan kompresji. Znając wartość SHA256(secret || message) oraz długość bajtową sekretu secret, atakujący może obliczyć prawidłowy skrót SHA256(secret || message || padding || attacker_suffix) bez znajomości samego sekretu secret (jest to atak typu length-extension). Standard RFC 2104 HMAC eliminuje tę podatność, przekazując wewnętrzny skrót do drugiego, zewnętrznego haszowania z kluczem: H((K_0 XOR opad) || inner_hash).

Co się stanie, jeśli mój tajny klucz HMAC jest dłuższy niż 64 lub 128 bajtów?

Zgodnie z sekcją 2 standardu RFC 2104, jeśli tajny klucz ściśle przekracza wewnętrzny rozmiar bloku funkcji skrótu B (len(K) > 64 bajty dla MD5, SHA-1 i SHA-256; len(K) > 128 bajtów dla SHA-384 i SHA-512), klucz jest najpierw kompresowany poprzez jednokrotne zahaszowanie funkcją H(K) do długości L bajtów, a następnie dopełniany z prawej strony bajtami 0x00 do pełnych B bajtów. Zarówno interfejs Web Crypto (crypto.subtle.importKey), jak i zgodne z RFC biblioteki serwerowe wykonują ten krok wstępnego haszowania automatycznie.

Które kodowanie wyjściowe powinienem wybrać dla usług GitHub, Stripe, Slack, Shopify oraz tokenów JWT HS256?

GitHub (X-Hub-Signature-256), Stripe (Stripe-Signature v1) oraz Slack (X-Slack-Signature v0) przesyłają skróty HMAC-SHA256 w formacie Hex małymi literami po swoich odpowiednich prefiksach sha256=, v1= lub v0=. Shopify (X-Shopify-Hmac-Sha256) oraz AWS Signature v1/v2 używają standardowego formatu Base64 z dopełnieniem. Tokeny JSON Web Token (HS256, HS384, HS512) wymagają formatu Base64URL bez dopełnienia zgodnie z RFC 7515 — zobacz Generator JWT, aby złożyć pełny token.

Czy algorytmy HMAC-MD5 i HMAC-SHA1 są złamane przez ataki kolizyjne na MD5 i SHA-1?

Nie bezpośrednio. Ataki kolizyjne na bezkluczowe funkcje MD5 i SHA-1 opierają się na możliwości swobodnego dobierania przez atakującego bloków wiadomości względem publicznego, stałego wektora inicjującego (IV), podczas gdy HMAC maskuje wewnętrzny wektor IV za tajnymi krokami K_0 XOR ipad oraz K_0 XOR opad (co udokumentowano w IETF RFC 6151). Mimo to standard NIST SP 800-131A oraz główni dostawcy webhooków (np. GitHub wycofujący nagłówek X-Hub-Signature oparty na SHA-1) uznają HMAC-MD5 i starszy HMAC-SHA1 za przestarzałe w nowych systemach — zawsze wybieraj HMAC-SHA256 lub HMAC-SHA512, chyba że utrzymujesz kompatybilność ze starszymi protokołami.