Iniziare a utilizzare Application Integration e i target di integrazione del proxy Apigee

Questo tutorial mostra come utilizzare la procedura guidata per i proxy di Apigee per creare un proxy con un target di integrazione. Il proxy utilizza un riferimento all'attivatore dell'API di un'integrazione esistente per avviare la sequenza di passaggi dell'integrazione.

I passaggi riportati di seguito descrivono come configurare il proxy Target di integrazione per eseguire un'integrazione riuscita quando viene chiamato.

Prima di iniziare

  • Conferma le credenziali di accesso ad Apigee e i dettagli dell'organizzazione. Queste informazioni sono necessarie per accedere alla funzionalità di integrazione delle applicazioni e alla procedura guidata del proxy nell'interfaccia utente di Apigee.
  • Crea e pubblica un'integrazione con un trigger API e almeno un'attività.
    • Se non hai ancora creato un'integrazione che utilizza un trigger API, segui i passaggi descritti in Recupera il payload dell'API e invia un'email.
    • Prendi nota del nome dell'integrazione che crei o dell'integrazione esistente che vuoi utilizzare, poiché verrà utilizzata in un passaggio successivo.
  • Crea un service account Google nello stesso progetto Google Cloud in cui è stata creata la tua organizzazione Apigee ed esegui le seguenti operazioni:
    • Assegna il ruolo Appelante integrazione dell'applicazione (roles/integrations.applicationIntegrationInvokerRole) all'account di servizio. Per informazioni sui ruoli di integrazione delle applicazioni predefiniti, consulta Ruoli IAM predefiniti.
    • Consenti al tuo account utente (principale) di collegare gli account di servizio alle risorse con l'autorizzazione iam.serviceAccounts.actAs. Per informazioni sulle autorizzazioni degli account di servizio, consulta Ruoli per l'autenticazione degli account di servizio .

    Devi fornire questo account di servizio quando esegui il deployment del proxy API.

  • Se vuoi utilizzare le integrazioni di applicazioni senza limitazioni, puoi pagare per le integrazioni. L'integrazione delle applicazioni è disponibile come servizio aggiuntivo per il tuo abbonamento. Se hai già acquistato il diritto di integrazione delle applicazioni e vuoi attivarlo per il tuo progetto Google Cloud o la tua organizzazione Apigee, contatta l'assistenza Apigee. Tuttavia, se vuoi acquistare il diritto di integrazione delle applicazioni, contatta il team di vendita di Apigee. Dopo che l'integrazione delle applicazioni è stata attivata per te, svolgi le seguenti attività:
    1. Abilita le seguenti API:
      • API Apigee (apigee.googleapis.com)
      • API Application Integration (integrations.googleapis.com)
      • API Secret Manager (secretmanager.googleapis.com)
      • API Connectors (connectors.googleapis.com)

      Per informazioni su come attivare le API, consulta Attivare i servizi.

    2. Attiva i componenti aggiuntivi Integration e Connectors per la tua organizzazione Apigee.

      • Se stai creando una nuova organizzazione da utilizzare per l'integrazione, esegui il seguente comando:

        curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" -d '{"name":"${ORG_ID}", "analyticsRegion":"us-west1", "authorized_network":"${NETWORK_ID}", "runtimeType":"CLOUD", "runtimeDatabaseEncryptionKeyName":"${ENCRYPTION_KEY_NAME}", "addonsConfig": {"integrationConfig": {"enabled": true}, "connectorsPlatformConfig":{"enabled":true}}}' "https://apigee.googleapis.com/v1/organizations?parent=projects/${PROJECT_ID}"

      • Se utilizzi un'organizzazione esistente, esegui il seguente comando:

        curl -H "Authorization: Bearer $TOKEN" -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}:setAddons" -XPOST -d '{"addonsConfig":{"integrationConfig":{"enabled":true},"connectorsPlatformConfig":{"enabled":true}}}'
    3. Verifica se i componenti aggiuntivi sono stati attivati correttamente utilizzando il seguente comando:

      curl -H "Authorization: Bearer $TOKEN"  -H "content-type:application/json" "https://apigee.googleapis.com/v1/organizations/${ORG_ID}"

      L'esecuzione del comando dovrebbe visualizzare un messaggio simile al seguente:

      {
  "name": "Test....",
  "createdAt": "1615483867669",
  "lastModifiedAt": "1615483873468",
  …...
  "addonsConfig": {
    "integrationConfig": {
      "enabled": true,
    "connectorsPlatformConfig": {
      "enabled": true
    }
  }
  }
    4. Assegna i seguenti ruoli IAM al tuo account di servizio Apigee predefinito(service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com):
      • Application Integration Invoker (roles/integrations.applicationIntegrationInvokerRole)

      Per informazioni su come concedere ruoli o autorizzazioni aggiuntivi a un account di servizio, consulta Concedere, modificare e revocare l'accesso.

Crea un proxy di destinazione per l'integrazione di applicazioni

Per creare un proxy Target di integrazione nell'interfaccia utente di Apigee:

  1. Vai alla UI Apigee e accedi.
  2. Seleziona la tua organizzazione utilizzando il menu a discesa nell'angolo in alto a sinistra dell'interfaccia utente.
  3. Fai clic su Proxy API nella visualizzazione principale.

    In alternativa, puoi selezionare Sviluppa > Proxy API nel menu di navigazione a sinistra.

  4. Nell'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi creare un nuovo proxy API.
  5. Fai clic su Crea nuova.
  6. Seleziona Target di integrazione dalla visualizzazione dei tipi di proxy.

    Viene avviata la procedura guidata Crea proxy.

  7. Nella pagina di configurazione Dettagli del proxy, fornisci i seguenti dettagli:
    • Nome: inserisci un nome per il proxy.

      I nomi dei proxy possono contenere caratteri alfanumerici, trattini e trattini bassi.

    • Percorso base: viene compilato automaticamente in base al nome del proxy.

      Il percorso base fa parte dell'URL utilizzato per inviare richieste all'API. Apigee utilizza l'URL per associare e instradare le richieste in entrata al proxy API corretto.

    • Descrizione: (facoltativo) inserisci una breve descrizione del proxy.

      Ad esempio, Proxy test for Application Integration.

    • Regione di integrazione: seleziona la regione dell'integrazione dall'elenco a discesa.
    • Destinazione dell'integrazione: seleziona il nome della destinazione dell'integrazione dall'elenco a discesa. Tieni presente che l'elenco dei target di integrazione viene compilato in base alla regione di integrazione selezionata.
    • Trigger: seleziona l'attivatore API associato all'integrazione dall'elenco a discesa.
    • Tipo di endpoint: seleziona Sincronizzazione.
  8. Fai clic su Avanti.
  9. Nella pagina di configurazione Criteri comuni, lascia le selezioni predefinite e fai clic su Avanti.
  10. Nella pagina Riepilogo, fai clic su Crea.

    Un proxy Destinazione dell'integrazione è stato creato correttamente.

Esegui il deployment del proxy

Per eseguire il deployment del proxy appena creato:

  1. Nell'interfaccia utente di Apigee, seleziona Sviluppa > Proxy API.

    L'interfaccia utente mostra un elenco di proxy API e il relativo stato di implementazione.

  2. Nell'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi eseguire il deployment del proxy API.

  3. Fai clic sul proxy creato di recente di cui vuoi eseguire il deployment. Per impostazione predefinita, la UI mostra la pagina Panoramica.

  4. Per eseguire il deployment delle modifiche, fai prima clic su Esegui il deployment per visualizzare la finestra di dialogo Esegui il deployment.
  5. Inserisci quanto segue:
    • Revisione: il numero di revisione del proxy che vuoi implementare.
    • Ambiente: l'ambiente in cui vuoi eseguire il deployment del proxy.
    • Account di servizio: l'account di servizio creato per il proxy.
  6. Fai clic su Esegui il deployment.

L'interfaccia utente avvia il processo di implementazione della revisione selezionata. Il completamento del deployment del proxy può richiedere fino a un minuto.

Quando il proxy viene disegnato, la colonna Stato nella sezione Deployment mostra un'icona verde per indicare che è stata implementata la revisione 1 del proxy.

Testa il proxy del target di integrazione

Esegui il seguente comando dalla finestra del terminale per richiamare il proxy e attivare l'integrazione: 

curl -v https://YOUR_ENV_GROUP_HOSTNAME/PROXY_NAME

dove YOUR_ENV_GROUP_HOSTNAME è il nome host di un gruppo di ambienti che contiene l'ambiente in cui è dipiegato il proxy.

Ad esempio: 

curl -v https://my-org-prod.hybrid.e2e.apigeeks.net/my-proxy

Per verificare che l'integrazione sia stata attivata chiamando il proxy:

  1. Apri l'interfaccia utente di Apigee.
  2. Fai clic su Sviluppa > Integrazioni.
  3. Cerca o seleziona il nome dell'integrazione creata nei passaggi precedenti e fai clic sul nome dell'integrazione.
  4. Fai clic su Log.
  5. Verifica che esista un log di esecuzione per l'integrazione attivata. Per visualizzare i dettagli del log, fai clic sulla riga per espandere i dettagli dell'esecuzione.

(Facoltativo) Aggiorna il payload della richiesta proxy

Per aggiornare il payload della richiesta proxy:

  1. Nell'interfaccia utente di Apigee, seleziona Sviluppa > Proxy API nel menu di navigazione a sinistra.
  2. Fai clic sul proxy creato di recente.

    Per impostazione predefinita, l'interfaccia utente mostra la scheda Panoramica per il proxy in Editor proxy.

  3. Fai clic sulla scheda Sviluppa.
  4. Nel riquadro Navigator, seleziona Imposta richiesta di integrazione sotto l'intestazione Criteri.
  5. Rimuovi il commento dal blocco <Parameters> e inserisci i dettagli del parametro.

    Per specificare i singoli parametri, utilizza l'elemento <Parameter>. Per specificare gli array di parametri, utilizza l'elemento <ParameterArray>.

  6. Fai clic su Salva.

Passaggi successivi

Esplora il layout del designer di integrazione e comprendi i vari concetti di integrazione descritti in Tutti i concetti.