메인 콘텐츠로 건너뛰기
웹훅을 사용하면 CloudThinker가 이벤트를 실시간으로 외부 시스템에 푸시하여 자동화, 연동, 사용자 정의 워크플로를 구현할 수 있습니다.

웹훅 작동 방식

1

구성

대상 URL로 웹훅 엔드포인트를 생성하고 구독할 이벤트를 선택하세요
2

트리거

구독한 이벤트가 발생하면 CloudThinker가 웹훅 페이로드를 준비합니다
3

전달

CloudThinker가 이벤트 데이터를 담아 엔드포인트로 HTTP POST 요청을 전송합니다
4

처리

시스템이 웹훅을 수신하고 처리한 후 성공 응답을 반환합니다

웹훅 생성

콘솔에서 생성

  1. 설정 > Webhooks로 이동
  2. 웹훅 생성 클릭
  3. 웹훅 구성:
    • 이름: 식별을 위한 설명적 이름
    • URL: 엔드포인트 URL (HTTPS여야 함)
    • 이벤트: 구독할 이벤트 선택
    • 시크릿: 검증용 선택적 서명 시크릿
  4. 저장 및 테스트

웹훅 구성


이벤트 유형

CloudThinker 전반에 걸쳐 이벤트를 구독할 수 있습니다.

권장 사항 이벤트

인시던트 이벤트

보안 이벤트

작업 이벤트

에이전트 이벤트

리소스 이벤트


웹훅 페이로드

각 웹훅은 표준화된 페이로드를 포함합니다.

페이로드 필드


보안

서명 검증

웹훅 시크릿을 구성하면 CloudThinker가 각 페이로드에 서명합니다.
엔드포인트에서 서명을 검증하세요.

IP 허용 목록

CloudThinker 웹훅은 알려진 IP 범위에서 발송됩니다. 방화벽 규칙 구성을 위한 현재 IP 목록은 지원팀에 문의하세요.

HTTPS 전용

웹훅 URL은 HTTPS를 사용해야 합니다. 프로덕션 환경에서는 자체 서명 인증서가 지원되지 않습니다.

재시도 로직

CloudThinker는 전달에 실패한 웹훅을 재시도합니다.

재시도 일정

성공 기준

엔드포인트가 다음을 반환하면 전달 성공으로 간주합니다.
  • HTTP 2xx 상태 코드
  • 30초 이내 응답

실패 처리

모든 재시도 실패 후:
  • 이벤트가 실패로 표시됩니다
  • (구성된 경우) 알림이 전송됩니다
  • 이벤트는 웹훅 로그에서 확인 가능합니다

웹훅 관리

웹훅 테스트

실제 사용 전에 웹훅 전달을 테스트하세요.
  1. 설정에서 웹훅 선택
  2. 테스트 이벤트 전송 클릭
  3. 이벤트 유형 선택
  4. 전달 상태 및 페이로드 확인

로그 보기

웹훅 활동을 모니터링하세요.
  1. 설정 > Webhooks > 로그로 이동
  2. 전달 시도 확인
  3. 요청/응답 세부 정보 확인
  4. 상태, 이벤트 유형, 날짜로 필터링

웹훅 일시 중지

웹훅을 일시적으로 비활성화하려면:
  1. 웹훅 선택
  2. 활성 토글을 끄기로 설정
  3. 일시 중지 기간 동안 발생한 이벤트는 대기열에 저장되지 않습니다

웹훅 템플릿

일반적인 연동에 템플릿을 사용하세요.

Slack

Slack 채널에 이벤트 게시:

Jira

CloudThinker 이벤트로 Jira 티켓 생성:

PagerDuty

PagerDuty 인시던트 트리거:

모범 사례

웹훅 시크릿을 사용하고 서명을 검증하여 요청이 CloudThinker에서 발송된 것임을 확인하세요.
즉시 2xx 응답을 반환하고 이벤트는 비동기적으로 처리하세요. 처리가 오래 걸리면 타임아웃이 발생합니다.
웹훅 전달이 간헐적으로 중복될 수 있습니다. 이벤트 id를 사용하여 수신 측에서 중복을 제거하세요.
웹훅 실패에 대한 알림을 설정하세요. 이벤트 누락을 방지하기 위해 문제를 신속히 조사하고 해결하세요.
필요한 이벤트에만 구독하세요. 노이즈와 처리 오버헤드를 줄여줍니다.

연동 예시

GitHub Actions

CloudThinker 이벤트에서 워크플로 트리거:

AWS Lambda

서버리스 함수로 웹훅 처리:

관련 항목

인시던트 웹훅

PagerDuty, Datadog, Prometheus 등의 인바운드 웹훅으로 RCA 자동 트리거

작업 & 스케줄링

반복 작업 예약 및 이벤트 기반 워크플로 생성

알림

권장 사항, 인시던트, 보안 발견 항목에 대한 알림 라우팅 구성

자율 에이전트

에이전트가 수동 검토 없이 웹훅 이벤트에 자동으로 대응하도록 설정