Webhooks

Un webhook représente une destination de service, où une notification entrante peut être consommée à l'aide d'un programme. Par exemple, une notification reçue concernant un événement peut déclencher l'envoi d'un webhook vers un microservice backend afin que celui-ci agisse en fonction du contenu de cette notification.

Configuration d'une destination webhook

Vous pouvez configurer une destination de webhook dans l'onglet « Destinations ». Lors de la configuration, entrez l'URL du webhook et l'instruction API REST à appeler lorsque le webhook est appelé. Vous pouvez également entrer des en-têtes d'autorisation dans le webhook de destination. Créez un abonnement pour associer la destination webhook à une rubrique.

HTTP Verbes pris en charge

Event Notifications les webhooks prennent en charge les verbes http GET, POST, PUT et PATCH.

  • GET : Récupère une représentation de la ressource spécifiée.
  • POST : Crée une nouvelle ressource.
  • PUT : remplace l'ensemble de la ressource par les données fournies.
  • PATCH : Applique des modifications partielles à une ressource.

Signature de webhook

Pour identifier que la notification entrante provient de IBM Cloud Event Notifications, vous pouvez activer la signature du webhook. Si la signature est activée, une clé publique peut être téléchargée et utilisée pour déchiffrer le contenu de la notification reçue.

Autoriser la liste des adresses IP

Vous pouvez ajouter des plages d'adresses IP à la liste blanche afin de limiter l'accès aux serveurs qui reçoivent les webhooks. Assurez-vous que les adresses IP suivantes figurent toutes sur la liste blanche :

Adresses IP des webhooks existants

Valable jusqu'à fin septembre 2026. Consultez les adresses IP des webhooks.

Nouvelles adresses IP

À compter du 29 août 2026 :

  • Adresses IP communes à l'échelle mondiale: voir « Adresses IP individuelles » pour les régions comportant plusieurs zones.

  • Adresses IP spécifiques à une région: ajoutez à la liste blanche les adresses IP de la région dans laquelle votre instance du service « Event Notifications » est déployée. Si vous utilisez des instances du service « Event Notifications » dans plusieurs régions, ajoutez les adresses IP de chaque région concernée à la liste blanche.

Dallas (us-south)

  • Public
   52.118.150.206
   52.118.211.163
   67.18.95.240
   ```
- Privé

  10.22.12.198
  10.22.26.163
  10.119.56.147
  ```

Sydney (au-syd)

  • Public
   159.23.97.10
   130.198.9.234
   135.90.131.19
   ```
- Privé

  10.223.237.137
  10.51.176.13
  10.223.253.235
  ```

Londres (eu-gb)

  • Public
   158.176.171.145
   158.175.189.21
   141.125.162.123
   ```
- Privé

  10.16.48.81
  10.16.62.205
  10.223.21.154
  ```

Madrid (eu-es)

  • Public
   13.121.86.163
   13.122.88.117
   13.120.93.85
   ```
- Privé

  10.22.177.232
  10.22.195.222
  10.22.202.91
  ```

Francfort (eu-de)

  • Public
   149.81.4.209
   149.81.212.50
   158.176.1.49
   ```
- Privé

  10.16.206.123
  10.22.112.128
  10.16.216.36
  ```

Osaka (jp-osa)

  • Public
   163.68.88.77
   163.69.84.115
   163.73.93.115
   ```
- Privé

  10.12.21.131
  10.12.33.173
  10.12.38.219
  ```

Tokyo (jp-tok)

  • Public
   165.192.134.77
   162.133.141.117
   128.168.131.96
   ```
- Privé

  10.223.197.48
  10.223.201.138
  10.223.213.141
  ```

Toronto (ca-tor)

  • Public
   163.74.90.220
   163.75.87.40
   163.66.93.241
   ```
- Privé

  10.223.149.61
  10.223.166.200
  10.223.182.99
  ```

Montréal (ca-mon)

  • Public
   64.5.42.20
   64.5.48.239
   64.5.44.233
   ```
- Privé

  10.46.73.140
  10.46.77.140
  10.46.81.140
  ```

Sao Paulo (br-sao)

  • Public
   13.116.82.0
   163.107.92.208
   163.109.92.155
   ```
- Privé

  10.12.183.145
  10.12.71.56
  10.51.193.111
  ```

Washington DC (États-Unis - est)

  • Public
   52.117.124.52
   169.63.177.17
   150.239.80.160
   ```
- Privé

  10.22.41.152
  10.22.50.51
  10.12.118.230
  ```

Chennai (in-che)

  • Public
   169.38.17.66
   169.38.9.38
   169.38.13.18
   ```
- Privé

  10.46.128.179
  10.46.132.179
  10.46.136.179
  ```

Mumbai (in-mum)

  • Public
   169.38.211.191
   169.38.236.49
   169.38.42.162
   ```
- Privé

  10.223.94.240
  10.223.103.208
  10.249.119.171
  ```

Règle de relance de webhook

Lors de l'appel d'un webhook, des problèmes tels que des erreurs de réseau et des pépins d'application peuvent entraîner l'échec des demandes. Event Notifications relance automatiquement les demandes qui ont échoué afin d'assurer la résilience des demandes externes.

Pour obtenir des informations détaillées sur le comportement des tentatives, y compris les tentatives, les délais et les valeurs de temporisation, voir Politique de réessai pour les destinations.

Test de la configuration de la destination d'un webhook

Vous pouvez tester une destination de webhook dans le menu des options. Vous pouvez vérifier, d'un simple clic, si la configuration fournie est correcte pour une destination donnée.

Pour plus d'informations sur le test d'une destination, voir Test des destinations.