HMAC Генератор и Верификатор

Изчислявайте и проверявайте RFC 2104 HMAC-SHA256, SHA-384, SHA-512, SHA-1 и MD5 подписи в Hex, Base64 или Base64URL локално в браузъра чрез Web Crypto.

Без качване на файловеБез регистрацияНезабавни резултати
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URL100% Локално • Без качване на сървър
Изчисли HMAC
Офлайн модулът е готов100% поверителна офлайн работа в браузъра • Без качване в облака
100% Поверително • Без качване на файлове на сървър

Защо да използвате безплатния HMAC Генератор и Верификатор от Utiliome?

Създаден от самото начало за пълна поверителност, моментално изпълнение и без излишни трудности. Без абонаменти или регистрация.

Конструкция, съвместима с RFC 2104 и FIPS 198-1

Реализира стандартно блоково вътрешно (0x36) и външно (0x5c) XOR допълване на ключа за HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 и HMAC-MD5, верифицирано спрямо тестовите вектори на IETF RFC 2202 и RFC 4231.

Декодиране на тайни ключове в UTF-8, Hex и Base64

Анализира тайните за подписване като UTF-8 текст, сурови шестнадесетични октети или RFC 4648 Base64 байтови буфери, така че бинарните API ключове се декодират до точните байтове на ключа преди извличането на HMAC.

Режим за проверка на подписа с константно време

Валидира входящи уебхук или API MAC хедъри спрямо изчислените подписи чрез Web Crypto crypto.subtle.verify и побитово XOR сравнение с фиксирана дължина, без да издава времеви разлики при съвпадение на префикса.

Изходи в Hex, Base64 и Base64URL за уебхукове

Генерира дайджести в Hex с малки/главни букви (GitHub, Stripe, Slack), стандартен Base64 с допълване (Shopify, AWS) и Base64URL без допълване (JWS/JWT сегменти) изцяло офлайн в локалната памет на браузъра.

Utiliome срещу традиционните облачни алтернативи

Сравнете нашия локален WebAssembly двигател с остарелите облачни инструменти.

Функция Utiliome (Локален браузър) Остарели облачни конвертори
Конструкция, съвместима с RFC 2104 и FIPS 198-1 Реализира стандартно блоково вътрешно (0x36) и външно (0x5c) XOR допълване на ключа за HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 и HMAC-MD5, верифицирано спрямо тестовите вектори на IETF RFC 2202 и RFC 4231. Ограничени опции без разширено персонализиране
Декодиране на тайни ключове в UTF-8, Hex и Base64 Анализира тайните за подписване като UTF-8 текст, сурови шестнадесетични октети или RFC 4648 Base64 байтови буфери, така че бинарните API ключове се декодират до точните байтове на ключа преди извличането на HMAC. Изисква външни инструменти или ръчна обработка
Поверителност и обработка 100% локална обработка в браузъра (0 качвания на сървър) Качва данните на външни облачни сървъри
Цена и изисквания за акаунт 100% безплатно завинаги без регистрация Изисква регистрация или платен абонамент
Как работи

Как да използвате HMAC Генератор и Верификатор в 3 лесни стъпки

Не се изисква инсталиране на софтуер. Всичко работи директно във вашия уеб браузър.

1

Подайте точния полезен товар на съобщението

Поставете суровото неформатирано тяло на HTTP заявката или каноничния низ за подписване — запазвайки точните интервали и подредбата на ключовете — или пуснете записан файл с полезен товар (payload).

2

Конфигурирайте кодирането на тайния ключ и хеша

Въведете вашата споделена тайна, изберете нейното байтово представяне (UTF-8 обикновен текст, Hex или Base64) и изберете HMAC-SHA256, HMAC-SHA384, HMAC-SHA512, HMAC-SHA1 или HMAC-MD5.

3

Копирайте MAC кода или проверете входящ подпис

Копирайте получения Hex, Base64 или Base64URL дайджест, или поставете очакван подпис (като премахнете транспортните префикси като sha256= или v0=), за да изпълните проверка с константно време.

Изчисляване и проверка на HMAC подписи за уебхукове и API: Практическо ръководство

