Webhook

Il connettore webhook ti consente di rimanere in ascolto degli eventi del backend. Questo connettore è progettato per essere utilizzato con il trigger webhook. Per utilizzare il trigger webhook nell'integrazione, devi prima configurare un connettore webhook.

Prima di iniziare

Prima di utilizzare il connettore webhook, svolgi i seguenti passaggi:

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

      Per informazioni su come abilitare i servizi, vedi Abilitazione dei servizi.

    • Concedi i seguenti ruoli IAM all'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 autenticarsi ed essere autorizzato ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Per saperne di più, consulta la pagina sulla creazione di un account di servizio.

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

Configura il connettore

Per configurare il connettore è necessario creare una connessione all'origine dati (sistema di backend). Una connessione è specifica per un'origine dati. Ciò significa che se disponi di molte origini dati, devi creare una connessione separata per ciascuna. Per creare una connessione, segui questi passaggi:

  1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

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

      Per l'elenco di tutte le regioni supportate, vedi Località.

    2. Tocca Avanti.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona Webhook dall'elenco a discesa dei connettori disponibili.
    2. Versione 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 superare i 63 caratteri.
    4. Descrizione: (facoltativo) inserisci una descrizione per l'istanza della connessione.
    5. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
    6. Event Subscription: la sottoscrizione all'evento verrà attivata 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. Tocca Avanti.
  5. Nella sezione Dettagli abbonamento evento, completa i seguenti passaggi:
    1. Autenticazione listener: seleziona un tipo di autenticazione per il listener di eventi e inserisci i dettagli pertinenti.

      Il listener webhook supporta i seguenti tipi di autenticazione:

    2. Posizione 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 del tipo di evento: il campo obbligatorio nella posizione configurata identifica il tipo di evento associato alla richiesta di evento in arrivo.
      4. {
"event_type": "user.created",
...
// other request fields
...
}
      Nell'esempio precedente, il campo event_type nel corpo della richiesta indica che la richiesta riguarda un evento "user.created".
    4. Seleziona Abilita connettività privata per la connettività sicura tra l'applicazione di backend e la connessione. Se selezioni questa opzione, devi eseguire ulteriori passaggi di configurazione dopo aver creato la connessione. Per saperne di più, consulta Connettività privata per la sottoscrizione agli eventi.
    5. Inserisci la configurazione messaggi non recapitabili. Se configuri i messaggi non recapitabili, la connessione scrive gli eventi non elaborati nell'argomento Pub/Sub specificato. Inserisci i seguenti dettagli:
      1. ID progetto messaggi non recapitabili: l'ID progetto Google Cloud in cui hai configurato l'argomento Pub/Sub messaggi non recapitabili.
      2. Argomento messaggi non recapitabili: l'argomento Pub/Sub in cui vuoi scrivere i dettagli dell'evento non elaborato.
    6. Tocca Avanti.
  6. Verifica: controlla i dettagli di autenticazione della connessione e degli ascoltatori.
  7. Fai clic su Crea.

Utilizzare la connessione webhook in un'integrazione

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

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

Ricevi assistenza dalla community Google Cloud

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

Passaggi successivi