HMAC Generator

Co je HMAC?

HMAC (Hash-based Message Authentication Code) je kryptografická konstrukce definovaná v RFC 2104, která kombinuje hašovací funkci s tajným klíčem a produkuje autentizační příznak pevné délky. Na rozdíl od prostého hashe, který může vypočítat kdokoli, lze HMAC generovat a ověřovat pouze stranami sdílejícími tajný klíč. HMAC je standardní mechanismus pro ověřování integrity i autenticity zprávy — potvrzuje, že data nebyla pozměněna a že je vytvořil důvěryhodný odesílatel.

Algoritmus HMAC pracuje s libovolnou iterativní hašovací funkcí: SHA-256, SHA-384, SHA-512 a dokonce i staršími funkcemi jako SHA-1 nebo MD5. Výsledná konstrukce se označuje podle základního hashe — HMAC-SHA256, HMAC-SHA384 nebo HMAC-SHA512. Protože bezpečnostní důkaz HMAC závisí na odolnosti hašovací funkce vůči kolizím a na určitých pseudonáhodných vlastnostech, jsou algoritmy rodiny SHA-2 doporučenou volbou pro nové systémy. HMAC-SHA256 je nejrozšířenější variantou — používá se v AWS Signature V4, Stripe webhooks, GitHub webhook secrets, Slack request signing a JSON Web Tokens (HS256).

Návrh HMAC poskytuje kritickou vlastnost, kterou prostému hašování chybí: odolnost vůči útokům prodloužením délky. Při použití samotného SHA-256 může útočník, který zná H(zpráva), vypočítat H(zpráva || útočník_data) bez znalosti původní zprávy. Struktura HMAC s dvojitým hašováním (vnitřní hash a vnější hash s různě doplněnými klíči) tomuto útoku zcela zabraňuje. Proto schémata podepisování API používají HMAC místo připojení tajného klíče ke zprávě a hašování výsledku.

Proč používat online generátor HMAC?

Výpočet HMAC podpisů obvykle vyžaduje psaní kódu nebo použití nástrojů příkazové řádky. Tento generátor HMAC běžící v prohlížeči umožňuje vytvářet podpisy HMAC-SHA256, HMAC-SHA384 a HMAC-SHA512 okamžitě bez instalace softwaru nebo přepínání do terminálu.

Případy použití generátoru HMAC

HMAC vs prostý hash vs šifrování

HMAC, prosté hašování a šifrování slouží různým účelům. HMAC poskytuje autentizaci zprávy — důkaz, že zprávu vytvořil někdo se znalostí tajného klíče a že nebyla pozměněna. Prostý hash poskytuje integritu, ale nikoli autentizaci. Šifrování zajišťuje důvěrnost. Níže uvedená tabulka objasňuje tyto rozdíly.

Srovnání algoritmů HMAC

HMAC může používat libovolnou hašovací funkci, ale volba základního algoritmu určuje velikost výstupu, úroveň zabezpečení a kompatibilitu s prohlížečem. HMAC-SHA256 je nejběžnější volbou pro nové systémy. Níže uvedená tabulka porovnává varianty, se kterými se pravděpodobně setkáte.

Jak HMAC funguje interně

HMAC aplikuje základní hašovací funkci dvakrát se dvěma různými doplněními odvozenými z klíče. Tato konstrukce je definována v RFC 2104 a je dokázáno, že jde o PRF (pseudonáhodnou funkci) za standardních kryptografických předpokladů. Klíč je nejprve doplněn nebo hašován na velikost bloku hašovací funkce (64 bajtů pro SHA-256, 128 bajtů pro SHA-512).

Algoritmus provede XOR doplněného klíče s konstantou vnitřního doplnění (ipad, 0x36 opakovaně), spojí ho se zprávou a hašuje výsledek. Poté provede XOR doplněného klíče s konstantou vnějšího doplnění (opad, 0x5C opakovaně), spojí ho s výstupem vnitřního hashe a znovu hašuje. Tato struktura s dvojitým hašováním zabraňuje útokům prodloužením délky a zajišťuje, že výstup HMAC nelze vypočítat bez znalosti tajného klíče.

Ukázky kódu HMAC

HMAC je nativně podporována ve všech hlavních jazycích a prostředích. Web Crypto API poskytuje HMAC-SHA256, HMAC-SHA384 a HMAC-SHA512 v prohlížečích bez jakékoli knihovny. Níže uvedené příklady ukazují vzory reálného použití včetně ověřování webhooků a porovnávání v konstantním čase.

async function hmacSHA256(message, secret) {
  const enc = new TextEncoder()
  const key = await crypto.subtle.importKey(
    'raw', enc.encode(secret),
    { name: 'HMAC', hash: 'SHA-256' },
    false, ['sign']
  )
  const sig = await crypto.subtle.sign('HMAC', key, enc.encode(message))
  return Array.from(new Uint8Array(sig))
    .map(b => b.toString(16).padStart(2, '0')).join('')
}

await hmacSHA256('hello world', 'my-secret-key')
// → "90eb182d8396f16d4341d582047f45c0a97d73388c5377d9ced478a2212295ad"

// Node.js (built-in crypto module)
const crypto = require('crypto')
crypto.createHmac('sha256', 'my-secret-key')
  .update('hello world').digest('hex')
// → "90eb182d8396f16d4341d582047f45c0a97d73388c5377d9ced478a2212295ad"

import hmac
import hashlib

# HMAC-SHA256
sig = hmac.new(
    b'my-secret-key',
    b'hello world',
    hashlib.sha256
).hexdigest()
print(sig)
# → "90eb182d8396f16d4341d582047f45c0a97d73388c5377d9ced478a2212295ad"

# Verify a webhook signature (constant-time comparison)
expected = "90eb182d8396f16d4341d582047f45c0a97d73388c5377d9ced478a2212295ad"
received = hmac.new(b'my-secret-key', b'hello world', hashlib.sha256).hexdigest()
if hmac.compare_digest(expected, received):
    print("Signature valid")

# HMAC-SHA512
hmac.new(b'key', b'data', hashlib.sha512).hexdigest()

package main

import (
    "crypto/hmac"
    "crypto/sha256"
    "fmt"
)

func main() {
    mac := hmac.New(sha256.New, []byte("my-secret-key"))
    mac.Write([]byte("hello world"))
    sig := mac.Sum(nil)
    fmt.Printf("%x\n", sig)
    // → 90eb182d8396f16d4341d582047f45c0a97d73388c5377d9ced478a2212295ad

    // Verify: use hmac.Equal for constant-time comparison
    expected := mac.Sum(nil)
    fmt.Println(hmac.Equal(sig, expected)) // true
}

# HMAC-SHA256
echo -n "hello world" | openssl dgst -sha256 -hmac "my-secret-key"
# → SHA2-256(stdin)= 90eb182d8396f16d4341d582047f45c0a97d73388c5377d9ced478a2212295ad

# HMAC-SHA512
echo -n "hello world" | openssl dgst -sha512 -hmac "my-secret-key"

# Verify a file signature
openssl dgst -sha256 -hmac "my-secret-key" release.tar.gz

# HMAC with hex key (e.g. from a webhook secret)
echo -n "payload" | openssl dgst -sha256 -hmac "$(echo -n '736563726574' | xxd -r -p)"

Často kladené otázky