{"canonical_url":"https://engineer.company/nb/glossary/webhook/","content_markdown":"# webhook\n\n## Hva det er\n\nEn webhook er en HTTP-forespørsel som én tjeneste sender til en annen i det\nøyeblikket noe skjer hos den: en betaling går gjennom, en faktura blir betalt,\nen langvarig oppgave blir ferdig. Mottakersiden registrerer en URL på forhånd,\nog avsenderen sender en beskrivelse av hver hendelse dit med POST. Standard\nWebhooks-spesifikasjonen kaller webhooks «a common name for HTTP callbacks» og\nbeskriver dem som en måte tjenester kan varsle hverandre om hendelser på. Ordet\nskrives av og til som to ord, web hook, men Stripe, GitHub og spesifikasjonen\nskriver det alle i ett ord.\n\nSpesifikasjonen beskriver også en webhook som en del av en tjenestes API, et\nslags API som går baklengs. Vanligvis kaller klienten tjenesten når den vil ha\nnoe. Med en webhook kaller tjenesten klienten når den har noe nytt å fortelle.\nI en typisk API-integrasjon kjører begge sider HTTP-servere, den ene for å\nmotta API-kall og den andre for å motta webhooks. En tjeneste kan også sende\nwebhooks uten å tilby et eget forespørsels-API. Spesifikasjonen kaller avsenderen producer og mottakeren consumer, og\nURL-en mottakeren registrerer, er webhook-endepunktet dens.\n\nSpesifikasjonen anbefaler en HTTP POST med en JSON-kropp, men krever ikke et\nbestemt format eller en bestemt struktur for payloaden. Kroppen den foreslår,\nhar en `type`, skrevet med punktum og ordnet hierarkisk, for eksempel\n`invoice.paid`; et `timestamp` for når hendelsen skjedde, i ISO 8601; og\nhendelsesdataene enten under `data` eller på øverste nivå. Ytterligere metadata\nkan stå begge steder. Leveringsmetadata ligger i headere: `webhook-id`\nidentifiserer hendelsen, `webhook-timestamp` angir når akkurat dette forsøket\nble gjort, i Unix-sekunder, og `webhook-signature` bekrefter ektheten. Stripe og\nGitHub bruker egne headernavn, blant dem `Stripe-Signature` og\n`X-Hub-Signature-256`, og verifiseringsreglene deres er ulike: Stripe signerer\net tidsstempel for forsøket sammen med kroppen, mens GitHubs HMAC bare dekker\nkroppen.\n\nEn payload kan være full og inneholde hele det endrede objektet, eller tynn og\ninneholde lite mer enn en identifikator, slik at mottakeren selv må hente resten\ngjennom API-et. Spesifikasjonen veier de to mot hverandre. En full payload\nsparer mottakeren for ekstra kall til API-et. En tynn payload betyr mindre data\nå generere og sende, mer fleksibilitet og mer rom for endringer senere, fordi en\ntynn payload alltid kan vokse til en full, men ikke omvendt. Den gjør også\ndatatilgangen sporbar, fordi mottakeren uttrykkelig må be om det den leser.\nUansett råder spesifikasjonen til å holde payloads små, vanligvis under 20 kB.\nStripe tilbyr et tynt format og merker det som det anbefalte.\n\n## Hvorfor det er viktig\n\nUten webhooks må et system som trenger å vite om en endring et annet sted,\npolle: spørre igjen og igjen, for det meste bare for å høre at ingenting har\nskjedd, og likevel først få vite om endringen ved neste runde. En webhook snur\ndette. Tjenesten som kjenner til hendelsen, kaller én gang, i det øyeblikket den\nskjer. Slik melder betalingsleverandører, tjenester for kodehosting og\ne-postleverandører tilbake til systemene som er bygget på dem.\n\nDen omvendte retningen har en pris, og mesteparten av den havner hos mottakeren.\nEndepunktet er en offentlig URL som hvem som helst på internett kan sende en\nPOST til, og ingenting ved en innkommende forespørsel viser hvem som sendte den,\nså spesifikasjonen gjør verifisering av ektheten til et krav for enhver sikker\nimplementasjon. Leveringen prøves på nytt til mottakeren svarer med en\n2xx-status eller leveringsreglene setter en stopper for flere forsøk, så den samme hendelsen kan komme mer enn én gang; Stripe advarer om\nat endepunkter av og til kan motta duplikater. Rekkefølgen er heller ikke lovet:\nStripe skriver rett ut at den ikke garanterer at hendelser kommer i den\nrekkefølgen de ble generert i.\n\nAvsenderen må på sin side fortsette å prøve. Spesifikasjonen anbefaler en\ntidsplan for nye forsøk som strekker seg over flere dager, med eksponentiell\nbackoff og litt tilfeldig jitter. I eksempelet gjøres det ti forsøk, det siste\n75 timer, 35 minutter og 5 sekunder etter det første. Stripe prøver på nytt i\nopptil tre dager i live mode. En mottaker som er tilbake innenfor det vinduet,\ntar igjen det tapte av seg selv; etter det kan man hos Stripe sende en hendelse\npå nytt manuelt i opptil 15 dager etter at den ble opprettet, eller i opptil 30\ndager med Stripes CLI. Når leveringen fortsetter å feile over lang tid,\nanbefaler spesifikasjonen at avsenderen gir mottakeren beskjed gjennom en annen\nkanal, for eksempel e-post, og deaktiverer endepunktet.\n\n## Slik ser det ut i praksis\n\nDette er headerne i en levering i spesifikasjonens format. Identifikatoren,\ntidsstempelet og signaturen er eksempelverdiene spesifikasjonen selv bruker;\nverdien av `Host` og stien er oppdiktet:\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 dette er kroppen, en tynn payload fra den samme spesifikasjonen, her vist med\ninnrykk. Når den faktisk sendes, anbefaler spesifikasjonen at den er minifisert:\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\nPrefikset `v1` markerer en symmetrisk signatur: HMAC-SHA256 over hendelsens\nidentifikator, tidsstempelet og kroppen, satt sammen med punktum og beregnet med\nen hemmelig nøkkel som er unik for endepunktet. Fordi identifikatoren og\ntidsstempelet signeres sammen med kroppen, kan ingen av dem endres uten at\nsignaturen blir ugyldig. Spesifikasjonen tillater også asymmetriske\ned25519-signaturer, merket `v1a`, og anbefaler dem når man ikke selv\nkontrollerer sikkerheten på både avsender- og mottakersiden.\n\nGitHub signerer også leveringene sine med HMAC-SHA256, legger hex-digesten i\n`X-Hub-Signature-256` med prefikset `sha256=` og publiserer en hemmelighet, en\npayload og en signatur som man kan teste en verifikator mot. Her er en\nverifikator i Python, testet mot nettopp det eksempelet:\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\nEtt eneste mellomrom til slutt i kroppen er nok til at verifiseringen feiler.\n`hmac.compare_digest` bruker like lang tid uansett om strengene skiller seg\ntidlig eller sent; GitHubs dokumentasjon sier at man aldri skal sammenligne\nsignaturer med en vanlig `==`. En solid handler jobber deretter i en fast\nrekkefølge: les de rå bytene, verifiser signaturen over nøyaktig de bytene,\nsjekk at tidsstempelet for forsøket er nytt nok hvis avsenderen signerer et,\nsjekk om hendelsens identifikator er\nsett før, legg hendelsen i en kø og svar med en 2xx. Det egentlige arbeidet\nskjer etterpå. Stripe gir som eksempel å svare med 200 før en kundes faktura\nmarkeres som betalt i regnskapssystemet.\n\nTo prosjekter i porteføljen på dette nettstedet handler om webhooks sett fra\nmottakersiden. I prosjektet med\n[tilgangsrettigheter for Stripe og appkjøp](/nb/portfolio/built-stripe-and-in-app-purchase-entitlements/)\nmå et abonnement blant annet tåle en webhook som kommer to ganger, og en webhook\nsom kommer i feil rekkefølge. I\n[e‑postsystemet med failover og leveringslogging](/nb/portfolio/built-email-with-failover-and-delivery-logging/)\nrapporterer innkommende webhooks hva hver leverandør gjorde med en melding, og\nprosjektet registrerer både det som ble sendt, og det som kom tilbake, i en\nsendelogg og en tabell for leveringshendelser.\n\n## Hvor det går galt\n\n**Signaturen stemmer aldri.** En vanlig årsak er at mottakerens rammeverk parser\nJSON-kroppen, og at koden serialiserer den på nytt før HMAC-en beregnes.\nSpesifikasjonen kaller dette en svært vanlig feil: JSON-serialisering varierer\nmellom implementasjoner, og ett eneste mellomrom for mye gjør signaturen\nugyldig. Stripe trenger den rå kroppen av samme grunn og advarer om at enhver\nendring av den får verifiseringen til å feile. GitHub legger til at en proxy\neller lastbalanserer foran endepunktet ikke må endre payloaden eller headerne,\nog at payloaden bør håndteres som UTF-8. Beregn signaturen over bytene akkurat\nslik de kom, før noe parser dem.\n\n**Den samme hendelsen kommer to ganger.** Både nye forsøk og nettverksproblemer\ngir duplikater. Etter spesifikasjonen er `webhook-id` den samme ved hvert nytt\nforsøk med en hendelse og fungerer som idempotensnøkkel; eksempelet der er å ta\nvare på identifikatorene i Redis i fem minutter. Stripe ber deg registrere\nhendelses-ID-ene du har behandlet, og hoppe over dem du allerede har sett.\nStripe påpeker også at det i noen tilfeller opprettes og sendes to separate\nEvent-objekter; dem kjenner man igjen på objektets ID i `data.object` sammen med\nhendelsestypen. GitHubs `X-GitHub-Delivery`-header forblir den samme når en\nlevering sendes på nytt. Behandlingen bør være idempotent, slik at en ny\nlevering ikke endrer noe.\n\n**En oppfanget levering spilles av på nytt.** En gyldig signatur forblir gyldig,\nså en angriper som fanger opp én levering, kan sende den igjen. Derfor signeres\ntidsstempelet: spesifikasjonen sier at et `webhook-timestamp` utenfor en tillatt\ntoleranse skal avvises. Stripes biblioteker bruker fem minutter som standard,\nStripe advarer om at en toleranse på 0 slår av kontrollen helt, og anbefaler NTP\nfor å holde serverens klokke nøyaktig. Både Stripe og spesifikasjonen setter et\nnytt tidsstempel på hvert nytt forsøk, så alderen måles fra det forsøket og\nikke fra den opprinnelige hendelsen; et forsinket forsøk kan fortsatt falle\nutenfor toleransen. Ta vare på identifikatorene du har sett, minst like lenge som\ntoleransen, så blir alt som spilles av på nytt innenfor vinduet, fanget opp som\net duplikat.\n\n**Hendelsene kommer i feil rekkefølge.** Stripes eksempel: når et abonnement\nopprettes, kan det gi `customer.subscription.created`, `invoice.created`,\n`invoice.paid` og, hvis det er en belastning, `charge.created`, og ingenting\ngaranterer at de kommer i den rekkefølgen. Stripes snapshot-hendelser angir\n`created` i hele sekunder, så ulike hendelser kan ha samme tidsstempel, og\nStripe sier at man ikke skal bruke det til å sortere hendelser eller oppdage\nduplikater. Den robuste tilnærmingen behandler en hendelse som en beskjed om at\nnoe er endret, og henter objektets nåværende tilstand fra API-et før den handler\npå den.\n\n**Handleren er for treg.** GitHub forventer en 2xx innen 10 sekunder; etter det\nbryter GitHub forbindelsen og regner leveringen som mislykket. Spesifikasjonen\nanbefaler et tidsavbrudd for forespørselen på et sted mellom 15 og 30 sekunder.\nEn handler som gjør det egentlige arbeidet før den svarer, får tidsavbrudd,\navsenderen prøver på nytt, og arbeidet blir gjort to ganger. Stripe og GitHub\nanbefaler begge en kø. Stripe peker på toppen i begynnelsen av måneden, når alle\nabonnementer fornyes.\n\n**Bare en 2xx teller.** Alt annet er en feil, også en 3xx, for både\nspesifikasjonen og Stripe, så et endepunkt som er flyttet bak en omdirigering,\nfeiler ved hver levering til den registrerte URL-en blir oppdatert.\nSpesifikasjonen gir noen få koder en betydning for avsenderen: `410 Gone` betyr\nat endepunktet skal deaktiveres, en 429, 502 eller 504 betyr at avsenderen skal\nsette ned tempoet, og en `retry-after`-header bør styre neste forsøk.\n\n**For avsenderen er URL-en fiendtlig input.** Kunder kan oppgi hvilken URL de\nvil, og avsenderens servere kommer til å kalle den. Spesifikasjonen kaller\nwebhook-systemer spesielt sårbare for server-side request forgery (SSRF): en URL\nsom peker på en intern adresse, får avsenderen til å kalle inn i sitt eget\nnettverk. Rådet er å sende alle webhook-forespørsler gjennom en proxy som\nfiltrerer bort interne IP-adresser, for eksempel Stripes smokescreen, og å kjøre\nwebhook-workerne i et privat subnett som ikke når interne tjenester.\n\n## Les mer\n\n- [Standard Webhooks specification](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md)\n  — versjon 1.0.0: oppbygningen av payloaden, signaturmetoden, headere,\n  tidsplanen for nye forsøk, håndtering av statuskoder og SSRF.\n- [Receive Stripe events in your webhook endpoint](https://docs.stripe.com/webhooks)\n  — tynne payloads og snapshot-payloads, nye forsøk, duplikater, hendelser i\n  feil rekkefølge og beskyttelse mot replay-angrep.\n- [Best practices for using webhooks](https://docs.github.com/en/webhooks/using-webhooks/best-practices-for-using-webhooks)\n  — GitHubs liste: få hendelser, en webhook-hemmelighet, HTTPS, et svar innen 10\n  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 å\n  kontrollere en verifikator mot.\n\n\u003chttps://engineer.company/nb/glossary/webhook/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan en tjeneste forteller serveren din at noe har skjedd, hvordan en signert levering ser ut, og hvorfor mottakeren må regne med duplikater og nye forsøk.","formats":{"gemtext":"https://engineer.company/nb/glossary/webhook/index.gmi","gopher":"https://engineer.company/nb/glossary/webhook/gophermap","html":"https://engineer.company/nb/glossary/webhook/","json":"https://engineer.company/nb/glossary/webhook/index.json","markdown":"https://engineer.company/nb/glossary/webhook/index.md","pdf":"https://engineer.company/nb/glossary/webhook/index.pdf"},"kind":"page","language":"nb","title":"Hva er en webhook?","url":"https://engineer.company/nb/glossary/webhook/","version":1}