가이드
외부 시스템 연동
API 키, 웹훅, 연동 앱으로 탐지를 수신하고 사건·조치 결과를 기존 업무 시스템으로 전달합니다.
개요
조직에서 「외부 시스템 연동」 기능을 사용 중이면 운영 콘솔의 연동 관리 화면 또는 관리 API로 API 키·웹훅·연동 앱을 설정할 수 있습니다.
관리 API (로그인 세션)
| Method | Path | 설명 |
|---|---|---|
| GET | /integrations/catalog | 연동 앱 카탈로그 |
| GET|POST | /integrations/connections | 연동 연결 |
| GET|POST|DELETE | /integrations/webhooks | 아웃바운드 웹훅 |
| GET|POST|DELETE | /integrations/api-keys | API 키 발급 |
| GET | /integrations/quota | 사용량·한도 |
| POST | /integrations/connections/:id/test | 연결 테스트 |
지원 연동 앱
| 연동 앱 | 용도 |
|---|---|
| Slack 운영 알림 | 사건·조치·대응 제안 알림 |
| Splunk HEC | 탐지·조치·보고서 로그 전달 |
| ServiceNow 사건 동기화 | ITSM 티켓과 상태 동기화 |
| 사용자 정의 웹훅 | 사건 이벤트를 사내 HTTP 엔드포인트로 전송 |
웹훅 등록 예시
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 키 | 웹훅 | 연동 연결 | 분당 요청 |
|---|---|---|---|---|
| pilot | 3 | 2 | 5 | 60 |
| standard | 10 | 10 | 20 | 120 |
| enterprise | 50 | 100 | 200 | 600 |