HMAC генератор

Как да изчислите HMAC

1. Поставете Съобщение. За webhook това трябва да е суровото тяло на заявката, байт по байт.
2. Въведете Таен ключ и изберете Формат на ключа: Текст (UTF-8), Шестнадесетичен или Base64.
3. Изберете Алгоритъм: HMAC-SHA1, HMAC-SHA256, HMAC-SHA384 или HMAC-SHA512.
4. Резултатът се обновява, докато пишете; можете да щракнете и Генерирай HMAC. Получавате HMAC (hex), HMAC (Base64) и Заглавие с подпис за webhook (в стил GitHub), всяко с бутон Копирай.
5. За да проверите получен подпис, поставете го в Сравни с очакван подпис (hex, Base64 или sha256=…). Инструментът казва дали съвпада.

Съобщението се кодира като UTF-8 точно както е въведено, включително интервалите и новите редове. Изчислението използва Web Crypto API на браузъра ви; съобщението и ключът никога не напускат устройството ви.

Какво е HMAC

HMAC (hash-based message authentication code, RFC 2104) съчетава таен ключ с хеш функция:

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

където K′ е ключът, допълнен до размера на блока на хеша (първо се хешира, ако е по-дълъг), а ipad/opad са фиксирани константи. Само който знае ключа, може да създаде правилния код за дадено съобщение, а всяка промяна в съобщението променя изцяло кода. Затова HMAC подписват webhook заявки, API заявки (например AWS Signature Version 4) и JSON Web Token с HS256.

HMAC не е шифроване: съобщението не се скрива. Не е и хеш на парола; за съхранение на пароли използвайте бавна функция като bcrypt или Argon2.

Дължината на изхода зависи от алгоритъма: 20 байта за SHA-1, 32 за SHA-256, 48 за SHA-384 и 64 за SHA-512. HMAC-SHA1 все още се смята за сигурен като MAC, но за нови системи предпочитайте SHA-256. Препоръчва се случаен ключ, поне толкова дълъг, колкото изхода (32 байта за HMAC-SHA256); ключовете в hex или Base64 ви позволяват да въвеждате директно такива случайни байтове.

Проверка на webhook от GitHub

GitHub подписва всяко доставяне с тайната на вашия webhook и изпраща резултата в заглавието X-Hub-Signature-256 като sha256=, следвано от hex HMAC-SHA256 на тялото. Примерът от документацията на GitHub използва тайната It's a Secret to Everybody и тялото Hello, World!; въведете ги тук с HMAC-SHA256 и заглавието показва:

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

Полето за сравнение приема целия ред на заглавието, стойността sha256=… или гол подпис в hex или Base64 (Stripe, Shopify и Slack използват подобни схеми със свои заглавия и подписвани низове). За SHA-384 и SHA-512 инструментът показва общо заглавие X-Signature, тъй като няма общ стандарт.

Сравнение за постоянно време

Сървър, който сравнява подписи с обикновено сравнение на низове, спира при първия различен символ. Като измерва времената на отговор, атакуващият може да налучка валиден подпис символ по символ. Сравнението в този инструмент проверява всеки байт, каквото и да е резултатът, както трябва да прави сървърът с crypto.timingSafeEqual в Node.js, hmac.compare_digest в Python или hash_equals в PHP.