Перейти к содержанию

HMAC: проверка целостности с общим секретом

HMAC — механизм проверки целостности и подлинности сообщения для сторон, которые заранее разделяют секретный ключ. Он вычисляет код аутентификации с использованием ключа и криптографической хеш-функции. Получатель повторяет расчёт и сравнивает значения. HMAC не шифрует сообщение, а любой участник, знающий общий секрет, может создать корректный код — поэтому механизм не доказывает уникальное авторство одной стороны.

ОБУЧЕНИЕ

Из каких частей состоит HMAC

В HMAC используются три компонента: хеш-функция, например SHA-256; сообщение; общий секретный ключ. RFC 2104 задаёт стандартизированную конструкцию, в которой ключ комбинируется с внутренними и внешними константами вокруг двух вызовов хеш-функции. Эта структура нужна для безопасного построения MAC на базе хешей, а не для простого соединения строки ключа с сообщением.

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

HMAC — это keyed Message Authentication Code. Обычный хеш не использует секрет, поэтому любой человек может вычислить его для изменённого сообщения. HMAC вводит секретную часть, которая позволяет получателю обнаружить подмену, если ключ остался неизвестен атакующему. Но сам ключ нужно безопасно распределить и хранить; если его копию получит злоумышленник, он сможет выпускать собственные допустимые MAC.

Практический пример: webhook

Платёжная или торговая платформа отправляет приложению webhook о новом событии. В заголовок добавляется подпись, вычисленная с использованием заранее согласованного секрета и тела запроса. Сервер приложения получает исходные байты тела, рассчитывает ожидаемый HMAC и сравнивает его с пришедшим значением. Совпадение говорит, что запрос сформирован кем-то, кто знает общий секрет, и содержимое с высокой практической уверенностью не менялось после подписания.

Проверку нужно выполнять до разбора тела, если формат спецификации подписывает именно исходные байты. Если приложение сначала преобразует JSON, удаляет пробелы, меняет порядок полей или кодирует символы по-другому, оно может получить другой MAC. Для предотвращения повторной отправки подпись часто связывают с временной меткой или уникальным идентификатором события; приложение проверяет допустимость времени и сохраняет уже обработанные идентификаторы. Эти параметры устанавливает провайдер webhook.

Тестовый разработчик может использовать HMAC-утилиту для повторного вычисления подписи, чтобы выяснить, совпадает ли секрет и формат. Но производственный секрет не следует вставлять в стороннюю веб-страницу без понимания её модели обработки. Даже если инструмент заявляет локальный расчёт, для важного секрета предпочтительнее выполнить тест в контролируемом окружении и использовать библиотеку поставщика API.

HMAC, цифровая подпись и шифрование

HMAC предоставляет целостность и аутентификацию между участниками с общим ключом. Любая сторона с секретом может сформировать подпись, поэтому наблюдатель не может определить, кто именно создал сообщение. Цифровая подпись использует пару ключей: приватный ключ создаёт подпись, а открытый — проверяет. При корректной связи открытого ключа с владельцем она может дать более сильное основание связать действие с конкретным ключом.

Ни HMAC, ни цифровая подпись сами по себе не скрывают содержимое. Если нужен секретный канал, применяют шифрование. HMAC можно использовать вместе с шифрованием в определённых протоколах, однако следует предпочитать современные стандартизированные схемы с аутентифицированным шифрованием и не собирать вручную набор примитивов без профильной необходимости.

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

Ключи, форматы и защита от повторов

Секрет для HMAC должен быть сгенерирован случайно и передан каналом, который не раскрывает его посторонним. Не используйте в качестве ключа имя проекта, пароль из общего аккаунта или публичный API-токен. Стороны должны уметь безопасно менять секрет, отозвать старое значение и на короткое время при необходимости поддерживать несколько ключей для плавной ротации.

