Check a webhook signature.
Paste a delivery, its three headers and your signing secret. The checker tells you whether the signature is valid and, when it is not, what is wrong. It runs in your browser, and nothing you enter is sent anywhere.
What the check found
Fill in the secret and the three headers and paste the body, or use the sample. The result appears here as you type.
What the check does.
The same three steps a server runs on every delivery, following the Standard Webhooks scheme. The webhook guide has the code for your language, and the request builder writes a call to the API.
Join three values
The delivery's webhook-id, its webhook-timestamp and the raw body, each separated by a full stop, in that order.
Sign them
HMAC-SHA256 with the key inside your secret: the base64 text after whsec_, decoded to bytes. The result is encoded as base64.
Compare every entry
The webhook-signature header holds one or two v1 entries. During a secret rotation both are present, and any one match is enough.
Questions, answered.
Is it safe to paste my signing secret here?
Nothing you enter leaves your browser. The check runs on the page with the browser's own cryptography, makes no request, stores nothing and puts nothing in the address. Use a secret from a test endpoint if you would rather not paste a live one anywhere.
Why does the check say the signature is right but the delivery is refused?
A receiving server also refuses a delivery whose timestamp is more than 5 minutes from its own clock, so a captured delivery cannot be replayed later. To check an old delivery, put the time it was sent in the clock field.
Why does a body that looks identical fail?
The signature covers the exact bytes, so a framework that parses and rewrites the JSON, an editor that adds a final line break or a proxy that changes line endings breaks it. The checker tries those changes after a failure and names the one that fits.
Which signatures does it check?
Entries that begin v1, which is what Eternify Ledger sends. An entry in another version is listed and left unchecked.
Build on your books.
Customers' administrators make API keys in the app. Book a demo if your company is not a customer yet.