# Webhook 알림

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

## Webhook 구독자 추가하기

[instatus.com/login](https://dashboard.instatus.com/login)에서 Instatus에 로그인한 다음 상태 페이지를 선택하세요.

**구독자**로 이동한 다음 **Webhook**을 선택하세요.

**Webhook 구독자 추가**를 클릭하세요.

새 양식이 나타나면 다음을 입력할 수 있습니다.

- Webhook URL
- 이메일 주소

![Webhook 구독자](https://instatus.com/help/notification/webhook1.png)

이 [형식](https://instatus.com/help/ko/webhooks)에 따라 지정한 URL로 요청을 보내며,
URL에 문제가 있으면 입력한 이메일 주소로 메일을 보냅니다.

Webhook 구독자를 클릭하고 양식에 이름을 입력하면 이름을 지정할 수 있습니다. 구독 취소를 클릭해 이 구독자를 삭제할 수도 있습니다.

## Webhook 페이로드 검증

**Webhook 엔드포인트에서 페이로드를 검증할 것을 강력히 권장합니다.**

Instatus는 시크릿으로 Webhook 페이로드에 서명하고, 그 서명을 `x-instatus-webhook-signature` 헤더에 담아 보냅니다. 이 서명으로 Webhook이 Instatus에서 왔는지 확인할 수 있습니다.

### Webhook 검증 단계

1. 대시보드에서 **Webhook 시크릿**을 확인하세요 (Webhook을 만들거나 수정할 때 확인할 수 있으며, 그곳에서 직접 지정할 수도 있습니다).

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

2. Webhook을 수신할 새 엔드포인트를 서버에 만드세요.

3. 서버에서 생성한 서명과 전달된 서명을 비교해 검증하세요.

4. 서명이 일치하면 Webhook을 처리하세요.

#### 코드 예시

```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'))
```

### 검증이 중요한 이유

- **진위 확인**: Webhook이 Instatus 플랫폼에서 왔음을 보장합니다.
- **변조 방지**: 페이로드가 변경되었는지 감지합니다.
- **보안 강화**: 재전송 공격과 무단 접근을 막습니다.

- [X 알림](https://instatus.com/help/ko/status-page/notifications/x): X 알림을 보내는 방법을 알아보세요.