Webhook

Un webhook rappresenta una destinazione del servizio, in cui una notifica in entrata può essere utilizzata in modo programmatico. Ad esempio, una notifica in entrata relativa a un evento può attivare una destinazione webhook per un microservizio di back - end in modo che agisca in base al contenuto della notifica in entrata.

Configurazione di una destinazione webhook

È possibile configurare una destinazione webhook nella scheda " Destinazioni ". Come parte della configurazione, inserire il webhook URL e il verbo API REST da chiamare quando viene chiamato il webhook. Puoi anche immettere intestazioni di autorizzazione per il webhook di destinazione. Crea una sottoscrizione per associare la destinazione webhook a un argomento.

Verbi supportati HTTP

Event Notifications i webhook supportano i verbi http GET, POST, PUT e PATCH.

  • GET : Recupera una rappresentazione della risorsa specificata.
  • POST : crea una nuova risorsa.
  • PUT: sostituisce l'intera risorsa con i dati forniti.
  • PATCH : Applica modifiche parziali a una risorsa.

Firma webhook

Per identificare che la notifica in entrata proviene da IBM Cloud Event Notifications, puoi abilitare la firma webhook. Se la firma è abilitata, è possibile scaricare una chiave pubblica e utilizzarla per decodificare il contenuto della notifica in entrata.

Consentire l'elenco degli indirizzi IP

È possibile inserire gli intervalli di indirizzi IP nella lista bianca per limitare l'accesso ai server che ricevono i webhook. Assicurarsi che tutti i seguenti indirizzi IP siano inseriti nell'elenco dei permessi:

Indirizzi IP dei webhook esistenti

Valido fino alla fine di settembre 2026. Vedi gli indirizzi IP dei webhook.

Nuovi indirizzi IP

Con effetto dal 29 agosto 2026:

  • Indirizzi IP comuni a livello globale: Vedi Indirizzi IP individuali per le regioni con più zone.

  • Indirizzi IP specifici per regione: inserisci nella lista bianca gli indirizzi IP della regione in cui è distribuita l'istanza del servizio Event Notifications. Se si utilizzano istanze del servizi Event Notifications e in più regioni, è necessario inserire nella lista bianca gli indirizzi IP relativi a ciascuna regione interessata.

Dallas (us-south)

  • Pubblico
   52.118.150.206
   52.118.211.163
   67.18.95.240
   ```
- Privato

  10.22.12.198
  10.22.26.163
  10.119.56.147
  ```

Sydney (au-syd)

  • Pubblico
   159.23.97.10
   130.198.9.234
   135.90.131.19
   ```
- Privato

  10.223.237.137
  10.51.176.13
  10.223.253.235
  ```

Londra (eu-gb)

  • Pubblico
   158.176.171.145
   158.175.189.21
   141.125.162.123
   ```
- Privato

  10.16.48.81
  10.16.62.205
  10.223.21.154
  ```

Madrid (eu-es)

  • Pubblico
   13.121.86.163
   13.122.88.117
   13.120.93.85
   ```
- Privato

  10.22.177.232
  10.22.195.222
  10.22.202.91
  ```

Francoforte (eu-de)

  • Pubblico
   149.81.4.209
   149.81.212.50
   158.176.1.49
   ```
- Privato

  10.16.206.123
  10.22.112.128
  10.16.216.36
  ```

Osaka (jp-osa)

  • Pubblico
   163.68.88.77
   163.69.84.115
   163.73.93.115
   ```
- Privato

  10.12.21.131
  10.12.33.173
  10.12.38.219
  ```

Tokyo (jp-tok)

  • Pubblico
   165.192.134.77
   162.133.141.117
   128.168.131.96
   ```
- Privato

  10.223.197.48
  10.223.201.138
  10.223.213.141
  ```

Toronto (ca-tor)

  • Pubblico
   163.74.90.220
   163.75.87.40
   163.66.93.241
   ```
- Privato

  10.223.149.61
  10.223.166.200
  10.223.182.99
  ```

Montreal (ca-mon)

  • Pubblico
   64.5.42.20
   64.5.48.239
   64.5.44.233
   ```
- Privato

  10.46.73.140
  10.46.77.140
  10.46.81.140
  ```

San Paolo (br-sao)

  • Pubblico
   13.116.82.0
   163.107.92.208
   163.109.92.155
   ```
- Privato

  10.12.183.145
  10.12.71.56
  10.51.193.111
  ```

Washington DC (us-east)

  • Pubblico
   52.117.124.52
   169.63.177.17
   150.239.80.160
   ```
- Privato

  10.22.41.152
  10.22.50.51
  10.12.118.230
  ```

Chennai (in-che)

  • Pubblico
   169.38.17.66
   169.38.9.38
   169.38.13.18
   ```
- Privato

  10.46.128.179
  10.46.132.179
  10.46.136.179
  ```

Mumbai (in-mum)

  • Pubblico
   169.38.211.191
   169.38.236.49
   169.38.42.162
   ```
- Privato

  10.223.94.240
  10.223.103.208
  10.249.119.171
  ```

Politica di nuovi tentativi webhook

Quando si chiama un webhook, problemi come errori di rete e problemi di applicazione possono causare il fallimento delle richieste. Event Notifications riprova automaticamente le richieste non riuscite per fornire resilienza alle richieste esterne.

Per informazioni dettagliate sul comportamento dei tentativi di riprova, inclusi i tentativi di riprova, i ritardi e i valori di timeout, vedere Criteri di riprova per le destinazioni.

Verifica della configurazione di una destinazione webhook

È possibile testare una destinazione webhook dal menu delle opzioni. È possibile verificare se la configurazione fornita per una destinazione è corretta o meno con un solo clic.

Per ulteriori informazioni sulla verifica di una destinazione, vedere Verifica delle destinazioni.