Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza
documentazione di Apigee Edge.
Puoi fare in modo che i flussi condivisi eseguano la pre-elaborazione o la risposta alla richiesta boilerplate e post-elaborazione attraverso una serie di API. Con un hook di flusso, colleghi un flusso condiviso in modo che viene eseguito nella stessa posizione per tutti i proxy API di cui è stato eseguito il deployment in un ambiente specifico. Ciò consente di una sequenza di logica implementata e sottoposta a deployment separatamente che non fa parte del server di implementazione del codice.
Poiché il codice collegato a un hook di flusso non rientra nel contesto della logica principale del proxy API, alcune del suo comportamento differisce dai proxy API. Tieni presente che:
- Devi disporre dell'autorizzazione per collegare un flusso condiviso a un hook di flusso. Devi essere un'organizzazione amministratore.
- 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 associato a un hook di flusso genera un errore o si verificano errori durante dell'esecuzione del flusso, il messaggio verrà rifiutato e l'errore verrà inviato al chiamante.
- Se un messaggio viene rifiutato durante l'esecuzione di un hook di flusso, i dettagli vengono registrati in l'analisi dei dati nel contesto del proxy chiamato. Il flusso condiviso può anche generare un errore con un codice personalizzato e messaggio di errore
Il seguente video mostra come connettere un flusso condiviso a un hook di flusso e poi tracciarlo. nell'UI di Apigee.
Un flusso condiviso collegato a un proxy tramite un hook di flusso fornisce un ottimo posto per la logica che fa rispettare ampi requisiti delle norme. Ad esempio, immagina di avere un team che gestisce insieme di requisiti di sicurezza per più team che rappresentano diversi settori di attività (LOB). Ogni team LOB può sviluppare API in base ai propri requisiti e senza dover per tenere conto dei requisiti di sicurezza più ampi. Il team di sicurezza può implementare tali misure i requisiti in un flusso condiviso, quindi collegalo all'ambiente Apigee utilizzando hook. Poiché il flusso condiviso non fa parte del codice proxy, il team di sicurezza può modificarlo in base alle necessità senza interferire con il codice LOB.
I flussi condivisi collegati tramite hook di flusso vengono eseguiti in quella posizione per ogni proxy API di cui è stato eseguito il deployment all'ambiente dell'hook del proxy. Per questo motivo, è possibile usare gli hook di flusso. solo agli amministratori di un'organizzazione Apigee.
Per ulteriori informazioni sui flussi condivisi, consulta Creazione di flussi condivisi riutilizzabili.
Puoi collegare un flusso condiviso a un hook di flusso utilizzando l'UI di Apigee o l'API Dataflow. Puoi collega al massimo un flusso condiviso a un hook di flusso in ognuna delle seguenti posizioni:
-
Hook pre-proxy del flusso per la logica che deve essere applicata PRIMA di un endpoint proxy .
Ad esempio, potresti avere una logica per applicare la sicurezza a tutte le API in un completamente gestito di Google Cloud.
Hook del flusso pre-target per la logica che deve essere applicata PRIMA di un endpoint di destinazione .
Ad esempio, potresti implementare il logging prima che la richiesta raggiunga il backend. Potresti applicare la mediazione anche rimuovendo alcuni campi dalla richiesta.
Hook di flusso post-target per la logica che deve essere applicata DOPO la risposta target .
L'applicazione verrà applicata subito dopo che la risposta arriverà dal backend. Puoi usarlo per registrare la risposta del backend o eseguire la mediazione rimuovendo i campi sensibili dal una risposta del backend.
Hook post-proxy del flusso per la logica che deve essere applicata DOPO l'endpoint proxy e subito prima che la risposta venga inviata al cliente.
Ciò potrebbe includere una logica di applicazione per CORS, il logging della risposta o l'esecuzione un mashup o una formattazione.
Collegamento di un flusso condiviso a un hook di flusso
Per collegare un flusso condiviso a un hook di flusso, 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 l'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 di un ambiente di lavoro di questa organizzazione. Non sarà disponibile al di fuori di questa organizzazione.
- Nel riquadro di navigazione a sinistra, fai clic su Gestione > Ambienti.
- Seleziona l'ambiente che vuoi modificare dall'elenco di ambienti disponibili.
- Fai clic sulla scheda Ami di flusso nella pagina Dettagli ambiente.
Viene visualizzata la vista Ami di flusso.
- Nell'elenco degli hook di flusso, identifica l'hook di flusso a cui vuoi collegare il flusso condiviso.
L'hook di flusso scelto dipende da dove vuoi che venga eseguito il flusso condiviso.
Posizione hook di flusso Descrizione Pre-proxy Viene eseguito prima di eseguire un endpoint proxy Pre-target Eseguito prima di eseguire un endpoint di destinazione Dopo il target Esegui dopo l'esecuzione della risposta target Post-proxy Esegui dopo l'endpoint del proxy e subito prima che la risposta venga inviata al cliente - Nella casella di riepilogo dell'hook di flusso che hai scelto, seleziona il flusso condiviso che vuoi collegare.
- Collega i flussi condivisi ad altri hook di flusso in base alle esigenze.
- Fai clic su Salva per collegare i flussi condivisi selezionati agli hook di flusso.
Versione classica di Apigee
Per collegare un flusso condiviso a un hook di flusso:
- Accedi alla UI 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 di un ambiente di lavoro di questa organizzazione. Non sarà disponibile al di fuori di questa organizzazione.
- Seleziona Amministratore > Ambienti > Hook di flusso nella barra di navigazione a sinistra.
Viene visualizzata la vista Ami di flusso:
- Nell'elenco a discesa dell'ambiente, seleziona l'ambiente che vuoi modificare.
- Nell'elenco degli hook di flusso, identifica l'hook di flusso a cui vuoi collegare il flusso condiviso.
L'hook di flusso scelto dipende da dove vuoi che venga eseguito il flusso condiviso.
Posizione hook di flusso Descrizione Pre-proxy Viene eseguito prima di eseguire un endpoint proxy Pre-target Eseguito prima di eseguire un endpoint di destinazione Post-proxy Esegui dopo l'endpoint del proxy e subito prima che la risposta venga inviata al cliente Dopo il target Esegui dopo l'esecuzione della risposta target - Posiziona il cursore sull'hook di 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 collegare nella Menu Flusso condiviso.
- Fai clic su OK.
- Collega i flussi condivisi ad altri hook di flusso in base alle esigenze.