Бърз отговор: Подписването на съобщението what do ya want for nothing? с 4-байтовата тайна Jefe (IETF RFC 4231 Тестов случай 2) чрез HMAC-SHA256 генерира 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 в Hex и W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= в Base64 при режими на ключа UTF-8, Hex (4a656665) и Base64 (SmVmZQ==).

Кодът за удостоверяване на съобщения с хеш и ключ (Keyed-Hash Message Authentication Code – HMAC) доказва едновременно цялост на данните (полезният товар не е променян по време на преноса) и автентичност (подателят притежава споделения таен ключ). Възпроизвеждането на подписа на даден доставчик изисква точно съвпадение на три параметъра: базовия хеш примитив, суровото байтово декодиране на тайния ключ и точната байтова последователност на подписания полезен товар.

Пример 1: IETF RFC 2104 / RFC 2202 / RFC 4231 Тестов случай 2

Независимо дали въвеждате 4-байтовия таен ключ като UTF-8 текст Jefe, суров шестнадесетичен код 4a656665 или Base64 SmVmZQ==, той се декодира до идентичния ключов буфер [0x4a, 0x65, 0x66, 0x65]. Подписването на 28-байтовото UTF-8 съобщение what do ya want for nothing? дава следния резултат:

{
  "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"
  }
}

Пример 2: Base64 срещу Base64URL и канонични полезни товари при уебхукове

Стандартният Base64 (RFC 4648 Раздел 4) извежда +, / и завършващо допълване =, докато безопасният за URL адреси Base64URL (RFC 4648 Раздел 5, използван в JWS/JWT подписи и подписани URL адреси) заменя + с -, / с _ и премахва допълването =. Подписването на The quick brown fox jumps over the lazy dog с UTF-8 ключ key чрез HMAC-SHA256 илюстрира директно разликата в кодирането:

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

При проверка на реални хедъри от уебхукове конструирайте точния полезен товар за подписване, дефиниран от съответния доставчик, преди да премахнете префиксите на хедъра:

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>

Конструкция според RFC 2104, правила за нормализиране на ключовете и защита срещу атаки по време

Бърз отговор: RFC 2104 дефинира HMAC като H((K_0 XOR opad) || H((K_0 XOR ipad) || m)), като нормализира тайните ключове спрямо вътрешния размер на блока за компресия на хеш функцията B (64 байта за MD5/SHA-1/SHA-256; 128 байта за SHA-384/SHA-512), а не спрямо изходната дължина на дайджеста L.

Дефиниран в IETF RFC 2104 и NIST FIPS 198-1, алгоритъмът HMAC обвива всяка итеративна криптографска хеш функция H във вложена двупроходна обвивка, която предотвратява атаки чрез удължаване на дължината (length-extension attacks) при конструкции на Меркле-Дамгард:

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

Размер на блока (`B`) срещу дължина на изхода (`L`) и нормализиране на ключа

Честа грешка при собствена имплементация на HMAC код е нормализирането на тайния ключ K спрямо байтовата дължина на изходния дайджест L, вместо спрямо байтовата дължина на блока за компресия B:

  • MD5 (L = 16), SHA-1 (L = 20), SHA-256 (L = 32): Вътрешен размер на блока B = 64 байта (512 бита).
  • SHA-384 (L = 48), SHA-512 (L = 64): Вътрешен размер на блока B = 128 байта (1024 бита).

Преди операцията XOR спрямо ipad (0x36, повторен B пъти) и opad (0x5c, повторен B пъти), суровите байтове на ключа K се нормализират до точен блок от B байта K_0:

  1. Къси ключове (len(K) < B): Добавят се B - len(K) нулеви байта (0x00) отдясно на K.
  2. Ключове с размер на блока (len(K) == B): Използва се K без промяна (K_0 = K).
  3. Дълги ключове (len(K) > B): Ключът K се хешира веднъж чрез H(K) за получаване на дайджест от L байта, след което се добавят B - L нулеви байта (0x00), за да се достигнат B байта.

