Интеграция по вебхуку
Когда срабатывает вебхук
При каждом событии, к которому привязан канал-вебхук: монитор перешёл в состояние down, восстановился, SSL-сертификат вошёл в окно предупреждения, либо heartbeat-проверка стала просроченной или восстановилась. Каждый запрос — это один JSON-объект в теле POST-запроса, описывающий ровно одно событие.
Проверка подписи
Каждый запрос содержит заголовок X-Dumza-Signature — hex-дайджест HMAC-SHA256 от исходного тела запроса, подписанный собственным секретом канала (виден один раз при создании канала, и снова — при каждой регенерации). Пересчитайте тот же HMAC по точно тем же байтам, которые вы получили, и сравните результат со значением заголовка, чтобы убедиться, что запрос действительно пришёл от Dumza и не был изменён при передаче.
Регенерация секрета
Если секрет вебхука когда-либо утечёт, регенерируйте его в настройках канала — URL и сам канал продолжат работать, изменится только ключ подписи, поэтому одновременно обновите способ проверки подписи на своей стороне.