Webhook 알람 채널
선택한 Cremit 알람을 공개 웹훅 주소로 보냅니다. POST·GET과 수신 측 인증 방식을 설정할 수 있습니다.
주요 기능
- 설정한 공개 URL로 POST JSON 또는 GET 요청
- 인증 없음·Bearer 토큰·API 키 헤더·Basic 인증
- 테스트 전송과 알람 전송 기록
- 활성화한 알람 규칙 또는 워크플로에서 목적지 선택
사전 요구사항
- 1외부에서 접근할 수 있는 HTTP 또는 HTTPS 수신 주소; 인증 정보와 알람 데이터에는 HTTPS 사용
- 2Cremit 알람 채널과 규칙 또는 워크플로를 설정할 권한
- 3수신 주소에 필요한 인증 정보
단계별 설정 가이드
연동에 필요한 설정 단계를 순서대로 확인하세요.
어떤 요청이 전송되나요?
웹훅 채널은 알림 목적지입니다. 활성화한 알람 규칙이나 워크플로에서 이 채널을 선택하고 조건에 맞는 이벤트가 발생해야 전송합니다. POST는 message, timestamp, metadata가 담긴 JSON을 보냅니다. 공개 metadata에는 가능한 경우 트리거 유형, 심각도, 이벤트 시각과 전송 목적지 유형이 담깁니다. GET은 이 JSON 본문 없이 설정한 URL을 호출합니다. 특정 필드에 맞춰 수신기를 만들기 전에 테스트 요청을 직접 확인하세요.
현재 채널에는 HMAC 서명 옵션, X-Cremit-Signature 헤더, PagerDuty·Teams·Discord용 페이로드 프리셋이 없습니다. 수신기가 다른 형식을 요구한다면 별도 변환기를 마련해야 합니다. 인증이 필요한 수신기에는 HTTPS와 수신기 인증 정보를 사용하세요. Cremit 웹훅 요청 자체가 암호학적으로 서명됐다고 가정하면 안 됩니다.
채널을 만들고 알람에 연결하기
Cremit Platform의 Configuration → Alarms → Channels에서 Webhook 채널을 추가하세요. 이름과 외부에서 접근할 수 있는 URL을 입력합니다. JSON 본문을 받는다면 POST, URL 호출을 받는다면 GET을 선택합니다. 수신기에 맞춰 인증 없음, Bearer 토큰, API 키 헤더 또는 Basic 인증을 고르세요. localhost와 사설 네트워크 주소는 허용되지 않습니다.
채널을 저장한 뒤 활성화한 알람 규칙이나 워크플로의 알림 작업에서 목적지로 선택하세요. 조건도 해당 규칙 또는 워크플로에서 정합니다. 채널 생성만으로 모든 탐지 결과가 전송되지는 않습니다. Slack 수신 웹훅 주소도 웹훅 목적지로 사용할 수 있지만 Slack OAuth 채널과 연결 경로가 다릅니다.
전송을 확인하고 실패를 조사하기
저장 후 채널 테스트 기능으로 무해한 메시지를 보내세요. 테스트 요청은 대기열에 들어가므로 버튼이 성공을 반환해도 수신기가 받아들였다는 뜻은 아닙니다. 수신기와 Cremit 알람 기록에서 최종 결과를 확인하세요. 조건에 맞는 이벤트가 생긴 뒤에는 규칙 또는 워크플로의 전송 기록도 살펴보세요. 테스트용으로 실제 자격증명을 노출하지 마세요.
실패했다면 수신 URL, 메서드, 인증 설정을 비교하고 수신기의 HTTP 응답과 Cremit 전송 기록을 확인하세요. 수신기의 거절은 최종 실패로 끝날 수 있고 일시적 오류는 재시도될 수 있습니다. 예전 문서에 있던 고객용 5회 재시도·DLQ 재전송 화면이나 고정 전송 시간은 현재 제품에서 제공하지 않습니다.
