Kategoria: Formularze i API

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.