웹훅

웹훅은 수신 알림을 프로그래밍 방식으로 이용할 수 있는 서비스 대상을 나타냅니다. 예를 들어, 이벤트에 대한 수신 알림이 발생하면 웹훅 수신처가 해당 알림의 내용을 바탕으로 백엔드 마이크로서비스가 조치를 취하도록 트리거할 수 있습니다.

webhook 대상 구성

[수신처 ] 탭에서 웹훅 수신처를 설정할 수 있습니다. 구성의 일부로 웹훅 URL과 웹훅을 호출하면 호출되는 REST API verb를 입력하십시오. 또한 대상 웹훅에 권한 헤더를 입력할 수도 있습니다. 웹훅 대상을 주제와 연관시키기 위한 구독을 작성하십시오.

지원되는 HTTP 동사

Event Notifications 웹훅은 http 동사 GET, POST, PUT 및 PATCH를 지원합니다.

  • GET : 지정된 리소스의 표현을 검색합니다.
  • POST : 새로운 리소스를 생성합니다.
  • PUT : 전체 리소스를 제공된 데이터로 대체합니다.
  • 패치: 리소스에 부분적인 수정 사항을 적용합니다.

웹훅 서명

수신 알림이 IBM Cloud Event Notifications에서 수신되는지 식별하기 위해 웹훅 서명을 사용할 수 있습니다. 서명이 활성화된 경우, 공개 키를 다운로드하여 수신된 알림 내용을 복호화하는 데 사용할 수 있습니다.

IP 주소 허용 목록

웹훅을 수신하는 서버에 대한 액세스를 제한하려면 해당 IP 주소 범위를 허용 목록에 추가할 수 있습니다. 다음 IP 주소가 모두 허용 목록에 포함되어 있는지 확인하십시오:

기존 웹훅 IP 주소

2026년 9월 말까지 유효합니다. 웹훅 IP 주소를 확인하세요.

새 IP 주소

2026년 8월 29일부터 시행:

  • 전역 공통 IP 주소: 다중 영역 지역의 경우 개별 IP 주소를 참조하십시오.

  • 지역별 IP 주소: Event Notifications 서비스 인스턴스가 배포된 지역의 IP 주소를 허용 목록에 추가하십시오. 여러 리전에서 Event Notifications 서비스 인스턴스를 사용하는 경우, 해당 리전별 IP 주소를 허용 목록에 추가하십시오.

댈러스(us-south)

  • 공용
   52.118.150.206
   52.118.211.163
   67.18.95.240
   ```
- 개인용

  10.22.12.198
  10.22.26.163
  10.119.56.147
  ```

시드니(au-syd)

  • 공용
   159.23.97.10
   130.198.9.234
   135.90.131.19
   ```
- 개인용

  10.223.237.137
  10.51.176.13
  10.223.253.235
  ```

런던(eu-gb)

  • 공용
   158.176.171.145
   158.175.189.21
   141.125.162.123
   ```
- 개인용

  10.16.48.81
  10.16.62.205
  10.223.21.154
  ```

마드리드 (eu-es)

  • 공용
   13.121.86.163
   13.122.88.117
   13.120.93.85
   ```
- 개인용

  10.22.177.232
  10.22.195.222
  10.22.202.91
  ```

프랑크푸르트(eu-de)

  • 공용
   149.81.4.209
   149.81.212.50
   158.176.1.49
   ```
- 개인용

  10.16.206.123
  10.22.112.128
  10.16.216.36
  ```

오사카(jp-osa)

  • 공용
   163.68.88.77
   163.69.84.115
   163.73.93.115
   ```
- 개인용

  10.12.21.131
  10.12.33.173
  10.12.38.219
  ```

도쿄(jp-tok)

  • 공용
   165.192.134.77
   162.133.141.117
   128.168.131.96
   ```
- 개인용

  10.223.197.48
  10.223.201.138
  10.223.213.141
  ```

토론토(ca-tor)

  • 공용
   163.74.90.220
   163.75.87.40
   163.66.93.241
   ```
- 개인용

  10.223.149.61
  10.223.166.200
  10.223.182.99
  ```

몬트리올 (ca-mon)

  • 공용
   64.5.42.20
   64.5.48.239
   64.5.44.233
   ```
- 개인용

  10.46.73.140
  10.46.77.140
  10.46.81.140
  ```

상파울루(br-sao)

  • 공용
   13.116.82.0
   163.107.92.208
   163.109.92.155
   ```
- 개인용

  10.12.183.145
  10.12.71.56
  10.51.193.111
  ```

워싱턴 DC(미국 동부)

  • 공용
   52.117.124.52
   169.63.177.17
   150.239.80.160
   ```
- 개인용

  10.22.41.152
  10.22.50.51
  10.12.118.230
  ```

Chennai (in-che)

  • 공용
   169.38.17.66
   169.38.9.38
   169.38.13.18
   ```
- 개인용

  10.46.128.179
  10.46.132.179
  10.46.136.179
  ```

뭄바이 (인-뭄)

  • 공용
   169.38.211.191
   169.38.236.49
   169.38.42.162
   ```
- 개인용

  10.223.94.240
  10.223.103.208
  10.249.119.171
  ```

웹훅 재시도 정책

웹훅을 호출할 때 네트워크 오류 및 애플리케이션 결함과 같은 문제로 인해 요청이 실패할 수 있습니다. Event Notifications 외부 요청에 대한 복원력을 제공하기 위해 실패한 요청을 자동으로 다시 시도합니다.

재시도 시도, 지연 및 시간 초과 값 등 재시도 동작에 대한 자세한 내용은 대상에 대한 재시도 정책을 참조하세요.

웹훅 대상 구성 테스트

옵션 메뉴에서 웹훅 수신처를 테스트할 수 있습니다. 한 번의 클릭만으로 대상에 대해 제공된 구성이 올바른지 여부를 확인할 수 있습니다.

대상 테스트에 대한 자세한 내용은 대상 테스트를 참조하세요.