Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
Puoi fare in modo che i flussi condivisi eseguano la preelaborazione delle richieste o il post-trattamento delle risposte di boilerplate in un insieme di API. Con un hook del flusso, puoi collegare un flusso condiviso in modo che venga eseguito nello stesso punto per tutti i proxy API di cui è stato eseguito il deployment in un ambiente specifico. In questo modo, hai una sequenza di logica implementata e di cui è stato eseguito il deployment separatamente che non fa parte del codice di implementazione di un proxy.
Poiché il codice associato a un hook del flusso non rientra nel contesto della logica di base del proxy API, alcuni aspetti del suo comportamento sono diversi da quelli dei proxy API. Tieni presente che:
- Devi disporre dell'autorizzazione per collegare un flusso condiviso a un hook di flusso. Devi essere un amministratore dell'organizzazione.
- Puoi collegare un solo flusso condiviso a ogni hook di flusso.
- Puoi collegare lo stesso flusso condiviso a più hook di flusso.
- Se un flusso condiviso collegato a un hook del flusso genera un errore o si verificano errori durante l'esecuzione del flusso condiviso, il messaggio verrà rifiutato e l'errore verrà inviato di nuovo all'autore della chiamata.
- Se un messaggio viene rifiutato durante l'esecuzione di un hook del flusso, i dettagli verranno registrati in Analytics nel contesto del proxy chiamato. Il flusso condiviso può anche generare un errore con un codice e un messaggio di errore personalizzati
Il seguente video mostra come collegare un flusso condiviso a un hook del flusso e poi tracciarlo nell'interfaccia utente di Apigee.
Un flusso condiviso collegato a un proxy tramite un hook di flusso è un ottimo posto per la logica che impone requisiti di criteri generali. Ad esempio, immagina di avere un team che gestisce un unico insieme di requisiti di sicurezza per più team che rappresentano diversi settori di attività. Ogni team LOB può sviluppare API in base ai propri requisiti e senza dover tenere conto dei requisiti di sicurezza più ampi. Il team di sicurezza può implementare questi requisiti di sicurezza in un flusso condiviso, quindi collegare il flusso all'ambiente Apigee utilizzando un hook di flusso. Poiché il flusso condiviso non fa parte del codice proxy, il team di sicurezza può rivederlo in base alle esigenze senza interferire con il codice LOB.
I flussi condivisi collegati tramite gli hook del flusso vengono eseguiti in quella posizione per ogni proxy API di cui è stato eseguito il deployment nell'ambiente dell'hook del proxy. Per questo motivo, la possibilità di utilizzare gli hook del flusso è disponibile solo per gli amministratori di un'organizzazione Apigee.
Per saperne di più sui flussi condivisi, consulta Creare flussi condivisi riutilizzabili.
Puoi collegare un flusso condiviso a un hook di flusso utilizzando l'interfaccia utente di Apigee o l'API Flowhooks. Puoi collegare al massimo un flusso condiviso a un hook di flusso in ciascuna delle seguenti posizioni:
-
Hook del flusso pre-proxy per la logica che deve essere applicata PRIMA dell'esecuzione di un endpoint proxy.
Ad esempio, potresti avere una logica per applicare la sicurezza a tutte le API in un ambiente.
Hook del flusso pre-target per la logica che deve essere applicata PRIMA dell'esecuzione di un endpoint target.
Ad esempio, puoi implementare il logging prima che la richiesta raggiunga il backend. Puoi anche impostare la mediazione rimuovendo determinati campi dalla richiesta.
Hook del flusso post-target per la logica che deve essere applicata DOPO l'esecuzione della risposta target.
Questo verrà applicato subito dopo che la risposta viene restituita dal backend. Puoi utilizzarlo per registrare la risposta del backend o eseguire una mediazione rimuovendo i campi sensibili dalla risposta del backend.
Hook del flusso post-proxy per la logica che deve essere applicata DOPO l'endpoint proxy e subito prima che la risposta venga inviata al client.
Potrebbe includere una logica di applicazione per CORS, la registrazione della risposta o l'esecuzione di un mashup o di una formattazione.
Collegamento di un flusso condiviso a un hook di flusso
Per collegare un flusso condiviso a un hook, devi essere un amministratore dell'organizzazione contenente il flusso condiviso.
Apigee nella console Cloud
Per collegare un flusso condiviso a un hook di flusso:
- Apri la UI di Apigee nella console Cloud in un browser.
- Seleziona l'organizzazione contenente il flusso condiviso. Consulta
Passare da un'organizzazione all'altra.
Il flusso condiviso sarà disponibile per tutti i proxy API e i flussi condivisi di cui è stato eseguito il deployment in un ambiente di questa organizzazione. Non sarà disponibile dall'esterno di questa organizzazione.
- Nel riquadro di navigazione a sinistra, fai clic su Gestione > Ambienti.
- Seleziona l'ambiente che vuoi modificare dall'elenco degli ambienti disponibili.
- Fai clic sulla scheda Hook del flusso nella pagina Dettagli dell'ambiente.
Viene visualizzata la visualizzazione Hook di flusso.
- Nell'elenco degli hook di flusso, identifica l'hook di flusso a cui vuoi collegare il flusso condiviso.
Il flusso di hook scelto dipende da dove vuoi che venga eseguito il flusso condiviso.
Posizione del flusso di hook Descrizione Pre-proxy Viene eseguito prima dell'esecuzione di un endpoint proxy Pre-target Viene eseguita prima dell'esecuzione di un endpoint target Post-target Viene eseguito dopo l'esecuzione della risposta target Post-proxy Viene eseguito dopo l'endpoint proxy e subito prima che la risposta venga inviata al client. - Nella casella dell'elenco dell'aggancio del flusso che hai scelto, seleziona il flusso condiviso da allegare.
- Collega i flussi condivisi ad altri hook di flusso, se necessario.
- Fai clic su Salva per collegare i flussi condivisi selezionati agli hook di flusso.
Apigee classica
Per collegare un flusso condiviso a un hook di flusso:
- Accedi all'interfaccia utente di Apigee.
- Seleziona l'organizzazione contenente il flusso condiviso. Consulta
Passare da un'organizzazione all'altra.
Il flusso condiviso sarà disponibile per tutti i proxy API e i flussi condivisi di cui è stato eseguito il deployment in un ambiente di questa organizzazione. Non sarà disponibile dall'esterno di questa organizzazione.
- Seleziona Amministrazione > Ambienti > Hook del flusso nella barra di navigazione a sinistra.
Nella visualizzazione Hook di flusso vengono visualizzati:
- Nell'elenco a discesa dell'ambiente, seleziona l'ambiente da modificare.
- Nell'elenco degli hook di flusso, identifica l'hook di flusso a cui vuoi collegare il flusso condiviso.
Il flusso di hook scelto dipende da dove vuoi che venga eseguito il flusso condiviso.
Posizione del flusso di hook Descrizione Pre-proxy Viene eseguito prima dell'esecuzione di un endpoint proxy Pre-target Viene eseguita prima dell'esecuzione di un endpoint target Post-proxy Viene eseguito dopo l'endpoint proxy e subito prima che la risposta venga inviata al client. Post-target Viene eseguito dopo l'esecuzione della risposta target - Posiziona il cursore sopra il collegamento del flusso nell'elenco per visualizzare la colonna delle azioni.
- Fai clic su Modifica.
- Nella finestra di dialogo Flusso condiviso, seleziona il flusso condiviso che vuoi allegare nel menu Flusso condiviso.
- Fai clic su OK.
- Collega i flussi condivisi ad altri hook di flusso, se necessario.