웹훅 처리

웹훅은 예약 및 기술자 이벤트를 실시간으로 엔드포인트에 푸시합니다. URL과 서명 키를 등록하면 CrispHive가 이벤트 발생 시점에 즉시 전달합니다.

엔드포인트 등록

외부에서 접근 가능한 HTTPS URL을 서명 키와 함께 등록하면, 시스템 동작이 해당 URL로 JSON 이벤트를 푸시합니다. 전달에 실패한 경우 지수 백오프 방식으로 재시도됩니다.

서명 검증

각 전달에는 X-CrispHive-Signature 헤더가 포함됩니다. 서명 키로 원본 본문(raw body)의 HMAC-SHA256을 다시 계산하고, 페이로드를 신뢰하기 전에 상수 시간 비교를 수행하시기 바랍니다.

import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(rawBody, signature, signingKey) {
  const expected = createHmac('sha256', signingKey)
    .update(rawBody)
    .digest('hex');
  return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}

이벤트 카탈로그