• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

API и интеграция

HMAC-подпись вебхуков

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

Любой, кто узнает URL вашего вебхука, может отправить на него запрос, поэтому именно подпись отличает события шлюза от подделок. HMAC, определённый в RFC 2104, объединяет секретный ключ с хеш-функцией — здесь это SHA-256 — и даёт код, который могут вычислить только обладатели секрета. Шлюз подписывает каждое событие секретом эндпоинта; ваш обработчик заново вычисляет код по тем же байтам и принимает событие, только если значения совпадают. Подпись подтверждает источник и целостность. Содержимое она не скрывает — это задача HTTPS.

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

Пример

Допустим, злоумышленник перехватывает подлинное событие message.failed и через час отправляет его повторно, заменив статус на delivered. Изменённое тело больше не соответствует подписи. Если же отправить событие без изменений, его временная метка окажется часовой давности и не пройдёт проверку на допустимое отклонение. В обоих случаях обработчик его отклоняет.

Типичные ошибки

  • Проверять заново сериализованное тело: разбор и повторное кодирование JSON меняют пробелы и порядок ключей, поэтому код никогда не совпадёт. Разбирайте JSON после проверки.
  • Использовать ключ API вместо секрета подписи эндпоинта.
  • Сравнивать подписи обычным сравнением строк.
  • Отклонять события во время ротации секрета: пока действуют оба секрета, проверяйте по обоим.

В SMSMeteor: заголовок X-Meteor-Signature имеет вид t=…,v1=…, где v1 — шестнадцатеричный HMAC-SHA256 от временной метки, точки и необработанного тела, вычисленный с секретом эндпоинта; X-Meteor-Timestamp содержит временную метку в секундах Unix. Разумное допустимое отклонение — пять минут. Секреты ротируются из панели, причём старый и новый 24 часа действуют одновременно. Повторно отправленные события получают новые временную метку и подпись, а вебхуки тестовых ключей подписываются так же, как рабочие. Подробности — в документации по вебхукам и на странице безопасности.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку