웹훅 이벤트 목록

외부 시스템이 AIMON에서 받을 수 있는 사건·탐지·조치 이벤트와 서명 검증 방법

공통 본문 형식

아웃바운드 웹훅 본문은 다음 형식을 따릅니다.

JSON body

{
  "id": "evt_01...",
  "type": "incident.created",
  "tenantId": "tenant_demo",
  "siteId": "site_demo",
  "occurredAt": "2026-05-27T10:00:00.000Z",
  "data": { ... }
}

서명 검증

헤더: Aimon-Signature: t=<unix>,v1=<hmac>

수신 서버에서는 구독 시 설정한 비밀키로 HMAC-SHA256 서명을 검증하세요. 동일한 이벤트 ID가 여러 번 도착해도 한 번만 처리하도록 구성합니다.

이벤트 유형

type	발행 시점
vision.detection	탐지 이벤트 수신 후
recommendation.created	AI 대응 제안 생성
recommendation.approved	운영자 승인
workflow.completed	조치 실행 완료
incident.created	사건 생성
incident.updated	사건 갱신
incident.closed	사건 종료
report.generated	보고서 생성 완료

재전송

수신 측이 5xx로 응답하면 AIMON이 재전송을 시도합니다. 가능하면 빠르게 2xx를 반환하세요.