Според RFC 2104 Раздел 3, тайните ключове трябва да съдържат поне L байта криптографска ентропия (>= 32 CSPRNG байта за HMAC-SHA256, >= 64 CSPRNG байта за HMAC-SHA512). Ключове, по-къси от L, намаляват ефективната защита срещу груба сила под границата на парадокса на рождените дни за хеша.

Капани при кодирането на ключове и проверка с константно време

  • Шестнадесетичен низ срещу сурови Hex байтове: Ако дадено API издаде 64-символeн шестнадесетичен таен ключ като 4a656665..., проверете дали неговият SDK третира този низ като 64 ASCII UTF-8 байта (0x34 0x61...) или го декодира от hex до 32 сурови байта (0x4a 0x65...) преди извикване на importKey. Превключването на селектора за кодиране на ключа между UTF-8, Hex и Base64 веднага изолира разминаванията при декодиране по време на дебъгване на интеграции.
  • Проверка с константно време: Никога не валидирайте недоверен MAC код в сървърен код чрез стандартно сравнение на низове (computedHex === headerHex). Стандартното сравнение на низове връща false още при първия несъвпадащ байт, създавайки времеви оракул от порядъка на наносекунди, който позволява на отдалечени нападатели да налучкат валидни MAC кодове байт по байт (256 * L опита вместо 2^(8*L)). Проверката в браузъра използва crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer) (или побитово XOR натрупване с фиксирана дължина върху декодираните байтови масиви), аналогично на crypto.timingSafeEqual в Node.js и hmac.compare_digest в Python.

HMAC Генератор срещу Генератор на криптографски хешове срещу JWT Генератор: Кой ви е необходим?

Бърз отговор: Използвайте HMAC Генератор за подписване или проверка на сурови полезни товари (HTTP тела, канонични низове, уебхук събития) със споделен таен ключ. Използвайте Генератор на криптографски хешове за дайджести на низове или файлове без ключ и JWT Генератор за изграждане на структурирани RFC 7519 JSON Web Tokens, подписани с HS256, HS384 или HS512.

Въпреки че дайджестите без ключ, суровите HMAC кодове и симетричните JSON Web Tokens споделят едни и същи базови SHA-2 примитиви, те решават различни нива на протоколна сигурност:

Характеристика HMAC Генератор и Верификатор (Този инструмент) Генератор на криптографски хешове JWT Генератор
Криптографски примитив MAC с ключ (RFC 2104 / FIPS 198-1) Дайджест без ключ (FIPS 180-4 / RFC 1321) JWS / JWT обвивка на токен (RFC 7515 / RFC 7519)
Изисква таен ключ Да (UTF-8, Hex или Base64 споделена тайна) Не Да (Симетрична тайна или RSA/ECDSA двойка ключове)
Гаранция за сигурност Автентичност + Цялост на данните Само цялост при случайни грешки / публични данни Удостоверени структурирани заявки (iss, sub, exp)
Поддържани алгоритми HMAC-SHA256, SHA384, SHA512, SHA1, MD5 MD5, SHA-1, SHA-256, SHA-384, SHA-512 HS256, HS384, HS512 (плюс асиметрични JWS пакети)
Изходен формат Hex, Base64, Base64URL Малки/Главни букви Hex, Base64 <header>.<payload>.<signature> (Base64URL)

Избор на правилния инструмент

  • Дебъгвате файлови дайджести без ключ, W3C SRI хешове или ETag / кеш ключове? Тук не участва таен ключ — използвайте Генератор на криптографски хешове.
  • Създавате или инспектирате Bearer токени за удостоверяване (HS256, HS384, HS512)? Според RFC 7515, един HS256 JWT подпис е строго Base64URL изходът без допълване от HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))). Макар че можете да проверите суровия трети сегмент директно тук, като поставите <base64url_header>.<base64url_payload> като съобщение и изберете Base64URL изход, използвайте JWT Генератор, за да редактирате JSON хедъри, да валидирате exp/nbf времеви печати и да сглобявате пълни трикомпонентни токени.
  • Симетричен HMAC срещу асиметрични подписи: Тъй като HMAC е симетричен алгоритъм, всяка услуга, която проверява подпис, притежава точната тайна, необходима за фалшифициране на нови подписи. Използвайте HMAC за директни (point-to-point) уебхукове и доверени вътрешни услуги; когато недоверени трети страни трябва да проверяват токени без права за подписване, използвайте асиметрични ключове (RS256, ES256, EdDSA) в JWT Генератор.
