이 페이지는 Confluence에서 생성/변경/삭제 등 변경을 외부 시스템에 알리는 방법 중 하나인 WebHook 구성에 대해 정리한다.

Overview

웹훅을 사용하면 Confluence에서 특정 이벤트가 발생했을 때 애플리케이션이나 기타 외부 서비스에 알림을 보낼 수 있다.

웹훅은 다음으로 구성된다.

  • 하나 이상의 이벤트 - 페이지 생성, 공간 삭제 등 웹훅이 트리거될 여러 이벤트를 선택할 수 있다.
  • URL - 선택한 이벤트가 발생할 때 Confluence가 이벤트 페이로드를 보낼 엔드포인트.

Confluence는 이러한 이벤트를 수신하고 이벤트 페이로드를 JSON형식으로 지정한 URL로 전송한다.

Webhook 등록

웹훅을 생성하려면 Confluence 관리자 또는 시스템 관리자 글로벌 권한이 필요하다.

Webhook 등록 절차

  1. Administration menu > General Configuration > Webhooks로 이동
  2. Webhook 만들기 
    1. Webhook의 이름 입력
    2. Webhook을 전송할 URL 입력
    3. Webhook Secret 입력 (Optional)
      1. 메시지 페이로드 유효성 인증을 위한 HMAC 알고리즘 비밀 키
    4. Test Connection 선택
    5. Webhook Trigger할 이벤트 선택
    6. Webhook 활성화 여부 선택

Webhook 생성 예시 스크린샷

Webhook 수행

Event 발생

등록된 Webhook의 event 조건이 만족되면 수행된다.

정보 전송

정보는 JSON 형식으로 전송된다.


{
  "timestamp": 1763515126565,
  "event": "page_created",
  "userKey": "8a8081219908a36b019926eb54390001",
  "page": {
    "id": 80707659
  }
}

Webhook event 종류

https://confluence.atlassian.com/doc/managing-webhooks-1021225606.html Triggering webhooks 참고

참고 문서



  • 레이블 없음