{"canonical_url":"https://engineer.company/da/glossary/webhook/","content_markdown":"# webhook\n\n## Hvad det er\n\nEn webhook er en HTTP-forespørgsel, som én tjeneste sender til en anden i det\nøjeblik, noget sker hos den: en betaling går igennem, en faktura bliver betalt,\nen lang opgave bliver færdig. Den modtagende side registrerer på forhånd en URL,\nog afsenderen sender en beskrivelse af hver hændelse dertil med POST. Standard\nWebhooks-specifikationen kalder webhooks »a common name for HTTP callbacks« og\nbeskriver dem som en måde, hvorpå tjenester kan underrette hinanden om\nhændelser. Ordet skrives af og til i to ord, web hook, men Stripe, GitHub og\nspecifikationen skriver det alle i ét ord.\n\nSpecifikationen beskriver også en webhook som en del af en tjenestes API, en\nslags API, der kører baglæns. Normalt kalder klienten tjenesten, når den vil\nhave noget. Med en webhook kalder tjenesten klienten, når den har nyt. I en typisk API-integration kører begge sider en HTTP-server, den ene til at\nmodtage API-kald og den anden til at modtage webhooks. En tjeneste kan også\nsende webhooks uden selv at tilbyde et forespørgsels-API.\nSpecifikationen kalder afsenderen producer og modtageren consumer, og den URL,\nmodtageren registrerer, er dens webhook-endpoint.\n\nSpecifikationen anbefaler en HTTP POST med en JSON-brødtekst, men kræver ikke\net bestemt format eller en bestemt struktur for payloaden. Den foreslåede\nbrødtekst har en `type`, skrevet med punktummer og ordnet hierarkisk, for\neksempel `invoice.paid`; et `timestamp` for, hvornår hændelsen fandt sted, i\nISO 8601; og hændelsens data enten under `data` eller på øverste niveau.\nYderligere metadata kan stå begge steder. Leveringsmetadata ligger i headere:\n`webhook-id` identificerer hændelsen, `webhook-timestamp` angiver, hvornår netop\ndette forsøg blev foretaget, i Unix-sekunder, og `webhook-signature` bekræfter\ndets ægthed. Stripe og GitHub bruger deres egne headernavne, blandt andre\n`Stripe-Signature` og `X-Hub-Signature-256`, og deres verificeringsregler er\nforskellige: Stripe signerer et forsøgstidsstempel sammen med brødteksten, mens\nGitHubs HMAC kun dækker brødteksten.\n\nEn payload kan være fuld og indeholde hele det ændrede objekt, eller tynd og\nindeholde ikke stort andet end en identifikator, så modtageren selv må hente\nresten gennem API'et. Specifikationen vejer de to op mod hinanden. En fuld\npayload sparer modtageren for ekstra kald til API'et. En tynd payload betyder\nfærre data at generere og sende, mere fleksibilitet og mere plads til ændringer\nsenere, fordi en tynd payload altid kan vokse til en fuld, men ikke omvendt. Den\ngør også dataadgangen sporbar, fordi modtageren udtrykkeligt skal bede om det,\nden læser. Uanset hvad råder specifikationen til at holde payloads små, normalt\nunder 20 kB. Stripe tilbyder et tyndt format og markerer det som det anbefalede.\n\n## Hvorfor det betyder noget\n\nUden webhooks må et system, der skal vide besked om en ændring et andet sted,\npolle: spørge igen og igen, for det meste bare for at høre, at intet er sket, og\nalligevel først opdage ændringen ved næste runde. En webhook vender det om. Den\ntjeneste, der kender til hændelsen, kalder én gang, i det øjeblik den sker.\nSådan melder betalingsudbydere, kodehostingtjenester og e-mailudbydere tilbage\ntil de systemer, der er bygget oven på dem.\n\nDen omvendte retning har en pris, og det meste af den betales af den modtagende\nende. Dens endpoint er en offentlig URL, som alle på internettet kan sende en\nPOST til, og intet ved en indgående forespørgsel viser, hvem der har sendt den,\nså specifikationen gør verificering af ægthed til et krav for enhver sikker\nimplementering. Leveringen prøves igen, indtil modtageren svarer med en\n2xx-status, eller leveringspolitikken stopper yderligere forsøg, så den samme hændelse kan ankomme mere end én gang; Stripe advarer\nom, at endpoints af og til kan modtage dubletter. Rækkefølgen er heller ikke\nlovet: Stripe skriver ligeud, at den ikke garanterer, at hændelser ankommer i\nden rækkefølge, de blev skabt i.\n\nAfsenderen må på sin side blive ved med at prøve. Specifikationen anbefaler en\ntidsplan for nye forsøg, der strækker sig over flere dage, med eksponentiel\nbackoff og lidt tilfældig jitter. I dens eksempel gøres der ti forsøg, det\nsidste 75 timer, 35 minutter og 5 sekunder efter det første. Stripe prøver igen\ni op til tre dage i live mode. En modtager, der kommer tilbage inden for det\nvindue, indhenter selv det forsømte; derefter kan man hos Stripe sende en\nhændelse igen manuelt i op til 15 dage efter, at den blev oprettet, eller i op\ntil 30 dage med Stripes CLI. Når leveringen bliver ved med at fejle i lang tid,\nanbefaler specifikationen, at afsenderen giver modtageren besked ad en anden\nkanal, for eksempel e-mail, og deaktiverer endpointet.\n\n## Sådan ser det ud i praksis\n\nHer er headerne på en levering i specifikationens format. Identifikatoren,\ntidsstemplet og signaturen er de eksempelværdier, specifikationen selv bruger;\nværdien af `Host` og stien er opdigtede:\n\n```http\nPOST /webhooks/billing HTTP/1.1\nHost: example.com\nContent-Type: application/json\nwebhook-id: msg_2KWPBgLlAfxdpx2AI54pPJ85f4W\nwebhook-timestamp: 1674087231\nwebhook-signature: v1,K5oZfzN95Z9UVu1EsfQmfVNQhnkZ2pj9o9NDN/H/pI4=\n```\n\nOg her er brødteksten, en tynd payload fra samme specifikation, her vist med\nindrykning. Når den faktisk sendes, anbefaler specifikationen, at den er\nminificeret:\n\n```json\n{\n  \"type\": \"contact.created\",\n  \"timestamp\": \"2022-11-03T20:26:10.344522Z\",\n  \"data\": {\n    \"id\": \"1f81eb52-5198-4599-803e-771906343485\"\n  }\n}\n```\n\nPræfikset `v1` markerer en symmetrisk signatur: HMAC-SHA256 over hændelsens\nidentifikator, tidsstemplet og brødteksten, sat sammen med punktummer og\nberegnet med en hemmelig nøgle, der er unik for endpointet. Fordi\nidentifikatoren og tidsstemplet signeres sammen med brødteksten, kan ingen af\ndem ændres, uden at signaturen bliver ugyldig. Specifikationen tillader også\nasymmetriske ed25519-signaturer, markeret `v1a`, og anbefaler dem, når man ikke\nselv kontrollerer sikkerheden på både afsender- og modtagersiden.\n\nGitHub signerer også sine leveringer med HMAC-SHA256, lægger hex-digesten i\n`X-Hub-Signature-256` med præfikset `sha256=` og offentliggør en hemmelighed, en\npayload og en signatur, som man kan afprøve en verifikator mod. Her er en\nverifikator i Python, afprøvet mod netop det eksempel:\n\n```python\nimport hashlib\nimport hmac\n\n\ndef verify(body: bytes, secret: str, header: str) -\u003e bool:\n    mac = hmac.new(secret.encode(\"utf-8\"), body, hashlib.sha256)\n    expected = \"sha256=\" + mac.hexdigest()\n    return hmac.compare_digest(expected, header)\n\n\nsecret = \"It's a Secret to Everybody\"\nheader = (\n    \"sha256=757107ea0eb2509fc211221cce984b8a\"\n    \"37570b6d7586c22c46f4379c8b043e17\"\n)\nprint(verify(b\"Hello, World!\", secret, header))  # True\nprint(verify(b\"Hello, World! \", secret, header))  # False\n```\n\nÉt enkelt mellemrum til sidst i brødteksten er nok til at få verificeringen til\nat fejle. `hmac.compare_digest` bruger den samme tid, uanset om strengene\nafviger tidligt eller sent; GitHubs dokumentation siger, at man aldrig må\nsammenligne signaturer med et almindeligt `==`. En solid handler arbejder\nderefter i en fast rækkefølge: læs de rå bytes, verificér signaturen over præcis\nde bytes, kontrollér, at forsøgstidsstemplet er tilstrækkeligt nyt, hvis\nafsenderen signerer et, kontrollér, om\nhændelsens identifikator er set før, læg hændelsen i en kø, og svar med en 2xx.\nDet egentlige arbejde sker bagefter. Stripe nævner som eksempel at svare med\n200, før en kundes faktura markeres som betalt i regnskabssystemet.\n\nTo projekter i sitets portefølje beskæftiger sig med webhooks fra den modtagende\nende. I projektet om\n[adgangsret via Stripe og in‑app‑køb](/da/portfolio/built-stripe-and-in-app-purchase-entitlements/)\nskal et abonnement blandt andet kunne overleve en webhook, der ankommer to\ngange, og en webhook, der ankommer i forkert rækkefølge. I\n[e‑mailsystemet med failover og leveringslog](/da/portfolio/built-email-with-failover-and-delivery-logging/)\nmelder indgående webhooks tilbage, hvad hver udbyder gjorde med en besked, og\nprojektet registrerer både det, der blev sendt, og det, der kom tilbage, i en\nafsendelseslog og en tabel over leveringshændelser.\n\n## Hvor det går galt\n\n**Signaturen passer aldrig.** En almindelig årsag er, at modtagerens framework\nparser JSON-brødteksten, og at koden serialiserer den igen, før HMAC'en\nberegnes. Specifikationen kalder det en meget almindelig fejl:\nJSON-serialisering er forskellig fra implementering til implementering, og et\nenkelt overflødigt mellemrum gør signaturen ugyldig. Stripe skal have den rå\nbrødtekst af samme grund og advarer om, at enhver ændring af den får\nverificeringen til at fejle. GitHub tilføjer, at en proxy eller load balancer\nforan endpointet ikke må ændre payloaden eller headerne, og at payloaden bør\nhåndteres som UTF-8. Beregn signaturen over de bytes, præcis som de ankom, før\nnoget parser dem.\n\n**Den samme hændelse ankommer to gange.** Nye forsøg og netværksproblemer giver\nbegge dubletter. Ifølge specifikationen er `webhook-id` den samme ved hvert nyt\nforsøg med en hændelse og fungerer som idempotensnøgle; dens eksempel er at\ngemme identifikatorerne i Redis i fem minutter. Stripe beder dig registrere de\nhændelses-id'er, du har behandlet, og springe dem over, du allerede har set.\nStripe bemærker også, at der i nogle tilfælde oprettes og sendes to separate\nEvent-objekter; dem kan man genkende på objektets id i `data.object` sammen med\nhændelsestypen. GitHubs `X-GitHub-Delivery`-header forbliver den samme, når en\nlevering bliver sendt igen. Behandlingen bør være idempotent, så en anden\nlevering ikke ændrer noget.\n\n**En opsnappet levering bliver afspillet igen.** En gyldig signatur forbliver\ngyldig, så en angriber, der opsnapper én levering, kan sende den igen. Derfor\nsigneres tidsstemplet: specifikationen siger, at et `webhook-timestamp` uden for\nen tilladt tolerance skal afvises. Stripes biblioteker bruger som standard fem\nminutter, Stripe advarer om, at en tolerance på 0 slår kontrollen helt fra, og\nanbefaler NTP til at holde serverens ur præcist. Både Stripe og specifikationen\nsætter et nyt tidsstempel på hvert nyt forsøg, så alderen måles fra det forsøg\nog ikke fra den oprindelige hændelse; et forsinket forsøg kan stadig falde uden\nfor tolerancen. Gem de sete identifikatorer mindst lige så længe som tolerancen,\nså bliver alt, der afspilles igen inden for vinduet, fanget som en dublet.\n\n**Hændelserne ankommer i forkert rækkefølge.** Stripes eksempel: når et\nabonnement oprettes, kan det give `customer.subscription.created`,\n`invoice.created`, `invoice.paid` og, hvis der er en debitering,\n`charge.created`, og intet garanterer, at de ankommer i den rækkefølge. Stripes\nsnapshot-hændelser angiver `created` i hele sekunder, så forskellige hændelser\nkan have samme tidsstempel, og Stripe siger, at man ikke skal bruge det til at\nsortere hændelser eller finde dubletter. Den robuste fremgangsmåde behandler en\nhændelse som en besked om, at noget har ændret sig, og henter objektets aktuelle\ntilstand fra API'et, før den handler på den.\n\n**Handleren er for langsom.** GitHub forventer en 2xx inden for 10 sekunder;\nderefter afbryder GitHub forbindelsen og regner leveringen som mislykket.\nSpecifikationen anbefaler en timeout for forespørgslen på et sted mellem 15 og\n30 sekunder. En handler, der udfører det egentlige arbejde, inden den svarer,\nløber ind i timeouten, afsenderen prøver igen, og arbejdet bliver udført to\ngange. Stripe og GitHub anbefaler begge en kø. Stripe peger på spidsbelastningen\ni starten af måneden, når alle abonnementer fornyes.\n\n**Kun en 2xx tæller.** Alt andet er en fejl, også en 3xx, for både\nspecifikationen og Stripe, så et endpoint, der er flyttet bag en omdirigering,\nfejler ved hver levering, indtil den registrerede URL bliver opdateret.\nSpecifikationen giver nogle få koder en betydning for afsenderen: `410 Gone`\nbetyder, at endpointet skal deaktiveres, en 429, 502 eller 504 betyder, at\nafsenderen skal sætte tempoet ned, og en `retry-after`-header bør styre det\nnæste forsøg.\n\n**For afsenderen er URL'en fjendtligt input.** Kunder kan angive en hvilken som\nhelst URL, og afsenderens servere vil kalde den. Specifikationen kalder\nwebhook-systemer særligt sårbare over for server-side request forgery (SSRF): en\nURL, der peger på en intern adresse, får afsenderen til at kalde ind i sit eget\nnetværk. Dens råd er at sende alle webhook-forespørgsler gennem en proxy, der\nfiltrerer interne IP-adresser fra, for eksempel Stripes smokescreen, og at køre\nwebhook-workerne i et privat subnet, der ikke kan nå interne tjenester.\n\n## Læs mere\n\n- [Standard Webhooks specification](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md)\n  — version 1.0.0: payloadens opbygning, signaturmetoden, headere, tidsplanen\n  for nye forsøg, håndtering af statuskoder og SSRF.\n- [Receive Stripe events in your webhook endpoint](https://docs.stripe.com/webhooks)\n  — tynde payloads og snapshot-payloads, nye forsøg, dubletter, hændelser i\n  forkert rækkefølge og beskyttelse mod replay-angreb.\n- [Best practices for using webhooks](https://docs.github.com/en/webhooks/using-webhooks/best-practices-for-using-webhooks)\n  — GitHubs liste: få hændelser, en webhook-hemmelighed, HTTPS, et svar inden\n  for 10 sekunder, ny levering og `X-GitHub-Delivery`.\n- [Validating webhook deliveries](https://docs.github.com/en/webhooks/using-webhooks/validating-webhook-deliveries)\n  — `X-Hub-Signature-256`, sammenligning i konstant tid og et testeksempel at\n  kontrollere en verifikator mod.\n\n\u003chttps://engineer.company/da/glossary/webhook/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan en tjeneste fortæller din server, at noget er sket, hvordan en signeret levering ser ud, og hvorfor modtageren skal forvente dubletter og nye forsøg.","formats":{"gemtext":"https://engineer.company/da/glossary/webhook/index.gmi","gopher":"https://engineer.company/da/glossary/webhook/gophermap","html":"https://engineer.company/da/glossary/webhook/","json":"https://engineer.company/da/glossary/webhook/index.json","markdown":"https://engineer.company/da/glossary/webhook/index.md","pdf":"https://engineer.company/da/glossary/webhook/index.pdf"},"kind":"page","language":"da","title":"Hvad er en webhook?","url":"https://engineer.company/da/glossary/webhook/","version":1}