Безопасность webhook: подпись, повторная доставка и порядок событий
Как проверять подлинность webhook по исходному телу, ограничивать replay и безопасно обрабатывать дубли и события вне порядка.
Коротко о главном
- Чем опасно
- Поддельное изменение статуса заказа или подписки.
- С чего начать защиту
- Проверяйте подпись официальной библиотекой по исходным байтам и защищайте секрет.
- Как подтвердить
- Нужны ручной аудит и проверка реализации. Отсутствие находок во внешнем скане не подтверждает безопасность.
В этой статье
- Продукт
- Веб-приложения
- Оценка риска
- Уровень зависит от конфигурации
Как проверить и что учитывать
Нужна ручная проверка
Для подтверждения нужны анализ реализации и проверки на согласованном тестовом контуре. Публикация не означает автоматическое обнаружение этого сценария FindRisk. Не делайте вывод о наличии уязвимости только по одному внешнему признаку: подтвердите результат в настройках и версии компонента.
Что нужно для подтверждения
В sandbox проверьте корректную подпись, изменённое тело, дубликат и нарушенный порядок. Легитимные повторы должны подтверждаться без повторного эффекта, а неверные подписи — отклоняться до обработки.
Ограничения вывода
- Внешний ответ не раскрывает все роли, обработчики и настройки внутренних компонентов.
- Используйте только свои системы или письменное разрешение владельца; нагрузочные проверки согласуйте отдельно.
Что это за уязвимость
Публичный endpoint получает события извне и должен отличать провайдера от произвольного клиента. Подпись подтверждает сообщение в рамках выбранного протокола, но не отменяет проверку его бизнес-смысла.
Когда возникает риск
Повторная доставка легитимна, события могут идти вне порядка. Разбор и пересериализация JSON до проверки способны изменить подписанные байты; формат и допустимый возраст задаёт конкретный провайдер.
Возможные последствия
Как проверять подлинность webhook по исходному телу, ограничивать replay и безопасно обрабатывать дубли и события вне порядка.
- Поддельное изменение статуса заказа или подписки.
- Повторный побочный эффект при повторной доставке настоящего события.
Как защитить приложение
Исправляйте причину в обработчике, а не только внешний симптом.
- Проверяйте подпись официальной библиотекой по исходным байтам и защищайте секрет.
- Проверяйте временные условия протокола и дедуплицируйте события по идентификатору.
- Сопоставляйте объект, допустимый переход состояния и актуальные данные; обрабатывайте события через надёжную очередь.
Как безопасно проверить исправление
В sandbox проверьте корректную подпись, изменённое тело, дубликат и нарушенный порядок. Легитимные повторы должны подтверждаться без повторного эффекта, а неверные подписи — отклоняться до обработки.
Оценка риска и границы сканирования
Средний уровень — ориентировочная редакционная оценка, не CVSS подтверждённой находки. Для конкретной системы приоритет зависит от доступных данных, полномочий и компенсирующих мер; последствия могут быть значительно серьёзнее.
Отсутствие находки во внешнем скане не доказывает безопасность реализации. Проверяйте сценарии после входа, альтернативные маршруты и внутренние сервисы.
Как проходит проверка
Для подтверждения нужны анализ реализации и проверки на согласованном тестовом контуре. Публикация не означает автоматическое обнаружение этого сценария FindRisk. Автоматический результат показывает внешний признак риска и требует проверки специалистом с учётом конкретной конфигурации.
Проверить другие внешние рискиЧто делать после обнаружения
- Зафиксируйте затронутый сценарий и сохраните журналы без токенов и персональных данных.
- Ограничьте проблемный обработчик, оцените доступные данные и назначьте владельца исправления.
- Устраните первопричину и добавьте регрессионную проверку на тестовых данных.
Частые вопросы
Что означает риск «Безопасность webhook»?
Как проверять подлинность webhook по исходному телу, ограничивать replay и безопасно обрабатывать дубли и события вне порядка.
Можно ли подтвердить проблему только внешней проверкой?
Для подтверждения нужны анализ реализации и проверки на согласованном тестовом контуре. Публикация не означает автоматическое обнаружение этого сценария FindRisk. Итог нужно сопоставить с конфигурацией, версиями и правами доступа на вашем сайте.
Что сделать в первую очередь?
Проверяйте подпись официальной библиотекой по исходным байтам и защищайте секрет.