외부 시스템 연동

API 키, 웹훅, 연동 앱으로 탐지를 수신하고 사건·조치 결과를 기존 업무 시스템으로 전달합니다.

개요

조직에서 「외부 시스템 연동」 기능을 사용 중이면 운영 콘솔의 연동 관리 화면 또는 관리 API로 API 키·웹훅·연동 앱을 설정할 수 있습니다.

관리 API (로그인 세션)

MethodPath설명
GET/integrations/catalog연동 앱 카탈로그
GET|POST/integrations/connections연동 연결
GET|POST|DELETE/integrations/webhooks아웃바운드 웹훅
GET|POST|DELETE/integrations/api-keysAPI 키 발급
GET/integrations/quota사용량·한도
POST/integrations/connections/:id/test연결 테스트

지원 연동 앱

연동 앱용도
Slack 운영 알림사건·조치·대응 제안 알림
Splunk HEC탐지·조치·보고서 로그 전달
ServiceNow 사건 동기화ITSM 티켓과 상태 동기화
사용자 정의 웹훅사건 이벤트를 사내 HTTP 엔드포인트로 전송

웹훅 등록 예시

POST /integrations/webhooks
curl -X POST "https://api-gateway-production-20f8.up.railway.app/integrations/webhooks" \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://partner.example/hooks/aimon",
    "eventTypes": ["incident.created", "vision.detection"],
    "secret": "<signing-secret>"
  }'

플랜별 사용 한도

플랜API 키웹훅연동 연결분당 요청
pilot32560
standard101020120
enterprise50100200600