Генератор и проверка 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.

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

Проверяет входящие заголовки MAC вебхуков или API против вычисленных подписей с помощью 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% локально в браузере (без загрузки на сервер) Загружает данные на внешние облачные серверы
Стоимость и регистрация 100% бесплатно навсегда без создания аккаунта Требует регистрации аккаунта или платной подписки
Как это работает

Генератор и проверка HMAC: как пользоваться за 3 простых шага

Установка программ не требуется. Все работает прямо в вашем веб-браузере.

1

Укажите точное тело сообщения

Вставьте необработанное тело HTTP-запроса или каноническую строку для подписи — сохраняя точные пробелы и порядок ключей — либо перетащите сохраненный файл с полезной нагрузкой.

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 (тестовый вектор 2 из IETF RFC 4231) по алгоритму HMAC-SHA256 дает 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 в Hex и W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= в Base64 при выборе режима ключа UTF-8, Hex (4a656665) или Base64 (SmVmZQ==).

Код аутентификации сообщений на основе хеш-функции с ключом (HMAC) подтверждает одновременно целостность данных (полезная нагрузка не была изменена при передаче) и подлинность (отправитель владеет общим секретным ключом). Чтобы воспроизвести подпись провайдера, необходимо точное совпадение трех параметров: базового хеш-примитива, декодированных сырых байтов секретного ключа и точной последовательности байтов подписываемой нагрузки.

Пример 1: Тестовый вектор 2 из IETF RFC 2104 / RFC 2202 / RFC 4231

Независимо от того, вводите ли вы 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 и подписанных ссылках) заменяет + на -, / на _ и опускает паддинг =. Подписание фразы 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 приводятся к блоку K_0 точной длины B байт:

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

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

Ошибки кодирования ключей и проверка за константное время

  • Hex-строка против сырых Hex-байтов: Если API выдает 64-символьный шестнадцатеричный секрет, например 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 Token с подписью HS256, HS384 или HS512.

Хотя бесключевые дайджесты, чистый HMAC и симметричные токены JSON Web Token опираются на одни и те же примитивы семейства 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, подпись JWT с алгоритмом HS256 представляет собой строго невыровненный вывод Base64URL от HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))). Вы можете проверить третий сегмент токена прямо здесь, вставив <base64url_header>.<base64url_payload> как сообщение и выбрав формат Base64URL, но для редактирования заголовков JSON, проверки меток времени exp/nbf и сборки полного трехчастного токена используйте Генератор JWT.
  • Симметричный HMAC против асимметричных подписей: Поскольку HMAC симметричен, любой сервис, который проверяет подпись, хранит тот же самый секрет, который позволяет создавать новые подписи. Используйте HMAC для прямых вебхуков (point-to-point) и доверенных внутренних сервисов; когда проверять токены должны внешние стороны без права подписи, используйте асимметричные ключи (RS256, ES256, EdDSA) в Генераторе JWT.
Частые вопросы

Частые вопросы и руководство: Генератор и проверка HMAC

Все, что нужно знать об использовании бесплатного онлайн-инструмента генератор hmac от Utiliome.

Почему проверка HMAC вебхука не проходит, хотя секретный ключ и поля JSON выглядят идентично?

Более 90% ошибок несовпадения HMAC в вебхуках вызваны двумя причинами. Во-первых, промежуточное ПО вроде express.json() в Express парсит и заново сериализует JSON, меняя пробелы, экранирование Unicode или порядок ключей по сравнению с сырым потоком байтов TCP, который подписал отправитель — всегда подписывайте необработанный буфер запроса (raw body) и не забывайте префиксы временных меток провайдера (например, <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 (атака удлинения сообщения / length-extension attack). Стандарт RFC 2104 HMAC устраняет эту уязвимость, передавая внутренний дайджест во второй внешний хеш с ключом: H((K_0 XOR opad) || inner_hash).

Что произойдет, если секретный ключ HMAC длиннее 64 или 128 байт?

Согласно разделу 2 RFC 2104, если длина секретного ключа строго превышает размер внутреннего блока хеш-функции 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 Token (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, отключивший SHA-1 в X-Hub-Signature) признали HMAC-MD5 и устаревший HMAC-SHA1 нерекомендуемыми для новых систем — всегда выбирайте HMAC-SHA256 или HMAC-SHA512, если не требуется поддержка старых протоколов.