개요
조직에서 「외부 시스템 연동」 기능을 사용 중이면 운영 콘솔의 연동 관리 화면 또는 관리 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 엔드포인트로 전송 |
웹훅 등록 예시
POST /integrations/webhookscurl -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 |