Che cosa sono le estensioni?

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Puoi utilizzare le estensioni per integrare risorse esterne nei tuoi proxy API. Ad esempio, potresti integrare servizi Google Cloud come Google Cloud Storage. In fase di runtime, un proxy API utilizza l'estensione per scambiare richieste e risposte con la risorsa esterna.

Framework di runtime dell'estensione

In fase di runtime, un'estensione funge da intermediario, elaborando le richieste e le risposte tra un proxy API e una risorsa esterna.

Ecco una panoramica del funzionamento dell'elaborazione tramite un'estensione in fase di runtime.

  1. Una richiesta client raggiunge un proxy API e il relativo flusso di richieste procede attraverso le policy del proxy.
  2. Il flusso di richieste raggiunge una policy Extension Callout nel proxy configurata per passare i dati a un'estensione di cui è stato eseguito il deployment nell'ambiente. I dati includono i valori necessari per inviare una richiesta alla risorsa esterna rappresentata dall'estensione.
  3. L'estensione invia una richiesta alla risorsa esterna, quindi riceve una risposta.
  4. L'estensione restituisce la risposta alla policy Extension Callout, dove viene gestita dal codice del proxy.
  5. Il flusso di richieste continua attraverso il proxy finché non restituisce una risposta al client.

Utilizzo delle estensioni

Ogni estensione viene sviluppata e configurata tenendo presente una particolare risorsa esterna. Per utilizzare un'estensione, un amministratore di Apigee Edge e uno sviluppatore di proxy API seguono questi passaggi di alto livello:

  • Un amministratore dell'organizzazione Apigee Edge configura ed esegue il deployment dell'estensione. La configura con valori specifici per le esigenze dell'attività. Questa configurazione crea un'istanza di estensione incentrata sull'utilizzo da parte dello sviluppatore del proxy API. Ad esempio, potrebbe configurare un'estensione per accedere a un bucket specifico in Google Cloud Storage, incluse le credenziali di autenticazione richieste.
  • Uno sviluppatore di proxy API utilizza un'estensione configurata in un proxy API aggiungendo una policy Extension Callout al proxy. La configurazione della policy specifica
    • l'estensione configurata da utilizzare.
    • le azioni di estensione (considerale come chiamate di funzione all'estensione) da richiamare.
    • i parametri di azione da passare con la chiamata di azione. In fase di runtime, la policy utilizza l'estensione per accedere alla risorsa esterna come parte del flusso del proxy.

Documentazione sulle estensioni

I seguenti argomenti forniscono ulteriori informazioni sulle estensioni: