Test webhook-signaturen lokalt NO

Kjør en trygg utviklerøvelse med syntetiske data før du kobler en mottaker til Kaduno.

Denne øvelsen kjører bare på din egen maskin med Node.js og innebygde moduler. Den åpner ingen server, kontakter ikke Kaduno og oppretter ikke abonnement, ordre eller betaling. Du trenger ikke API-nøkkel eller kundedata.

Målet er å forstå hva en gyldig signatur beviser: at de mottatte bytene stemmer med signaturen for den valgte hemmeligheten. Den beviser ikke at hendelsen er ny, at handlingen er autorisert i mottakersystemet eller at arbeidet bare er utført én gang.

1. Lag en lokal testfil

Lagre koden under som webhook-signature.test.mjs. Den faste hemmeligheten er kun testdata; ikke bruk den i et virkelig abonnement. Eksemplet følger Kadunos HMAC-SHA256-format med sha256= foran hex-verdien.

import { createHmac, timingSafeEqual } from 'node:crypto';
import assert from 'node:assert/strict';
import test from 'node:test';
 
function verifyWebhook(rawBody, signature, secret) {
  if (!Buffer.isBuffer(rawBody) || typeof signature !== 'string' || !secret) {
    return false;
  }
  const expected = Buffer.from(
    'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex'),
  );
  const received = Buffer.from(signature);
  return expected.length === received.length && timingSafeEqual(expected, received);
}
 
const secret = 'LOCAL_TEST_ONLY_NOT_A_PRODUCTION_SECRET';
const rawBody = Buffer.from('{"event":"order.placed","deliveryId":"local-example-1","payload":{"id":"synthetic-order"}}');
const signature = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
 
test('godtar original kropp med riktig signatur', () => {
  assert.equal(verifyWebhook(rawBody, signature, secret), true);
});
 
test('avviser endrede data', () => {
  const changed = Buffer.from(rawBody.toString().replace('synthetic-order', 'changed-order'));
  assert.equal(verifyWebhook(changed, signature, secret), false);
});
 
test('avviser ny serialisering selv om JSON-innholdet er likt', () => {
  const reformatted = Buffer.from(JSON.stringify(JSON.parse(rawBody), null, 2));
  assert.equal(verifyWebhook(reformatted, signature, secret), false);
});
 
test('avviser manglende signatur, feil lengde og feil hemmelighet', () => {
  assert.equal(verifyWebhook(rawBody, undefined, secret), false);
  assert.equal(verifyWebhook(rawBody, 'sha256=short', secret), false);
  assert.equal(verifyWebhook(rawBody, signature, 'wrong-secret'), false);
});
 
test('en gjentatt levering har fortsatt gyldig signatur', () => {
  assert.equal(verifyWebhook(rawBody, signature, secret), true);
  assert.equal(verifyWebhook(rawBody, signature, secret), true);
});

2. Kjør uten nettverkstilgang til butikken

Bruk en støttet Node.js-versjon med innebygd testløper. Ingen pakker skal installeres.

node --test webhook-signature.test.mjs

Forvent fem beståtte tester og ingen feilede tester. Oppsummeringens utseende kan variere mellom Node.js-versjoner. Hvis en test feiler, kontroller filen og råkroppshåndteringen før du går videre; ikke slå av signaturkontrollen.

3. Forstå det testen ikke gjør

Den siste testen viser med vilje at samme melding godtas to ganger av signaturkontrollen. En gyldig signatur er ikke beskyttelse mot gjentakelse. Bruk leverings-ID som unik nøkkel i varig lagring, og registrer mottak og planlagt arbeid atomisk. En lokal Set i minnet er ikke nok ved omstart eller flere prosesser.

Denne øvelsen tester ikke en HTTP-server, HTTPS, råkroppshåndtering i ditt rammeverk, kølagring, feilsituasjoner eller faktisk levering fra Kaduno. Den oppretter heller ikke et sikkert produksjonsendepunkt.

4. Avtal en kontrollert integrasjonstest

Når dere har en mottaker, avtal testbutikk, hemmelighet og hvilke utgående handlinger som er tillatt. Kontroller feil signatur, gjentatt og samtidig levering, omstart etter mottak, uventet hendelsestype og at arbeid ikke utføres for feil butikk. Ikke bruk virkelige kundebetalinger eller ordre for å prøve eksemplet.

Følg bygg en webhook-mottaker for abonnement, leveringslogg og nye forsøk. Bruk API-guiden for avgrenset API-tilgang. Oppbevar den virkelige hemmeligheten i mottakerens sikre konfigurasjon, ikke i kode, skjermbilder eller supportsaker.