ЧЗВ

Често задавани въпроси и техническо ръководство за HMAC Генератор и Верификатор

Всичко, което трябва да знаете за използването на безплатния онлайн hmac генератор от Utiliome.

Защо проверката на HMAC за моя уебхук се проваля, въпреки че тайният ми ключ и JSON полетата изглеждат идентични?

Две причини предизвикват над 90% от разминаванията при HMAC на уебхукове. Първо, междинен софтуер (middleware) като express.json() в Express парсва и сериализира наново JSON данните, променяйки празните пространства, Unicode ескейпването или реда на ключовете спрямо суровия TCP байтов поток, който подателят е подписал — винаги подписвайте суровия непарснат буфер на заявката и включвайте префиксите за времеви печат на доставчика (като <timestamp>.<body> при Stripe или v0:<timestamp>:<body> при Slack). Второ, проверете дали тайната на доставчика трябва да бъде декодирана от Base64 или Hex до сурови байтове, вместо да се чете като UTF-8 низ.

Защо конструкцията SHA256(secret + message) е несигурна в сравнение с RFC 2104 HMAC-SHA256?

MD5, SHA-1, SHA-256 и SHA-512 използват конструкцията на Меркле-Дамгард, чийто краен дайджест разкрива пълното вътрешно състояние на компресия. При известни SHA256(secret || message) и байтовата дължина на secret, нападател може да изчисли SHA256(secret || message || padding || attacker_suffix), без изобщо да знае secret (атака чрез удължаване на дължината). RFC 2104 HMAC елиминира тази уязвимост, като подава вътрешния дайджест към втори външен хеш с ключ H((K_0 XOR opad) || inner_hash).

Какво се случва, ако моят таен ключ за HMAC е по-дълъг от 64 или 128 байта?

Според RFC 2104 Раздел 2, ако даден таен ключ строго надвишава вътрешния размер на блока на хеш функцията B (len(K) > 64 байта за MD5, SHA-1 и SHA-256; len(K) > 128 байта за SHA-384 и SHA-512), ключът първо се компресира чрез еднократно хеширане с H(K) до L байта и след това се допълва отдясно с байтове 0x00 до достигане на B байта. Както Web Crypto (crypto.subtle.importKey), така и съвместимите с RFC сървърни библиотеки изпълняват тази стъпка на предварително хеширане автоматично.

Кое изходно кодиране трябва да избера за GitHub, Stripe, Slack, Shopify и JWT HS256?

GitHub (X-Hub-Signature-256), Stripe (Stripe-Signature v1) и Slack (X-Slack-Signature v0) предават HMAC-SHA256 дайджести в Hex с малки букви след съответните си префикси sha256=, v1= или v0=. Shopify (X-Shopify-Hmac-Sha256) и AWS Signature v1/v2 използват стандартен Base64 с допълване. JSON Web Tokens (HS256, HS384, HS512) изискват Base64URL без допълване според RFC 7515 — вижте JWT Генератор за цялостно сглобяване на токени.

Компрометирани ли са HMAC-MD5 и HMAC-SHA1 от атаките за колизии при MD5 и SHA-1?

Не директно. Атаките за колизии срещу MD5 и SHA-1 без ключ разчитат на това нападателят свободно да избира блокове от съобщения спрямо публичен фиксиран вектор за инициализация (IV), докато HMAC маскира вътрешния IV зад тайни стъпки K_0 XOR ipad и K_0 XOR opad (документирано в IETF RFC 6151). Независимо от това, NIST SP 800-131A и основните доставчици на уебхукове (като GitHub, който прекрати поддръжката на X-Hub-Signature със SHA-1) обявяват HMAC-MD5 и остарелия HMAC-SHA1 за непрепоръчителни за нови системи — винаги избирайте HMAC-SHA256 или HMAC-SHA512, освен ако не поддържате обратна съвместимост със стари протоколи.