Hoppa till huvudinnehåll

Webhooks för statusuppdateringar

Ta emot signerade slutmeddelanden från ERP eCoC-flödet när ett jobb blir registrerat eller misslyckas.

Skrivet av Anton Hjalmarsson

Konfigurera webhook

  1. Öppna Företag → Integrationer → ERP-integration.

  2. Välj CertiDrive skickar besked (webhook).

  3. Ange en publik HTTPS-adress.

  4. Kopiera webhook-hemligheten till mottagarens hemlighetshantering.

  5. Välj Spara.

CertiDrive skickar ett JSON-objekt med eventet ecoc_registration.registered, ecoc_registration.action_required, ecoc_registration.rejected eller ecoc_registration.technical_failure och jobbets statusdata.

Verifiera signaturen

  1. Läs rå request body utan att serialisera om den.

  2. Läs headern x-certidrive-timestamp.

  3. Bygg strängen <timestamp>.<rå body>.

  4. Beräkna HMAC-SHA256 med webhook-hemligheten.

  5. Jämför i konstant tid med hexvärdet efter sha256= i x-certidrive-signature.

  6. Avvisa ett gammalt timestamp för att minska risken för replay.

  7. Svara med HTTP 2xx först när eventet lagrats idempotent.

Leverans och återförsök

Webhooken skickas när kedjan stoppar: registered, action_required, rejected eller technical_failure. Ett misslyckat leveransförsök kan återförsökas av bakgrundssynkningen, högst tio försök totalt. Mottagaren bör tåla dubbletter och använda job_id plus eventnamn som idempotensnyckel.

Viktigt att veta

Den aktuella webhookfunktionen gäller ERP eCoC-jobb. Det finns ingen generell webhook för alla ändringar i det publika registrerings-API:t.

Om hemligheten byts med Ny hemlighet måste mottagaren uppdateras innan den nya konfigurationen tas i bruk.

Vanliga problem

Ingen webhook kommer
Kontrollera att integrationen är aktiv, leveransläget är webhook, adressen börjar med HTTPS och jobbet har en slutstatus.

Signaturen matchar inte
Använd exakt rå body och headerns timestamp; bygg inte HMAC från ett omformaterat JSON-objekt.

Fick du svar på din fråga?