# Webhook-varslinger

Source: https://instatus.com/help/no/status-page/notifications/webhook

## Legg til webhook-abonnent

Logg inn på Instatus fra [instatus.com/login](https://dashboard.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

![Webhook-abonnent](https://instatus.com/help/notification/webhook1.png)

Vi sender forespørsler til URL-en din i dette [formatet](https://instatus.com/help/no/webhooks),
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).

![Webhook-hemmelighet](https://instatus.com/help/notification/webhook-secret-example.png)

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

```javascript
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.

- [X-varslinger](https://instatus.com/help/no/status-page/notifications/x): Lær hvordan du sender X-varslinger.