Introduzione all'integrazione di Apigee e ai target di integrazione del proxy Apigee

Stai visualizzando la documentazione di Apigee X.
Visualizza la documentazione di Apigee Edge.

Questo tutorial mostra come utilizzare la procedura guidata del proxy Apigee X per creare un proxy con un target di integrazione. Il proxy utilizza un riferimento trigger dell'API da un'integrazione esistente per avviare la sequenza di passaggi nell'integrazione.

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

Prima di iniziare

  • Conferma le credenziali di accesso Apigee e i dettagli dell'organizzazione. Queste informazioni sono necessarie per accedere alla funzionalità di integrazione di Apigee e alla procedura guidata per il proxy all'interno dell'interfaccia utente di Apigee.
  • Crea e pubblica un'integrazione con un'attivatore API e almeno una attività.
    • Se non hai ancora creato un'integrazione che utilizza un attivatore API, segui i passaggi descritti nella guida introduttiva ad Apigee Integration.
    • Prendi nota del nome dell'integrazione creata o dell'integrazione esistente che vorresti utilizzare, in quanto verrà utilizzata in un passaggio successivo.
  • Conferma il tuo account di servizio service-GCP_PROJECT_NUMBER @gcp-sa-apigee.iam.gserviceaccount.com e verifica se sono stati assegnati i ruoli IAM richiesti per eseguire o richiamare un'integrazione. Per informazioni sui ruoli richiesti, consulta Ruoli IAM per le integrazioni.

Crea un proxy di destinazione di integrazione Apigee

Per creare un proxy di Target di integrazione nell'interfaccia utente di Apigee, procedi nel seguente modo:

  1. Vai alla UI di Apigee ed esegui l'accesso.
  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 Develop > API Proxys nel menu di navigazione a sinistra.

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

    Viene avviata la procedura guidata di creazione del proxy.

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

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

    • Percorso base: completato automaticamente in base al nome del proxy.

      Il Percorso base fa parte dell'URL utilizzato per effettuare richieste all'API. Apigee utilizza l'URL per abbinare e instradare le richieste in entrata al proxy API appropriato.

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

      Ad esempio, Proxy test for Apigee Integration.

    • Integrazione di destinazione: seleziona il nome dell'integrazione dall'elenco a discesa.
    • Trigger: seleziona dall'elenco a discesa l'attivatore API associato all'integrazione.
    • Tipo di endpoint: seleziona Sincronizzazione.
  8. Tocca Avanti.
  9. Nella pagina di configurazione dei criteri comuni, lascia le selezioni predefinite e fai clic su Avanti.
  10. Nella pagina Riepilogo, fai clic su Crea.

    Il proxy Integrazione di destinazione è stato creato.

Esegui il deployment del proxy

Per eseguire il deployment del proxy appena creato:

  1. Nella UI di Apigee, seleziona Develop > API Proxies nel menu di navigazione a sinistra.
  2. Fai clic sul proxy creato di recente.

    Per impostazione predefinita, l'interfaccia utente mostra la scheda Panoramica relativa al proxy nell'editor proxy.

  3. Fai clic sulla scheda Sviluppo.
  4. Fai clic su Esegui il deployment in: ENVIRONMENT_NAME.

    Viene visualizzata una finestra di dialogo di conferma per il deployment.

  5. Inserisci il tuo account di servizio nella finestra di dialogo di conferma e fai clic su Esegui il deployment

Testare il proxy di integrazione dell'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 per un gruppo di ambiente che contiene l'ambiente in cui viene eseguito il deployment del proxy. Consulta la sezione Individuare il nome host del gruppo di ambiente.

Ad esempio: 

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

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

  1. Apri l'interfaccia utente di Apigee.
  2. Fai clic su Develop > Integrations (Sviluppa).
  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.

Aggiorna il payload della richiesta di proxy (facoltativo)

Per aggiornare il payload della richiesta di proxy, procedi nel seguente modo:

  1. Nella UI di Apigee, seleziona Develop > API Proxies nel menu di navigazione a sinistra.
  2. Fai clic sul proxy creato di recente.

    Per impostazione predefinita, l'interfaccia utente mostra la scheda Panoramica relativa al proxy nell'editor proxy.

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

    Per specificare 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 Designer di integrazione e comprendi i vari concetti di integrazione descritti in Tutti i concetti.