Сравнивать HMAC лучше функцией сравнения с постоянным временем выполнения, предоставляемой криптобиблиотекой, чтобы уменьшить утечки через длительность операции. Следует также ограничивать количество запросов, проверять размер тела и отделять секреты разных интеграций. Если один ключ используется многими приложениями и партнёрами, утечка в одном месте расширяет масштаб атаки.

Код аутентификации не предотвращает повторное воспроизведение ранее корректного запроса. Атакующий, который скопировал валидное тело и MAC, может отправить его снова, если приложение не проверяет свежесть и уникальность события. Для этого формат может включать время, nonce или идентификатор, а сервер — отслеживать уже обработанные значения. Детали и сроки хранения должны соответствовать протоколу интеграции.

При ротации ключа API может на короткий срок использовать две версии, пока стороны завершают обновление. Но если старый ключ утёк, окно совместимости расширяет возможность злоупотребления. Каждому партнёру и окружению полезно дать отдельный секрет: тестовый ключ не должен открывать доступ к производственным webhook. Регистрируйте смену идентификатора ключа, но не записывайте сами секреты или полные значения MAC в журналы без необходимости.

MAC иногда передаётся в hex или Base64URL. Представление не меняет криптографическую силу, однако стороны должны согласовать точное кодирование, регистр букв и длину вывода. Сравнение только части значения или принятие пустой подписи создаёт обход. Проверка должна завершаться отказом, если алгоритм, версия заголовка или идентификатор ключа неизвестны, а сообщение об ошибке не должно раскрывать, какие отдельные байты совпали.

Логи можно сохранять с идентификатором события, результатом проверки и временем получения. Сами ключи, входное тело и значения подписи следует обрабатывать согласно политике минимизации данных: они могут содержать личную информацию или материал для повторного воспроизведения. В диагностике лучше использовать тестовую среду с вымышленным секретом и отдельными webhook-адресами.

Ограничения и вывод

HMAC не защищает секретный ключ от утечки, не обеспечивает конфиденциальность и не доказывает юридическое авторство одного из участников. Слабая хеш-функция, некорректная сериализация, сравнение с утечкой времени или повторная обработка событий могут свести пользу на нет. Используйте документированную схему конкретного API и криптографические библиотеки.

Вывод. HMAC добавляет проверку подлинности к хешированию за счёт общего секрета. Он удобен для API и webhook, когда обе стороны управляют ключом. Надёжность зависит от генерации, доставки, хранения и ротации ключа, а также от точного совпадения формата сообщения.

Источники проверены: 21.11.2026.

Читать дальше

Источники

  1. RFC 2104: HMAC — Keyed-Hashing for Message Authenticationrfc-editor.org
  2. NIST CSRC: MAC и криптографические стандартыcsrc.nist.gov
  3. NIST: обзор цифровых подписей и хеш-функцийnist.gov

Материал был полезен?

Обучение
Обучение

Как проверять криптоинформацию по первоисточникам

Криптоинформация быстро распространяется через чаты, видео и социальные сети. Чтобы отделить факт от рекламы и предположения, полезно проследить заявление до первичного документа, независимо сверить данные и записать, на какую дату они были верны.

6 мин

Обучение

Постквантовая криптография: зачем готовить сети заранее

Постквантовая криптография (PQC) разрабатывает алгоритмы, которые должны противостоять будущим квантовым компьютерам и обычным вычислителям. Это долгосрочная задача для систем, защищённых современными цифровыми подписями и обменом ключами, включая криптокошельки, инфраструктуру узлов, веб-сервисы и архивы данных.

6 мин

Обучение

Открытый код и bug bounty: как устроено внешнее тестирование

Открытый исходный код позволяет людям изучать устройство программы, а bug bounty предлагает вознаграждение за найденные уязвимости в определённой системе. Оба механизма могут расширить внешнюю проверку, но сам факт доступности кода или наличие программы не доказывают, что каждый компонент проверен.

5 мин