Webhook: podpis HMAC nie pasuje, mimo że sekret jest poprawny
Poradnik techniczny · Kacper Bernecki
Endpoint odrzuca prawdziwe webhooki z invalid signature, a testowy JSON w konsoli działa. Podpis jest liczony z surowego body, które może różnić się od JSON ponownie zserializowanego przez parser.
Jak ustalić źródło błędu
Sprawdź dokładne bajty wejściowe żądania i dokumentację podpisu konkretnego dostawcy.
Zweryfikuj nagłówek podpisu, timestamp oraz czy system nie modyfikuje treści przed weryfikacją.
Co zrobić krok po kroku
1. Weryfikuj HMAC na surowym body przed JSON.parse, porównując podpisy w stałym czasie.
2. Dodaj ochronę przed replay przez ograniczenie wieku timestamp i idempotentny identyfikator zdarzenia.
Jak sprawdzić wynik
Prawdziwe zdarzenie z poprawnym podpisem jest akceptowane, a zmienione body i stary timestamp są odrzucane.
Czego nie robić
Nie wyłączaj podpisu webhooka na produkcji tylko po to, by przepuścić zdarzenia.