Webhook 알림

Webhook 구독자 추가하기

instatus.com/login에서 Instatus에 로그인한 다음 상태 페이지를 선택하세요.

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

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

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

• Webhook URL
• 이메일 주소

이 형식에 따라 지정한 URL로 요청을 보내며, URL에 문제가 있으면 입력한 이메일 주소로 메일을 보냅니다.

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

Webhook 페이로드 검증

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

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

Webhook 검증 단계

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

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

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

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

코드 예시

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 플랫폼에서 왔음을 보장합니다.
• 변조 방지: 페이로드가 변경되었는지 감지합니다.
• 보안 강화: 재전송 공격과 무단 접근을 막습니다.