Webhook-varslinger

Legg til webhook-abonnent

Logg inn på Instatus fra instatus.com/login og velg deretter statussiden din.

Gå til Abonnenter, deretter Webhook.

Klikk Legg til webhook-abonnent,

Et nytt skjema vises, der du kan fylle inn:

• Webhook-URL
• E-postadresse

Vi sender forespørsler til URL-en din i dette formatet, og det sendes en e-post til den angitte e-postadressen hvis det oppstår et problem med URL-en.

Du kan gi webhook-abonnenten et navn ved å klikke på den og skrive inn et navn i skjemaet. Du kan også slette denne abonnenten ved å klikke Meld av.

Verifisering av webhook-nyttelast

Det anbefales sterkt å validere webhook-nyttelasten i webhook-endepunktet.

Vi signerer webhook-nyttelaster med en hemmelighet og inkluderer signaturen i en header med navnet x-instatus-webhook-signature. Denne signaturen lar deg verifisere at webhooken kom fra Instatus.

Trinn for å verifisere en webhook

1. Hent webhook-hemmeligheten din fra dashbordet (du finner den mens du redigerer eller oppretter en webhook, og du kan også tilpasse den der).

2. Opprett et nytt endepunkt på serveren din som skal motta webhooken.

3. Sammenlign signaturen med signaturen serveren din genererer, for å validere.

4. Hvis signaturene stemmer overens, behandler du webhooken.

Kodeeksempel

import crypto from 'crypto'
import express from 'express'

const app = express()
app.use(express.json())

const WEBHOOK_SECRET = 'your-webhook-secret'

function isVerifiedPayload(payload, signature, secret) {
  const hmac = crypto.createHmac('sha256', secret)
  const digest = hmac.update(JSON.stringify(payload)).digest('hex')
  return crypto.timingSafeEqual(Buffer.from(digest), Buffer.from(signature))
}

app.post('/endpoint/to/webhook', (req, res) => {
  const payload = req.body
  const signature = req.header('x-instatus-webhook-signature')

  if (!signature) {
    return res.status(400).send('Signature missing')
  }

  if (!isVerifiedPayload(payload, signature, WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature')
  }

  // Process the valid webhook
  res.status(200).send('Webhook received')
})

app.listen(3000, () => console.log('Server running on port 3000'))

Hvorfor verifisering er viktig

• Sikrer autentisitet: Garanterer at webhooken kommer fra plattformen vår.
• Hindrer manipulering: Oppdager endringer i nyttelasten.
• Bedrer sikkerheten: Beskytter mot replay-angrep og uautorisert tilgang.