Проверка подписи вебхука
Составьте строку t.body из заголовка X-CalcLib-Signature, вычислите HMAC-SHA256 с вашим секретом и сравните результат, прежде чем обрабатывать доставку.
Конечная точка вебхука, добавленная в разделе Вебхуки, получает подписанный POST-запрос каждый раз, когда кто-то запускает ваш встраиваемый калькулятор. В каждой доставке есть заголовок X-CalcLib-Signature вида t=<unix time>,v1=<signature>.
Проверяйте до разбора
- Прочитайте необработанное тело запроса. Если разобрать JSON и сериализовать его заново, байты изменятся, и подпись никогда не совпадёт.
- Возьмите
tиз заголовка и составьте строкуt.body: метка времени, точка, затем необработанное тело. - Вычислите HMAC-SHA256 этой строки с секретом вашей конечной точки в шестнадцатеричном виде.
- Сравните результат с каждым значением
v1за постоянное время. Пока вы меняете секрет, в заголовке могут быть два значенияv1; совпасть может любое из них. - Отклоняйте доставку, если
tотличается от времени на ваших часах более чем на 5 минут.
Доставки с ошибкой
Мы повторяем их через 1 минуту, 5 минут, 30 минут, 2 часа и 8 часов. Конечная точка, которая выдаёт ошибку 20 раз подряд, отключается, и мы отправляем вам письмо — оно подчиняется переключателю для продуктовых писем в разделе Уведомления.