Webhook

Il connettore webhook ti consente di rimanere in ascolto degli eventi del backend che supporta i webhook. Questo connettore è progettato per essere utilizzato con il trigger webhook. Il trigger webhook riceve eventi da applicazioni SaaS di terze parti che supportano la funzionalità di eventi webhook. Questo trigger supporta più tipi di autenticazione per il listener di eventi. Per utilizzare il trigger webhook nell'integrazione, devi prima configurare un connettore webhook.

Prima di iniziare

Prima di utilizzare il connettore webhook, esegui le seguenti attività:

  • Nel progetto Google Cloud:
    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Per comprendere come abilitare i servizi, consulta Abilitare i servizi.

    • Concedi i seguenti ruoli IAM al account di servizio che vuoi utilizzare per il connettore:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente "non umano" che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Il connettore e il account di servizio devono appartenere allo stesso progetto. Per ulteriori informazioni, consulta Creare un service account.

    Se questi servizi o autorizzazioni non sono stati abilitati in precedenza per il tuo progetto, ti verrà chiesto di farlo durante la configurazione del connettore.

Configurare il connettore

Una connessione è specifica per un'origine dati. Ciò significa che, se hai molte origini dati, devi creare una connessione separata per ciascuna di esse. Per creare una connessione:

  1. Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
  3. Nella sezione Località, scegli la località per la connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Per un elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona Webhook dall'elenco a discesa dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
    3. Nome connessione: inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono contenere più di 49 caratteri.
      • Per i connettori che supportano la sottoscrizione agli eventi, i nomi delle connessioni non possono iniziare con il prefisso "goog".
    4. Descrizione: facoltativamente, inserisci una descrizione per l'istanza di connessione.
    5. Service account: seleziona un account di servizio con i ruoli richiesti.
    6. Sottoscrizione agli eventi: la sottoscrizione agli eventi è abilitata per impostazione predefinita ed è obbligatoria per il connettore webhook.
    7. (Facoltativo) Fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave-valore.
    8. Fai clic su Avanti.
  5. Nella sezione Dettagli sottoscrizione agli eventi, completa quanto segue:
    1. Autenticazione del listener: seleziona un tipo di autenticazione per il listener di eventi e inserisci i dettagli pertinenti.

      I seguenti tipi di autenticazione sono supportati dal listener webhook:

    2. Posizione del campo Tipo di evento: campo obbligatorio che indica la posizione (intestazione, parametro di query o corpo della richiesta) in cui sarà presente il tipo di evento associato alla richiesta di evento in entrata.
    3. Nome del campo Tipo di evento: campo obbligatorio nella località configurata che identifica il tipo di evento associato alla richiesta di evento in entrata.
      4. {
"event_type": "user.created",
...
// other request fields
...
}
       Nell'esempio sopra, il campo event_type nel corpo della richiesta indica che la richiesta riguarda un evento "user.created".
    4. Seleziona Abilita connettività privata per una connettività sicura tra l'applicazione di backend e la connessione. Se selezioni questa opzione, devi eseguire passaggi di configurazione aggiuntivi dopo aver creato la connessione. Per ulteriori informazioni, consulta Connettività privata per la sottoscrizione agli eventi.
    5. Inserisci la configurazione della coda di messaggi non recapitabili. Se configuri la coda di messaggi non recapitabili, la connessione scrive gli eventi non elaborati nell'argomento Pub/Sub specificato. Inserisci i seguenti dettagli:
      1. ID progetto coda di messaggi non recapitabili: l'ID progetto Google Cloud in cui hai configurato l'argomento Pub/Sub della coda di messaggi non recapitabili.
      2. Argomento messaggi non recapitabili : l'argomento Pub/Sub in cui vuoi scrivere i dettagli dell'evento non elaborato.
    6. Fai clic su Avanti.
  6. Revisione: esamina i dettagli di autenticazione della connessione e del listener.
  7. Fai clic su Crea.

Utilizzare la connessione webhook in un'integrazione

Dopo aver creato la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per comprendere come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
  • Per comprendere come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Ricevere assistenza dalla community di Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.

Passaggi successivi