이벤트 카탈로그

웹훅 envelope, 서명 검증, 이벤트 타입

Envelope

아웃바운드 웹훅 본문 형식:

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>

검증은 @aimon/integrations의 verifyWebhookSignature를 사용하세요. 구독 시 설정한 secret으로 HMAC-SHA256을 계산합니다.

이벤트 타입

type	발행 시점
vision.detection	Vision ingest 후
recommendation.created	Agent 추천 생성
recommendation.approved	운영자 승인
workflow.completed	워크플로 실행 완료
incident.created	인시던트 생성
incident.updated	인시던트 갱신
incident.closed	인시던트 종료
report.generated	리포트 생성 완료

파이프라인

마이크로서비스 → publishIntegrationEvent() → integration_outbox → gateway poller → 웹훅·커넥터 어댑터