Webhooks

Ein Webhook stellt ein Serviceziel dar, in dem eine eingehende Benachrichtigung programmgesteuert verarbeitet werden kann. Beispielsweise kann eine eingehende Benachrichtigung über ein Ereignis einen Webhook-Empfänger an einen Backend-Mikroservice auslösen, der dann entsprechend dem Inhalt der eingehenden Benachrichtigung reagiert.

Webhook-Ziel konfigurieren

Auf der Registerkarte „Ziele“ können Sie ein Webhook-Ziel konfigurieren. Geben Sie im Rahmen der Konfiguration die Webhook-URL und das REST-API-Verb ein, das beim Aufruf des Webhooks aufgerufen werden soll. Sie können auch Autorisierungsheader für den Ziel-Webhook eingeben. Erstellen Sie ein Abonnement, um das Webhook-Ziel einem Thema zuzuordnen.

Unterstützte HTTP Verben

Event Notifications webhooks unterstützen die http-Verben GET, POST, PUT und PATCH.

  • GET : Ruft eine Darstellung der angegebenen Ressource ab.
  • POST: Erstellt eine neue Ressource.
  • PUT : Ersetzt die gesamte Ressource durch die angegebenen Daten.
  • PATCH : Wendet partielle Änderungen an einer Ressource an.

Webhook-Signierung

Um festzustellen, ob die eingehende Benachrichtigung von IBM Cloud Event Notifications stammt, können Sie die Webhook-Signierung aktivieren. Wenn die Signaturfunktion aktiviert ist, kann ein öffentlicher Schlüssel heruntergeladen und zur Entschlüsselung des Inhalts der eingehenden Benachrichtigung verwendet werden.

Auflistung der IP-Adressen zulassen

Sie können die IP-Adressbereiche auf die Whitelist setzen, um den Zugriff auf die Server, die Webhooks empfangen, einzuschränken. Stellen Sie sicher, dass die folgenden IP-Adressen alle auf der Zulassungsliste stehen:

Bestehende Webhook-IP-Adressen

Gültig bis Ende September 2026. Siehe IP-Adressen der Webhooks.

Neue IP-Adressen

Gültig ab dem 29. August 2026:

  • Globale gemeinsame IP-Adressen: Siehe „ Individuelle IP-Adressen für Regionen mit mehreren Zonen “.

  • Regionsspezifische IP-Adressen: Fügen Sie die IP-Adressen der Region, in der Ihre „ Event Notifications “-Serviceinstanz bereitgestellt ist, zur Whitelist hinzu. Wenn Sie Instanzen des Dienstes „ Event Notifications “ in mehreren Regionen nutzen, fügen Sie die IP-Adressen der jeweiligen Regionen zur Whitelist hinzu.

Dallas (us-south)

  • Öffentliche
   52.118.150.206
   52.118.211.163
   67.18.95.240
   ```
- Privat

  10.22.12.198
  10.22.26.163
  10.119.56.147
  ```

Sydney (au-syd)

  • Öffentliche
   159.23.97.10
   130.198.9.234
   135.90.131.19
   ```
- Privat

  10.223.237.137
  10.51.176.13
  10.223.253.235
  ```

London (eu-gb)

  • Öffentliche
   158.176.171.145
   158.175.189.21
   141.125.162.123
   ```
- Privat

  10.16.48.81
  10.16.62.205
  10.223.21.154
  ```

Madrid (eu-es)

  • Öffentliche
   13.121.86.163
   13.122.88.117
   13.120.93.85
   ```
- Privat

  10.22.177.232
  10.22.195.222
  10.22.202.91
  ```

Frankfurt (eu-de)

  • Öffentliche
   149.81.4.209
   149.81.212.50
   158.176.1.49
   ```
- Privat

  10.16.206.123
  10.22.112.128
  10.16.216.36
  ```

Osaka (jp-osa)

  • Öffentliche
   163.68.88.77
   163.69.84.115
   163.73.93.115
   ```
- Privat

  10.12.21.131
  10.12.33.173
  10.12.38.219
  ```

Tokio (jp-tok)

  • Öffentliche
   165.192.134.77
   162.133.141.117
   128.168.131.96
   ```
- Privat

  10.223.197.48
  10.223.201.138
  10.223.213.141
  ```

Toronto (ca-tor)

  • Öffentliche
   163.74.90.220
   163.75.87.40
   163.66.93.241
   ```
- Privat

  10.223.149.61
  10.223.166.200
  10.223.182.99
  ```

Montreal (ca-mon)

  • Öffentliche
   64.5.42.20
   64.5.48.239
   64.5.44.233
   ```
- Privat

  10.46.73.140
  10.46.77.140
  10.46.81.140
  ```

Sao Paulo (br-sao)

  • Öffentliche
   13.116.82.0
   163.107.92.208
   163.109.92.155
   ```
- Privat

  10.12.183.145
  10.12.71.56
  10.51.193.111
  ```

Washington DC (us-east)

  • Öffentliche
   52.117.124.52
   169.63.177.17
   150.239.80.160
   ```
- Privat

  10.22.41.152
  10.22.50.51
  10.12.118.230
  ```

Chennai (in-che)

  • Öffentliche
   169.38.17.66
   169.38.9.38
   169.38.13.18
   ```
- Privat

  10.46.128.179
  10.46.132.179
  10.46.136.179
  ```

Mumbai (in-mum)

  • Öffentliche
   169.38.211.191
   169.38.236.49
   169.38.42.162
   ```
- Privat

  10.223.94.240
  10.223.103.208
  10.249.119.171
  ```

Richtlinie für Webhook-Neuversuche

Beim Aufrufen eines Webhooks können Probleme wie Netzwerkfehler und Anwendungsstörungen dazu führen, dass die Anfragen fehlschlagen. Event Notifications versucht automatisch, fehlgeschlagene Anfragen zu wiederholen, um die Ausfallsicherheit bei externen Anfragen zu gewährleisten.

Ausführliche Informationen zum Wiederholungsverhalten, einschließlich Wiederholungsversuchen, Verzögerungen und Timeout-Werten, finden Sie unter Wiederholungsrichtlinie für Ziele.

Testen einer Webhook-Zielkonfiguration

Sie können ein Webhook-Ziel im Optionsmenü testen. Mit einem einzigen Klick können Sie prüfen, ob die angegebene Konfiguration für ein Ziel korrekt ist oder nicht.

Weitere Informationen zum Testen eines Ziels finden Sie unter Testen von Zielen.