{"canonical_url":"https://engineer.company/sv/glossary/webhook/","content_markdown":"# webhook\n\n## Vad det är\n\nEn webhook är en HTTP-begäran som en tjänst skickar till en annan i samma\nögonblick som något händer hos den: en betalning går igenom, en faktura blir\nbetald, en lång uppgift blir klar. Den mottagande sidan registrerar en URL i\nförväg, och avsändaren skickar en beskrivning av varje händelse dit med POST.\nSpecifikationen Standard Webhooks kallar webhooks ”a common name for HTTP\ncallbacks” och beskriver dem som ett sätt för tjänster att meddela varandra om\nhändelser. Ordet skrivs ibland som två ord, web hook, men Stripe, GitHub och\nspecifikationen skriver det alla som ett ord.\n\nSpecifikationen beskriver också en webhook som en del av en tjänsts API, ett\nslags API som går baklänges. Normalt anropar klienten tjänsten när den vill ha\nnågot. Med en webhook anropar tjänsten klienten när den har något nytt att\nberätta. I en typisk API-integration kör båda sidor HTTP-servrar, den ena för att ta\nemot API-anrop och den andra för att ta emot webhooks. En tjänst kan också\nskicka webhooks utan att erbjuda ett eget API för förfrågningar. Specifikationen kallar avsändaren producer och mottagaren consumer,\noch den URL som mottagaren registrerar är dess webhook-slutpunkt.\n\nSpecifikationen rekommenderar en HTTP POST med en JSON-kropp men kräver inte\nnågot särskilt format eller någon särskild struktur för payloaden. Den\nföreslagna kroppen har en `type`, skriven med punkter och ordnad hierarkiskt,\ntill exempel `invoice.paid`; en `timestamp` för när händelsen inträffade, i ISO\n8601; och händelsedata antingen under `data` eller på översta nivån. Ytterligare\nmetadata kan finnas på båda ställena. Leveransmetadata ligger i huvudfält:\n`webhook-id` identifierar händelsen, `webhook-timestamp` anger när just det här\nförsöket gjordes, i Unix-sekunder, och `webhook-signature` bekräftar dess äkthet.\nStripe och GitHub använder egna namn på huvudfälten, bland dem\n`Stripe-Signature` och `X-Hub-Signature-256`, och deras verifieringsregler\nskiljer sig åt: Stripe signerar försökets tidsstämpel tillsammans med kroppen,\nmedan GitHubs HMAC bara täcker kroppen.\n\nEn payload kan vara fullständig och innehålla hela det ändrade objektet, eller\ntunn och innehålla inte mycket mer än en identifierare, så att mottagaren själv\nfår hämta resten via API:et. Specifikationen väger de två mot varandra. En\nfullständig payload besparar mottagaren extra anrop till API:et. En tunn payload\ninnebär mindre data att generera och skicka, mer flexibilitet och mer utrymme\nför ändringar senare, eftersom en tunn payload alltid kan växa till en\nfullständig men inte tvärtom. Den gör också dataåtkomsten spårbar, eftersom\nmottagaren uttryckligen måste be om det den läser. Hur som helst rekommenderar\nspecifikationen att payloads hålls små, oftast under 20 kB. Stripe erbjuder ett\ntunt format och anger det som det rekommenderade.\n\n## Varför det spelar roll\n\nUtan webhooks måste ett system som behöver veta om en ändring någon annanstans\npolla: fråga om och om igen, för det mesta bara för att få höra att ingenting\nhar hänt, och ändå inte upptäcka ändringen förrän vid nästa fråga. En webhook\nvänder på det. Tjänsten som känner till händelsen anropar en gång, i samma\nögonblick som den inträffar. Det är så betalningsleverantörer, tjänster för\nkodhosting och e-postleverantörer rapporterar tillbaka till de system som är\nbyggda ovanpå dem.\n\nDen omvända riktningen har ett pris, och det mesta av det hamnar hos mottagaren.\nDess slutpunkt är en offentlig URL som vem som helst på internet kan skicka en\nPOST till, och ingenting i en inkommande begäran visar vem som skickade den, så\nspecifikationen gör verifiering av äktheten till ett krav för varje säker\nimplementation. Leveransen görs om tills mottagaren svarar med en 2xx-status eller\nleveranspolicyn stoppar fler försök, så\nsamma händelse kan komma mer än en gång; Stripe varnar för att slutpunkter\nibland kan ta emot dubbletter. Ordningen är inte heller utlovad: Stripe skriver\nrakt ut att företaget inte garanterar att händelser kommer i den ordning de\nskapades.\n\nAvsändaren måste för sin del fortsätta försöka. Specifikationen rekommenderar en\ntidsplan för omförsök som sträcker sig över flera dagar, med exponentiell\nbackoff och lite slumpmässig jitter. I dess exempel görs tio försök, det sista\n75 timmar, 35 minuter och 5 sekunder efter det första. Stripe gör omförsök i upp\ntill tre dagar i live mode. En mottagare som är tillbaka inom det fönstret\nkommer ikapp av sig själv; därefter kan man hos Stripe skicka om en händelse\nmanuellt i upp till 15 dagar efter att den skapades, eller i upp till 30 dagar\nmed Stripes CLI. När leveransen fortsätter att misslyckas under lång tid\nrekommenderar specifikationen att avsändaren meddelar mottagaren via en annan\nkanal, till exempel e-post, och inaktiverar slutpunkten.\n\n## Så ser det ut i praktiken\n\nDet här är huvudfälten i en leverans i specifikationens format. Identifieraren,\ntidsstämpeln och signaturen är de exempelvärden som specifikationen själv\nanvänder; värdet för `Host` och sökvägen är påhittade:\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\nOch det här är kroppen, en tunn payload från samma specifikation, här med indrag\nför läsbarhetens skull. När den faktiskt skickas rekommenderar specifikationen\natt den är minifierad:\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\nPrefixet `v1` markerar en symmetrisk signatur: HMAC-SHA256 över händelsens\nidentifierare, tidsstämpeln och kroppen, sammanfogade med punkter och beräknade\nmed en hemlig nyckel som är unik för slutpunkten. Eftersom identifieraren och\ntidsstämpeln signeras tillsammans med kroppen kan ingen av dem ändras utan att\nsignaturen blir ogiltig. Specifikationen tillåter också asymmetriska\ned25519-signaturer, markerade `v1a`, och rekommenderar dem när man inte själv\nkontrollerar säkerheten på både avsändar- och mottagarsidan.\n\nGitHub signerar också sina leveranser med HMAC-SHA256, lägger hex-digesten i\n`X-Hub-Signature-256` med prefixet `sha256=` och publicerar en hemlighet, en\npayload och en signatur att testa en verifierare mot. Här är en verifierare i\nPython, testad mot just det exemplet:\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 enda mellanslag sist i kroppen räcker för att verifieringen ska misslyckas.\n`hmac.compare_digest` tar lika lång tid oavsett om strängarna skiljer sig tidigt\neller sent; GitHubs dokumentation säger att man aldrig ska jämföra signaturer\nmed en vanlig `==`. En robust handler arbetar sedan i en fast ordning: läs de\nråa bytena, verifiera signaturen över exakt de bytena, kontrollera att\nförsökets tidsstämpel är tillräckligt ny om avsändaren signerar en sådan,\nkontrollera om händelsens identifierare har\nsetts förut, lägg händelsen i en kö och svara med en 2xx. Det egentliga arbetet\ngörs efteråt. Stripe ger som exempel att svara med 200 innan en kunds faktura\nmarkeras som betald i bokföringssystemet.\n\nTvå projekt i portföljen här på webbplatsen handlar om webhooks sedda från\nmottagarsidan. I projektet med\n[åtkomsträttigheter via Stripe och appköp](/sv/portfolio/built-stripe-and-in-app-purchase-entitlements/)\nmåste en prenumeration bland annat klara en webhook som kommer två gånger och en\nwebhook som kommer i fel ordning. I\n[e‑postsystemet med failover och leveransloggning](/sv/portfolio/built-email-with-failover-and-delivery-logging/)\nrapporterar inkommande webhooks vad varje leverantör gjorde med ett meddelande,\noch projektet registrerar både det som skickades och det som kom tillbaka, i en\nutskickslogg och en tabell för leveranshändelser.\n\n## Var det går fel\n\n**Signaturen stämmer aldrig.** En vanlig orsak är att mottagarens ramverk parsar\nJSON-kroppen och att koden serialiserar den på nytt innan HMAC:en beräknas.\nSpecifikationen kallar det ett mycket vanligt fel: JSON-serialisering skiljer\nsig mellan implementationer, och ett enda mellanslag för mycket gör signaturen\nogiltig. Stripe behöver den råa kroppen av samma skäl och varnar för att varje\nändring av den får verifieringen att misslyckas. GitHub tillägger att en proxy\neller lastbalanserare framför slutpunkten inte får ändra payloaden eller\nhuvudfälten, och att payloaden bör hanteras som UTF-8. Beräkna signaturen över\nbytena exakt som de kom, innan något parsar dem.\n\n**Samma händelse kommer två gånger.** Både omförsök och nätverksproblem ger\ndubbletter. Enligt specifikationen är `webhook-id` densamma vid varje omförsök\nav en händelse och fungerar som idempotensnyckel; dess exempel är att spara\nidentifierarna i Redis i fem minuter. Stripe uppmanar dig att registrera de\nhändelse-ID:n du har behandlat och hoppa över dem du redan har sett. Stripe\npåpekar också att det i vissa fall skapas och skickas två separata Event-objekt;\ndem känner man igen på objektets ID i `data.object` tillsammans med\nhändelsetypen. GitHubs huvudfält `X-GitHub-Delivery` förblir detsamma när en\nleverans skickas om. Behandlingen bör vara idempotent, så att en andra leverans\ninte ändrar någonting.\n\n**En uppsnappad leverans spelas upp igen.** En giltig signatur förblir giltig,\nså en angripare som snappar upp en leverans kan skicka den igen. Därför signeras\ntidsstämpeln: specifikationen säger att en `webhook-timestamp` utanför en\ntillåten tolerans ska avvisas. Stripes bibliotek använder fem minuter som\nstandard, Stripe varnar för att en tolerans på 0 stänger av kontrollen helt och\nrekommenderar NTP för att hålla serverns klocka exakt. Både Stripe och\nspecifikationen sätter en ny tidsstämpel på varje omförsök, så åldern mäts från\ndet försöket och inte från den ursprungliga händelsen; ett försenat försök kan\nfortfarande hamna utanför toleransen. Spara de identifierare du har sett minst lika\nlänge som toleransen, så fångas allt som spelas upp igen inom fönstret som en\ndubblett.\n\n**Händelser kommer i fel ordning.** Stripes exempel: när en prenumeration skapas\nkan det ge `customer.subscription.created`, `invoice.created`, `invoice.paid`\noch, om det finns en debitering, `charge.created`, och ingenting garanterar att\nde kommer i den ordningen. Stripes snapshot-händelser anger `created` i hela\nsekunder, så olika händelser kan ha samma tidsstämpel, och Stripe säger att man\ninte ska använda den för att ordna händelser eller upptäcka dubbletter. Det\nrobusta sättet behandlar en händelse som ett besked om att något har ändrats och\nhämtar objektets aktuella tillstånd från API:et innan det agerar på den.\n\n**Handlern är för långsam.** GitHub förväntar sig en 2xx inom 10 sekunder;\ndärefter avbryter GitHub anslutningen och räknar leveransen som misslyckad.\nSpecifikationen rekommenderar en timeout för begäran någonstans mellan 15 och 30\nsekunder. En handler som gör det egentliga arbetet innan den svarar råkar ut för\nen timeout, avsändaren gör ett omförsök och arbetet utförs två gånger. Stripe\noch GitHub rekommenderar båda en kö. Stripe pekar på toppen i början av månaden,\nnär alla prenumerationer förnyas.\n\n**Bara en 2xx räknas.** Allt annat är ett misslyckande, också en 3xx, för både\nspecifikationen och Stripe, så en slutpunkt som har flyttats bakom en\nomdirigering misslyckas med varje leverans tills den registrerade URL:en\nuppdateras. Specifikationen ger några få koder en betydelse för avsändaren: `410\nGone` betyder att slutpunkten ska inaktiveras, en 429, 502 eller 504 betyder att\navsändaren ska sakta ner, och ett `retry-after`-huvud bör styra nästa försök.\n\n**För avsändaren är URL:en fientlig indata.** Kunder kan ange vilken URL de\nvill, och avsändarens servrar kommer att anropa den. Specifikationen kallar\nwebhook-system särskilt sårbara för server-side request forgery (SSRF): en URL\nsom pekar på en intern adress får avsändaren att anropa in i sitt eget nätverk.\nRådet är att skicka alla webhook-begäranden genom en proxy som filtrerar bort\ninterna IP-adresser, till exempel Stripes smokescreen, och att köra\nwebhook-workers i ett privat subnät som inte når interna tjänster.\n\n## Läs mer\n\n- [Standard Webhooks specification](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md)\n  — version 1.0.0: payloadens uppbyggnad, signaturmetoden, huvudfält, tidsplanen\n  för omförsök, hantering av statuskoder och SSRF.\n- [Receive Stripe events in your webhook endpoint](https://docs.stripe.com/webhooks)\n  — tunna payloads och snapshot-payloads, omförsök, dubbletter, händelser i fel\n  ordning och skydd mot replay-attacker.\n- [Best practices for using webhooks](https://docs.github.com/en/webhooks/using-webhooks/best-practices-for-using-webhooks)\n  — GitHubs lista: få händelser, en webhook-hemlighet, HTTPS, ett svar inom 10\n  sekunder, ny leverans och `X-GitHub-Delivery`.\n- [Validating webhook deliveries](https://docs.github.com/en/webhooks/using-webhooks/validating-webhook-deliveries)\n  — `X-Hub-Signature-256`, jämförelse i konstant tid och ett testexempel att\n  kontrollera en verifierare mot.\n\n\u003chttps://engineer.company/sv/glossary/webhook/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hur en tjänst talar om för din server att något har hänt, hur en signerad leverans ser ut och varför mottagaren måste räkna med dubbletter och nya försök.","formats":{"gemtext":"https://engineer.company/sv/glossary/webhook/index.gmi","gopher":"https://engineer.company/sv/glossary/webhook/gophermap","html":"https://engineer.company/sv/glossary/webhook/","json":"https://engineer.company/sv/glossary/webhook/index.json","markdown":"https://engineer.company/sv/glossary/webhook/index.md","pdf":"https://engineer.company/sv/glossary/webhook/index.pdf"},"kind":"page","language":"sv","title":"Vad är en webhook?","url":"https://engineer.company/sv/glossary/webhook/","version":1}