[{"data":1,"prerenderedAt":125},["ShallowReactive",2],{"doc:\u002Fwebhooks\u002Fverifying":3},{"page":4,"toc":119},{"path":5,"title":6,"description":7,"blocks":8},"\u002Fwebhooks\u002Fverifying","Verifying signatures","Check the IPScope-Signature header on every webhook request, with code for Node.js, Python, Go, PHP and Ruby and complete receivers.",[9,12,20,25,33,36,43,48,75,77,80,83,85,99,102,105,107,114,117],{"type":10,"text":11},"p","Anyone who learns your endpoint's URL can send it requests. The `IPScope-Signature` header proves a request came from ipscope and was not changed on the way: it is an HMAC-SHA256 of the request body made with your endpoint's signing secret, which only you and ipscope know.",{"type":13,"samples":14},"code",[15],{"label":16,"lang":17,"code":18,"html":19},"Header","http","IPScope-Signature: t=1793761929,v1=d48dd86bdda97d482f2cc4a81cc14e88692654757a8c027f39c1d95a52ad8776","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">IPScope-Signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> t=1793761929,v1=d48dd86bdda97d482f2cc4a81cc14e88692654757a8c027f39c1d95a52ad8776\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"type":21,"level":22,"text":23,"id":24},"heading",2,"How the signature is made","how-the-signature-is-made",{"type":26,"ordered":27,"items":28},"list",true,[29,30,31,32],"`t` is the time the request was sent, in Unix seconds. It is fresh on every attempt, so a retry has a new `t` and a new signature.","The signed string is `t`, a period, and the **raw request body**: `\"\u003Ct>.\u003Craw body>\"`.","The signature is HMAC-SHA256 of that string, keyed with the endpoint's whole secret (including the `whsec_` prefix) as UTF-8 bytes, written as lowercase hex.","It is sent as `v1=\u003Chex>`. The header may hold more than one `v1=` entry; a request is valid when **any** of them matches.",{"type":21,"level":22,"text":34,"id":35},"Checking a request","checking-a-request",{"type":26,"ordered":27,"items":37},[38,39,40,41,42],"Read the **raw body bytes** before any JSON parsing.","Split the header on `,` and each part on the first `=`: take `t` and every `v1`.","Reject the request if `t` is more than **300 seconds** away from your clock, in either direction. This stops someone replaying an old request.","Compute the HMAC-SHA256 of `\"\u003Ct>.\u003Craw body>\"` with your secret and compare it with each `v1` value in **constant time**.","If nothing matches, answer `400` and do not process the event.",{"type":44,"tone":45,"text":46,"title":47},"callout","warning","Verify the body exactly as it arrived. Parsing the JSON and serializing it again changes whitespace and key order, and the signature will no longer match. In frameworks that parse JSON automatically, read the raw body for this route (as in the receivers below).","Use the raw body",{"type":13,"samples":49},[50,55,60,65,70],{"label":51,"lang":52,"code":53,"html":54},"Node.js","js","\u002F\u002F verify-ipscope-signature.js\nimport crypto from 'node:crypto';\n\nconst TOLERANCE_SECONDS = 300;\n\n\u002F**\n * True when `header` is a valid IPScope-Signature for `rawBody`.\n * `rawBody` is the exact bytes received (a Buffer), before any JSON parsing.\n *\u002F\nexport function verifyIpscopeSignature(rawBody, header, secret, nowMs = Date.now()) {\n  if (!header) return false;\n  let timestamp = null;\n  const signatures = [];\n  for (const part of header.split(',')) {\n    const [key, value = ''] = part.trim().split('=', 2);\n    if (key === 't') timestamp = value;\n    else if (key === 'v1' && value) signatures.push(value);\n  }\n  if (!timestamp || !\u002F^\\d+$\u002F.test(timestamp) || signatures.length === 0) return false;\n  if (Math.abs(Math.floor(nowMs \u002F 1000) - Number(timestamp)) > TOLERANCE_SECONDS) return false;\n\n  const expected = crypto\n    .createHmac('sha256', secret)\n    .update(timestamp + '.')\n    .update(rawBody)\n    .digest();\n  return signatures.some((signature) => {\n    const given = Buffer.from(signature, 'hex');\n    return given.length === expected.length && crypto.timingSafeEqual(given, expected);\n  });\n}","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F verify-ipscope-signature.js\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> crypto \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'node:crypto'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> TOLERANCE_SECONDS\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 300\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F**\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"> * True when `header` is a valid IPScope-Signature for `rawBody`.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"> * `rawBody` is the exact bytes received (a Buffer), before any JSON parsing.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"> *\u002F\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">export\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> function\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> verifyIpscopeSignature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(rawBody\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> secret\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> nowMs \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> Date\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.now\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">()) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">header) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  let\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> null\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> [];\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  for\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> part\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> of\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.split\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">','\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> [\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">key\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> value\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> ''\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">] \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> part\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.trim\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.split\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'='\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 2\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 't'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    else\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'v1'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> &#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.push\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(value);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> !\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\u002F\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">^\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\\d\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">+$\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\u002F\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.test\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(timestamp) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">length\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 0\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">Math\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.abs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">Math\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.floor\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(nowMs \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">\u002F\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 1000\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">-\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Number\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(timestamp)) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> TOLERANCE_SECONDS\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> expected\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> crypto\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    .createHmac\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'sha256'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> secret)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    .update\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">+\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '.'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    .update\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(rawBody)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    .digest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.some\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">((signature) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> given\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> Buffer\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'hex'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> given\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">length\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> expected\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">length\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> &#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> crypto\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.timingSafeEqual\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(given\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> expected);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":56,"lang":57,"code":58,"html":59},"Python","python","# verify_ipscope.py\nimport hashlib\nimport hmac\nimport time\n\nTOLERANCE_SECONDS = 300\n\n\ndef verify_ipscope_signature(raw_body: bytes, header: str | None, secret: str, now: float | None = None) -> bool:\n    \"\"\"True when `header` is a valid IPScope-Signature for `raw_body` (the exact bytes received).\"\"\"\n    if not header:\n        return False\n    timestamp = None\n    signatures = []\n    for part in header.split(\",\"):\n        key, _, value = part.strip().partition(\"=\")\n        if key == \"t\":\n            timestamp = value\n        elif key == \"v1\" and value:\n            signatures.append(value)\n    if not timestamp or not (timestamp.isascii() and timestamp.isdigit()) or not signatures:\n        return False\n    current = int(time.time() if now is None else now)\n    if abs(current - int(timestamp)) > TOLERANCE_SECONDS:\n        return False\n\n    expected = hmac.new(secret.encode(\"utf-8\"), timestamp.encode() + b\".\" + raw_body, hashlib.sha256).digest()\n    for signature in signatures:\n        try:\n            given = bytes.fromhex(signature)\n        except ValueError:\n            continue\n        if hmac.compare_digest(given, expected):\n            return True\n    return False","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># verify_ipscope.py\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hashlib\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hmac\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> time\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">TOLERANCE_SECONDS \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 300\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> verify_ipscope_signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\">raw_body\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> bytes\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> str\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> |\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\"> secret\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> str\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\"> now\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> float\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> |\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">->\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> bool\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">    \"\"\"True when `header` is a valid IPScope-Signature for `raw_body` (the exact bytes received).\"\"\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> not\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> False\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    signatures \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> []\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    for\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> part \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">split\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\",\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">):\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        key\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> _\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> part\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">strip\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">().\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">partition\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"=\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"t\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        elif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"v1\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> and\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">append\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(value)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> not\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">or\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> not\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (timestamp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">isascii\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> and\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> timestamp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">isdigit\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">or\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> not\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> False\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    current \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> int\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(time.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">time\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">() \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\"> now \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">is\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> else\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\"> now)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> abs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(current \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">-\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> int\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(timestamp))\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> >\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> TOLERANCE_SECONDS\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> False\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    expected \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hmac\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">new\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(secret.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">encode\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"utf-8\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">), timestamp.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">encode\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">() \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">+\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> b\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\".\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> +\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\"> raw_body, hashlib.sha256).\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">digest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    for\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signature \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        try\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            given \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> bytes\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">fromhex\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(signature)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        except\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> ValueError\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">            continue\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hmac\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">compare_digest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(given, expected):\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">            return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> True\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> False\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":61,"lang":62,"code":63,"html":64},"Go","go","package ipscopewebhook\n\nimport (\n\t\"crypto\u002Fhmac\"\n\t\"crypto\u002Fsha256\"\n\t\"encoding\u002Fhex\"\n\t\"strconv\"\n\t\"strings\"\n\t\"time\"\n)\n\nconst tolerance = 300 * time.Second\n\n\u002F\u002F Verify reports whether header is a valid IPScope-Signature for rawBody,\n\u002F\u002F the exact bytes of the request body.\nfunc Verify(rawBody []byte, header, secret string, now time.Time) bool {\n\tvar timestamp string\n\tvar signatures [][]byte\n\tfor _, part := range strings.Split(header, \",\") {\n\t\tkey, value, ok := strings.Cut(strings.TrimSpace(part), \"=\")\n\t\tif !ok {\n\t\t\tcontinue\n\t\t}\n\t\tswitch key {\n\t\tcase \"t\":\n\t\t\ttimestamp = value\n\t\tcase \"v1\":\n\t\t\tif sig, err := hex.DecodeString(value); err == nil {\n\t\t\t\tsignatures = append(signatures, sig)\n\t\t\t}\n\t\t}\n\t}\n\tseconds, err := strconv.ParseInt(timestamp, 10, 64)\n\tif err != nil || len(signatures) == 0 {\n\t\treturn false\n\t}\n\tif age := now.Sub(time.Unix(seconds, 0)); age > tolerance || age \u003C -tolerance {\n\t\treturn false\n\t}\n\n\tmac := hmac.New(sha256.New, []byte(secret))\n\tmac.Write([]byte(timestamp + \".\"))\n\tmac.Write(rawBody)\n\texpected := mac.Sum(nil)\n\tfor _, sig := range signatures {\n\t\tif hmac.Equal(sig, expected) {\n\t\t\treturn true\n\t\t}\n\t}\n\treturn false\n}","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">package\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> ipscopewebhook\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\t\"crypto\u002Fhmac\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\t\"crypto\u002Fsha256\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\t\"encoding\u002Fhex\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\t\"strconv\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\t\"strings\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\t\"time\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> tolerance\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 300\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> *\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> time.Second\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F Verify reports whether header is a valid IPScope-Signature for rawBody,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F the exact bytes of the request body.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">func\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Verify\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(rawBody []\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">byte\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">, header, secret \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">string\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">, now \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">time\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Time\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">bool\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\tvar\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">string\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\tvar\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signatures [][]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">byte\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\tfor\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> _, part \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> range\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> strings.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Split\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(header, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\",\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\tkey, value, ok \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> strings.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Cut\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(strings.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">TrimSpace\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(part), \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"=\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\tif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> !\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">ok {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\t\tcontinue\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\tswitch\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> key {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\tcase\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"t\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\t\ttimestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\tcase\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"v1\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\t\tif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> sig, err \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hex.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">DecodeString\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(value); err \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> nil\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\t\t\tsignatures \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> append\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(signatures, sig)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\t\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\tseconds, err \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> strconv.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">ParseInt\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(timestamp, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">10\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">64\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\tif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> err \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> nil\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> len\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(signatures) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 0\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\treturn\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\tif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> age \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> now.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Sub\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(time.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Unix\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(seconds, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">0\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)); age \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> tolerance \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> age \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> -\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">tolerance {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\treturn\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\tmac \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hmac.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">New\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(sha256.New, []\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">byte\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(secret))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\tmac.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Write\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">([]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">byte\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">+\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \".\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\tmac.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Write\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(rawBody)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\texpected \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> mac.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Sum\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">nil\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\tfor\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> _, sig \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> range\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signatures {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\tif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hmac.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Equal\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(sig, expected) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\t\t\treturn\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> true\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">\t}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">\treturn\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":66,"lang":67,"code":68,"html":69},"PHP","php","\u003C?php\n\nfunction verify_ipscope_signature(string $rawBody, ?string $header, string $secret, int $tolerance = 300): bool\n{\n    if (!$header) {\n        return false;\n    }\n    $timestamp = null;\n    $signatures = [];\n    foreach (explode(',', $header) as $part) {\n        [$key, $value] = array_pad(explode('=', trim($part), 2), 2, '');\n        if ($key === 't') {\n            $timestamp = $value;\n        } elseif ($key === 'v1' && $value !== '') {\n            $signatures[] = strtolower($value);\n        }\n    }\n    if ($timestamp === null || !ctype_digit($timestamp) || !$signatures) {\n        return false;\n    }\n    if (abs(time() - (int) $timestamp) > $tolerance) {\n        return false;\n    }\n\n    $expected = hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);\n    foreach ($signatures as $signature) {\n        if (hash_equals($expected, $signature)) {\n            return true;\n        }\n    }\n    return false;\n}\n\n\u002F\u002F The raw body, before json_decode():\n$rawBody = file_get_contents('php:\u002F\u002Finput');\n$header = $_SERVER['HTTP_IPSCOPE_SIGNATURE'] ?? null;\nif (!verify_ipscope_signature($rawBody, $header, getenv('IPSCOPE_WEBHOOK_SECRET'))) {\n    http_response_code(400);\n    exit;\n}","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">&#x3C;?\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">php\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">function\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> verify_ipscope_signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">string\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $rawBody\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ?string\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> string\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $secret\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> int\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $tolerance \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 300\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> bool\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">$header) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    $timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> null\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    $signatures \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> [];\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    foreach\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">explode\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">','\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> $header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> as\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $part) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        [$key\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $value] \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> array_pad\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">explode\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'='\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> trim\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">$part\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">),\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 2\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">),\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 2\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> ''\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> ($key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 't'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            $timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $value;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        } \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">elseif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> ($key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'v1'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> &#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $value \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> ''\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            $signatures[] \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> strtolower\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">$value\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> ($timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> null\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> !\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">ctype_digit\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">$timestamp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> !\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">$signatures) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">abs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">time\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> -\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">int\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">) $timestamp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> >\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $tolerance) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    $expected \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> hash_hmac\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'sha256'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> $timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '.'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> .\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> $rawBody\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> $secret\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    foreach\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> ($signatures \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">as\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $signature) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">hash_equals\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">$expected\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> $signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">            return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> true\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F The raw body, before json_decode():\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">$rawBody \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> file_get_contents\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'php:\u002F\u002Finput'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">$header \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> $_SERVER[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'HTTP_IPSCOPE_SIGNATURE'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">] \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">??\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> null\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">verify_ipscope_signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">$rawBody\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> $header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> getenv\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'IPSCOPE_WEBHOOK_SECRET'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">))\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    http_response_code\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">400\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    exit\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":71,"lang":72,"code":73,"html":74},"Ruby","ruby","require \"openssl\"\n\nTOLERANCE_SECONDS = 300\n\n# True when header is a valid IPScope-Signature for raw_body (the exact bytes received).\ndef verify_ipscope_signature(raw_body, header, secret, now: Time.now.to_i)\n  return false if header.nil? || header.empty?\n\n  timestamp = nil\n  signatures = []\n  header.split(\",\").each do |part|\n    key, value = part.strip.split(\"=\", 2)\n    if key == \"t\"\n      timestamp = value\n    elsif key == \"v1\" && value && !value.empty?\n      signatures \u003C\u003C value.downcase\n    end\n  end\n  return false unless timestamp&.match?(\u002F\\A\\d+\\z\u002F) && signatures.any?\n  return false if (now - timestamp.to_i).abs > TOLERANCE_SECONDS\n\n  expected = OpenSSL::HMAC.hexdigest(\"SHA256\", secret, \"#{timestamp}.#{raw_body}\")\n  signatures.any? { |signature| OpenSSL.secure_compare(expected, signature) }\nend\n\n# Rack \u002F Sinatra \u002F Rails: read the raw body before parsing it.\n# raw_body = request.body.read\n# verify_ipscope_signature(raw_body, request.env[\"HTTP_IPSCOPE_SIGNATURE\"], ENV.fetch(\"IPSCOPE_WEBHOOK_SECRET\"))","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">require\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"openssl\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">TOLERANCE_SECONDS\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 300\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># True when header is a valid IPScope-Signature for raw_body (the exact bytes received).\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> verify_ipscope_signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\">raw_body\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\"> secret\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> now: \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">Time\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">now\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">to_i\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">nil?\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ||\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">empty?\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> nil\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  signatures \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> []\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  header\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">split\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\",\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">each\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> do\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\"> |\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">part\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">|\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    key\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> part\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">strip\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">split\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"=\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 2\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"t\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">      timestamp \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    elsif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> key \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"v1\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> &#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">&#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> !\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">value\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">empty?\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">      signatures \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">&#x3C;&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> value\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">downcase\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    end\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  end\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> unless\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> timestamp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">&#x26;.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">match?\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\u002F\\A\\d+\\z\u002F\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">&#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">any?\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> false\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (now \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">-\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> timestamp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">to_i\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">abs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> >\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> TOLERANCE_SECONDS\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  expected \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> OpenSSL\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">::\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">HMAC\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">hexdigest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"SHA256\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> secret\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">#{timestamp}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">#{raw_body}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  signatures\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">any?\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">|\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">|\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> OpenSSL\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">secure_compare\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(expected\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> signature) }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">end\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># Rack \u002F Sinatra \u002F Rails: read the raw body before parsing it.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># raw_body = request.body.read\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># verify_ipscope_signature(raw_body, request.env[\"HTTP_IPSCOPE_SIGNATURE\"], ENV.fetch(\"IPSCOPE_WEBHOOK_SECRET\"))\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"type":10,"text":76},"The Python samples need Python 3.10 or later (they use `str | None` annotations); the Ruby sample needs Ruby 2.7 or later.",{"type":44,"tone":78,"text":79},"note","Keep your server's clock synchronized (NTP). A clock that is more than 5 minutes off makes every valid request fail the timestamp check.",{"type":21,"level":22,"text":81,"id":82},"A complete receiver","a-complete-receiver",{"type":10,"text":84},"A production receiver does four things, in this order: verify the signature, skip events it has already accepted, answer `2xx` immediately, and do the real work (downloading a release can take minutes) in the background. These examples download the new `.mmdb`, check its SHA-256 against the event and swap it in atomically, as described in [Automated zero-downtime updates](\u002Fdatabases\u002Fupdating).",{"type":13,"samples":86},[87,91,95],{"label":88,"lang":52,"code":89,"html":90},"Node.js (Express)","import crypto from 'node:crypto';\nimport { createWriteStream } from 'node:fs';\nimport { rename } from 'node:fs\u002Fpromises';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream\u002Fpromises';\nimport express from 'express';\nimport { verifyIpscopeSignature } from '.\u002Fverify-ipscope-signature.js';\n\nconst SECRET = process.env.IPSCOPE_WEBHOOK_SECRET;\nconst API_KEY = process.env.IPSCOPE_API_KEY; \u002F\u002F needs the `download` scope\nconst app = express();\n\n\u002F\u002F Event ids already accepted. With more than one instance, use a shared store\n\u002F\u002F (a database table with a unique key, or a key-value store with a TTL of a few days).\nconst seen = new Set();\n\n\u002F\u002F express.raw keeps the body as a Buffer: the signature covers the exact bytes.\napp.post('\u002Fhooks\u002Fipscope', express.raw({ type: 'application\u002Fjson', limit: '1mb' }), (req, res) => {\n  if (!verifyIpscopeSignature(req.body, req.get('IPScope-Signature'), SECRET)) {\n    return res.sendStatus(400);\n  }\n  const eventId = req.get('IPScope-Event-Id');\n  if (seen.has(eventId)) return res.sendStatus(200); \u002F\u002F a retry of an event we already have\n  seen.add(eventId);\n\n  const event = JSON.parse(req.body.toString('utf8'));\n  res.sendStatus(204); \u002F\u002F acknowledge right away; the work happens after the response\n\n  setImmediate(() => {\n    handleEvent(event).catch((err) => console.error('ipscope webhook', event.id, err));\n  });\n});\n\nasync function handleEvent(event) {\n  switch (event.type) {\n    case 'database.created':\n    case 'database.updated': {\n      const mmdb = event.data.release.files.find((file) => file.format === 'mmdb');\n      if (mmdb) await downloadAndSwap(mmdb, '\u002Fvar\u002Flib\u002Fipscope\u002Fipscope.mmdb');\n      break;\n    }\n    case 'database.build_failed':\n      console.warn('ipscope build failed for', event.data.database.name, '- the current release stays available');\n      break;\n    default:\n      break; \u002F\u002F webhook.test, and event types added later\n  }\n}\n\nasync function downloadAndSwap(file, dest) {\n  const res = await fetch(file.download_url, { headers: { Authorization: 'Bearer ' + API_KEY } });\n  if (!res.ok) throw new Error('download failed: HTTP ' + res.status);\n\n  const tmp = dest + '.' + process.pid + '.tmp'; \u002F\u002F same filesystem as dest, so rename is atomic\n  const hash = crypto.createHash('sha256');\n  await pipeline(\n    Readable.fromWeb(res.body),\n    async function* (chunks) {\n      for await (const chunk of chunks) {\n        hash.update(chunk);\n        yield chunk;\n      }\n    },\n    createWriteStream(tmp, { mode: 0o644 }),\n  );\n  if (hash.digest('hex') !== file.sha256) throw new Error('checksum mismatch for ' + file.filename);\n  await rename(tmp, dest);\n}\n\napp.listen(3000);","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> crypto \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'node:crypto'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { createWriteStream } \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'node:fs'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { rename } \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'node:fs\u002Fpromises'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { Readable } \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'node:stream'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { pipeline } \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'node:stream\u002Fpromises'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> express \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'express'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { verifyIpscopeSignature } \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '.\u002Fverify-ipscope-signature.js'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> SECRET\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> process\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">env\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">IPSCOPE_WEBHOOK_SECRET\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> process\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">env\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">IPSCOPE_API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">; \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F needs the `download` scope\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> express\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F Event ids already accepted. With more than one instance, use a shared store\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F (a database table with a unique key, or a key-value store with a TTL of a few days).\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> new\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Set\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F express.raw keeps the body as a Buffer: the signature covers the exact bytes.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.post\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'\u002Fhooks\u002Fipscope'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> express\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.raw\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">({ type\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'application\u002Fjson'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> limit\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '1mb'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> })\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (req\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> res) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">verifyIpscopeSignature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">req\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.body\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> req\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'IPScope-Signature'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> SECRET\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.sendStatus\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">400\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> eventId\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> req\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'IPScope-Event-Id'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.has\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(eventId)) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.sendStatus\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">200\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">); \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F a retry of an event we already have\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">  seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.add\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(eventId);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> JSON\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.parse\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">req\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">body\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.toString\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'utf8'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">));\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">  res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.sendStatus\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">204\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">); \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F acknowledge right away; the work happens after the response\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">  setImmediate\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(() \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    handleEvent\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(event)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.catch\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">((err) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> console\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.error\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'ipscope webhook'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.id\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> err));\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">async\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> function\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> handleEvent\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(event) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  switch\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.type) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    case\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'database.created'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    case\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'database.updated'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">      const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> mmdb\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">data\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">release\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">files\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.find\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">((file) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=>\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.format \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">===\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'mmdb'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">      if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (mmdb) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">await\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> downloadAndSwap\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(mmdb\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '\u002Fvar\u002Flib\u002Fipscope\u002Fipscope.mmdb'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">      break\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    case\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'database.build_failed'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">      console\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.warn\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'ipscope build failed for'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">data\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">database\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.name\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '- the current release stays available'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">      break\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    default\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">      break\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">; \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F webhook.test, and event types added later\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">async\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> function\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> downloadAndSwap\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> dest) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> await\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> fetch\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.download_url\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { headers\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { Authorization\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 'Bearer '\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> +\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> } });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.ok) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">throw\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> new\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Error\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'download failed: HTTP '\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> +\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.status);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> tmp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> dest \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">+\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '.'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> +\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> process\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.pid \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">+\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '.tmp'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">; \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">\u002F\u002F same filesystem as dest, so rename is atomic\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> hash\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> crypto\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.createHash\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'sha256'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  await\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> pipeline\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">    Readable\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.fromWeb\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">res\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.body)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    async\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> function*\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (chunks) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">      for\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> await\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">const\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> chunk\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> of\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> chunks) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">        hash\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.update\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(chunk);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        yield\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> chunk;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">      }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    }\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">    createWriteStream\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(tmp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> { mode\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 0o644\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> })\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">  );\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">hash\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.digest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'hex'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">!==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.sha256) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">throw\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> new\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Error\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'checksum mismatch for '\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> +\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">.filename);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">  await\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> rename\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(tmp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> dest);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-constant)\">app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">.listen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">3000\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">);\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":92,"lang":57,"code":93,"html":94},"Python (Flask)","import hashlib\nimport json\nimport os\nimport queue\nimport tempfile\nimport threading\nimport urllib.request\n\nfrom flask import Flask, abort, request\n\nfrom verify_ipscope import verify_ipscope_signature\n\nSECRET = os.environ[\"IPSCOPE_WEBHOOK_SECRET\"]\nAPI_KEY = os.environ[\"IPSCOPE_API_KEY\"]  # needs the `download` scope\nDEST = \"\u002Fvar\u002Flib\u002Fipscope\u002Fipscope.mmdb\"\n\napp = Flask(__name__)\njobs: \"queue.Queue[dict]\" = queue.Queue()\n\n# Event ids already accepted. With several workers or hosts, use a shared store\n# (a database table with a unique key, or a key-value store with a TTL of a few days).\nseen: set[str] = set()\nseen_lock = threading.Lock()\n\n\n@app.post(\"\u002Fhooks\u002Fipscope\")\ndef ipscope_webhook():\n    raw = request.get_data()  # the exact bytes, before any JSON parsing\n    if not verify_ipscope_signature(raw, request.headers.get(\"IPScope-Signature\"), SECRET):\n        abort(400)\n    event_id = request.headers.get(\"IPScope-Event-Id\", \"\")\n    with seen_lock:\n        if event_id in seen:\n            return \"\", 200  # a retry of an event we already have\n        seen.add(event_id)\n    jobs.put(json.loads(raw))\n    return \"\", 204  # acknowledge right away; a worker does the rest\n\n\ndef worker() -> None:\n    while True:\n        event = jobs.get()\n        try:\n            handle_event(event)\n        except Exception:\n            app.logger.exception(\"ipscope event %s failed\", event.get(\"id\"))\n\n\ndef handle_event(event: dict) -> None:\n    if event[\"type\"] in (\"database.created\", \"database.updated\"):\n        for file in event[\"data\"][\"release\"][\"files\"]:\n            if file[\"format\"] == \"mmdb\":\n                download_and_swap(file)\n    elif event[\"type\"] == \"database.build_failed\":\n        app.logger.warning(\"ipscope build failed for %s; the current release stays available\", event[\"data\"][\"database\"][\"name\"])\n\n\ndef download_and_swap(file: dict) -> None:\n    req = urllib.request.Request(file[\"download_url\"], headers={\"Authorization\": f\"Bearer {API_KEY}\"})\n    digest = hashlib.sha256()\n    # Same directory as DEST, so os.replace is an atomic rename.\n    with urllib.request.urlopen(req, timeout=300) as resp, tempfile.NamedTemporaryFile(dir=os.path.dirname(DEST), delete=False) as tmp:\n        for chunk in iter(lambda: resp.read(1 \u003C\u003C 20), b\"\"):\n            digest.update(chunk)\n            tmp.write(chunk)\n    if digest.hexdigest() != file[\"sha256\"]:\n        os.unlink(tmp.name)\n        raise ValueError(f\"checksum mismatch for {file['filename']}\")\n    os.chmod(tmp.name, 0o644)\n    os.replace(tmp.name, DEST)\n\n\nthreading.Thread(target=worker, daemon=True).start()","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hashlib\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> json\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> os\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> queue\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> tempfile\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> threading\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> urllib\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">request\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> flask \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> Flask\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> abort\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> request\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> verify_ipscope \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> verify_ipscope_signature\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">SECRET \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> os\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">environ\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"IPSCOPE_WEBHOOK_SECRET\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">API_KEY \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> os\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">environ\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"IPSCOPE_API_KEY\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">  # needs the `download` scope\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">DEST \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"\u002Fvar\u002Flib\u002Fipscope\u002Fipscope.mmdb\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">app \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Flask\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">__name__\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">jobs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"queue.Queue[dict]\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> queue\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Queue\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># Event ids already accepted. With several workers or hosts, use a shared store\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># (a database table with a unique key, or a key-value store with a TTL of a few days).\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> set\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">str\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> set\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">seen_lock \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> threading\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Lock\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">@app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">post\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\u002Fhooks\u002Fipscope\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> ipscope_webhook\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">():\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    raw \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get_data\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">  # the exact bytes, before any JSON parsing\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> not\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> verify_ipscope_signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(raw, request.headers.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"IPScope-Signature\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">), SECRET):\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">        abort\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">400\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    event_id \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">headers\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"IPScope-Event-Id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    with\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> seen_lock\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> event_id \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">            return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 200\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">  # a retry of an event we already have\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">add\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(event_id)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    jobs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">put\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(json.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">loads\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(raw))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 204\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">  # acknowledge right away; a worker does the rest\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> worker\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">() \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">->\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    while\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> True\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        event \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> jobs\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        try\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">            handle_event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(event)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        except\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> Exception\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">logger\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">exception\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"ipscope event \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">%s\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> failed\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">, event.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> handle_event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\">event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> dict\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">->\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"type\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> (\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"database.created\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"database.updated\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        for\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> file \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"data\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"release\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">][\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"files\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">            if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"format\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"mmdb\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">                download_and_swap\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(file)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    elif\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> event\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"type\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> ==\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"database.build_failed\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">logger\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">warning\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"ipscope build failed for \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">%s\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">; the current release stays available\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">, event[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"data\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">][\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"database\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">][\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"name\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">])\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> download_and_swap\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\">file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> dict\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">->\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> None\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    req \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> urllib\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(file[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"download_url\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">], headers\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"Authorization\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">: \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">f\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"Bearer \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">API_KEY\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">})\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    digest \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> hashlib\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">sha256\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">    # Same directory as DEST, so os.replace is an atomic rename.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    with\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> urllib\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">urlopen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(req, timeout\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">300\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> as\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> resp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> tempfile\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">NamedTemporaryFile\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(dir\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">os.path.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">dirname\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(DEST), delete\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">False\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> as\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> tmp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        for\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> chunk \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> iter\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">lambda\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">: resp.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">read\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">1\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> &#x3C;&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> 20\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">), \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">b\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">):\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            digest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">update\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(chunk)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">            tmp\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">write\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(chunk)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> digest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">hexdigest\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> !=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> file\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"sha256\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">        os\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">unlink\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(tmp.name)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        raise\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> ValueError\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">f\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"checksum mismatch for \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">{\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">file[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'filename'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">}\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    os\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">chmod\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(tmp.name, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">0o\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">644\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    os\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">replace\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(tmp.name, DEST)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">threading\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">Thread\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(target\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">worker, daemon\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">True\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">).\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">start\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"label":96,"lang":57,"code":97,"html":98},"Python (FastAPI)","import json\nimport os\n\nfrom fastapi import BackgroundTasks, FastAPI, HTTPException, Request, Response\n\nfrom verify_ipscope import verify_ipscope_signature\nfrom ipscope_jobs import handle_event  # your download logic, as in the Flask tab\n\nSECRET = os.environ[\"IPSCOPE_WEBHOOK_SECRET\"]\napp = FastAPI()\n\n# Event ids already accepted. With several workers or hosts, use a shared store.\nseen: set[str] = set()\n\n\n@app.post(\"\u002Fhooks\u002Fipscope\", status_code=204)\nasync def ipscope_webhook(request: Request, background: BackgroundTasks) -> Response:\n    raw = await request.body()  # the exact bytes, before any JSON parsing\n    if not verify_ipscope_signature(raw, request.headers.get(\"ipscope-signature\"), SECRET):\n        raise HTTPException(status_code=400, detail=\"invalid signature\")\n    event_id = request.headers.get(\"ipscope-event-id\", \"\")\n    if event_id in seen:\n        return Response(status_code=200)  # a retry of an event we already have\n    seen.add(event_id)\n    # Background tasks run after the response is sent; a plain def runs in a thread pool.\n    background.add_task(handle_event, json.loads(raw))\n    return Response(status_code=204)","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> json\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> os\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> fastapi \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> BackgroundTasks\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> FastAPI\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> HTTPException\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> Request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> Response\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> verify_ipscope \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> verify_ipscope_signature\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">from\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> ipscope_jobs \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">import\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> handle_event  \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\"># your download logic, as in the Flask tab\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">SECRET \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> os\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">environ\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"IPSCOPE_WEBHOOK_SECRET\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">app \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> FastAPI\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\"># Event ids already accepted. With several workers or hosts, use a shared store.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> set\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">[\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">str\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">]\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> =\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\"> set\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">@app\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">post\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\u002Fhooks\u002Fipscope\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">, status_code\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">204\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">async\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> def\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> ipscope_webhook\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\">request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> Request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">,\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-parameter)\"> background\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> BackgroundTasks) \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">->\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> Response:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    raw \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> await\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">body\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">()\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">  # the exact bytes, before any JSON parsing\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> not\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> verify_ipscope_signature\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(raw, request.headers.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"ipscope-signature\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">), SECRET):\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        raise\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> HTTPException\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(status_code\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">400\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">, detail\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"invalid signature\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    event_id \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> request\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">headers\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">get\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"ipscope-event-id\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">, \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    if\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> event_id \u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">in\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">:\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">        return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Response\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(status_code\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">200\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-comment)\">  # a retry of an event we already have\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    seen\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">add\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(event_id)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-comment)\">    # Background tasks run after the response is sent; a plain def runs in a thread pool.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">    background\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">add_task\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(handle_event, json.\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">loads\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(raw))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-keyword)\">    return\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> Response\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">(status_code\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-constant)\">204\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-punctuation)\">)\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"type":44,"tone":100,"text":101},"tip","Answer within 10 seconds even when the work takes longer: a slow answer counts as a failure and the event is sent again. If your background job can fail, give it its own retries (a job queue), because ipscope stops retrying once you have answered `2xx`.",{"type":21,"level":22,"text":103,"id":104},"Testing your receiver","testing-your-receiver",{"type":10,"text":106},"From the dashboard, **Send test event** delivers a signed `webhook.test` event to a public endpoint. To test a receiver running on your own machine, sign a request yourself with the same secret:",{"type":13,"samples":108},[109],{"label":110,"lang":111,"code":112,"html":113},"Sign a test request","bash","SECRET=\"$IPSCOPE_WEBHOOK_SECRET\"\nBODY='{\"id\":\"evt_local_test\",\"object\":\"event\",\"type\":\"webhook.test\",\"api_version\":\"2026-11-04\",\"created_at\":\"2026-11-04T03:12:09.512Z\",\"data\":{\"endpoint_id\":\"local\",\"message\":\"Local test\"}}'\nT=$(date +%s)\nSIG=$(printf '%s.%s' \"$T\" \"$BODY\" | openssl dgst -sha256 -hmac \"$SECRET\" -hex | sed 's\u002F^.* \u002F\u002F')\n\ncurl -sS -i -X POST http:\u002F\u002Flocalhost:3000\u002Fhooks\u002Fipscope \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"IPScope-Signature: t=$T,v1=$SIG\" \\\n  -H \"IPScope-Event-Id: evt_local_test\" \\\n  -H \"IPScope-Event-Type: webhook.test\" \\\n  -d \"$BODY\"","\u003Cpre class=\"shiki ipscope\" style=\"background-color:var(--shiki-background);color:var(--shiki-foreground)\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">SECRET\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">\"$IPSCOPE_WEBHOOK_SECRET\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">BODY\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\">'{\"id\":\"evt_local_test\",\"object\":\"event\",\"type\":\"webhook.test\",\"api_version\":\"2026-11-04\",\"created_at\":\"2026-11-04T03:12:09.512Z\",\"data\":{\"endpoint_id\":\"local\",\"message\":\"Local test\"}}'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">T\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">$(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">date\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> +%s\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-foreground)\">SIG\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\">=\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">$(\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\">printf\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> '%s.%s'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"$T\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"$BODY\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> |\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> openssl\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> dgst\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -sha256\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -hmac\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"$SECRET\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -hex\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-keyword)\"> |\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-function)\"> sed\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> 's\u002F^.* \u002F\u002F'\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-function)\">curl\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -sS\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -i\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> -X\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> POST\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string)\"> http:\u002F\u002Flocalhost:3000\u002Fhooks\u002Fipscope\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -H\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"Content-Type: application\u002Fjson\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -H\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"IPScope-Signature: t=$T,v1=$SIG\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -H\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"IPScope-Event-Id: evt_local_test\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -H\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"IPScope-Event-Type: webhook.test\"\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-foreground)\"> \\\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:var(--shiki-token-string)\">  -d\u003C\u002Fspan>\u003Cspan style=\"color:var(--shiki-token-string-expression)\"> \"$BODY\"\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",{"type":21,"level":22,"text":115,"id":116},"Rotating the secret","rotating-the-secret",{"type":10,"text":118},"Rotate a secret from the endpoint's page in the dashboard or with [`POST \u002Fv1\u002Fwebhooks\u002F{id}\u002Frotate-secret`](\u002Fwebhooks\u002Fapi#rotate-the-signing-secret). The old secret stops working **immediately**, so deploy the new secret to your receiver right after rotating. A delivery that fails verification in the meantime is retried and will verify once the new secret is in place; you can also [resend it](\u002Fwebhooks\u002Fapi#resend-a-delivery).",[120,121,122,123,124],{"id":24,"text":23,"level":22},{"id":35,"text":34,"level":22},{"id":82,"text":81,"level":22},{"id":104,"text":103,"level":22},{"id":116,"text":115,"level":22},1795009046017]