Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Puoi fare in modo che i flussi condivisi eseguano la pre-elaborazione delle richieste standard o la post-elaborazione delle risposte per un insieme di API. Con un hook di flusso, colleghi 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 collegato a un hook di flusso è al di fuori del contesto della logica principale del proxy API, alcuni dei suoi comportamenti differiscono da quelli dei proxy API. Tieni presente quanto riportato di seguito.
- 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 il flusso condiviso collegato a un hook di 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 al chiamante.
- Se un messaggio viene rifiutato durante l'esecuzione di un hook di 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 di flusso e poi tracciarlo in nell'interfaccia utente Edge classica.
Il seguente video mostra come collegare un flusso condiviso a un hook di flusso e poi tracciarlo, nell'interfaccia utente della nuova esperienza Edge.
Un flusso condiviso collegato a un proxy tramite un hook di flusso è un ottimo posto per la logica che applica requisiti di policy generali. Ad esempio, supponiamo che un team gestisca un singolo insieme di requisiti di sicurezza per più team che rappresentano diverse linee di business (LOB). 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 Edge 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 hook di flusso vengono eseguiti in quella posizione per ogni proxy API di cui è stato eseguito il deployment nell'ambiente dell'hook proxy. Per questo motivo, la possibilità di utilizzare gli hook di flusso è disponibile solo per gli amministratori di un'organizzazione Apigee Edge.
Per saperne di più sui flussi condivisi, vedi Flussi condivisi riutilizzabili.
Colleghi un flusso condiviso a un hook di flusso utilizzando la console di gestione di Apigee Edge. Puoi collegare al massimo un flusso condiviso a un hook di flusso in ciascuno dei seguenti punti:
-
Hook di flusso pre-proxy per la logica che deve essere applicata PRIMA dell'esecuzione di un endpoint proxy
esegue.
Ad esempio, potresti avere una logica per applicare la sicurezza a tutte le API in un ambiente.
-
Hook di flusso pre-target per la logica che deve essere applicata PRIMA della chiamata a un target.
Ad esempio, potresti implementare la registrazione prima che la richiesta raggiunga il backend. Potresti anche applicare la mediazione rimuovendo determinati campi dalla richiesta.
-
Hook di flusso post-target per la logica che deve essere applicata DOPO l'esecuzione della risposta target
esegue.
Questa verrà applicata subito dopo la ricezione della risposta dal backend. Puoi utilizzarla per registrare la risposta del backend o eseguire una mediazione rimuovendo i campi sensibili dalla risposta del backend.
-
Hook di flusso post-proxy per la logica che deve essere applicata DOPO l'endpoint proxy e
subito prima dell'invio della risposta al client.
Potrebbe includere una logica di applicazione per CORS, la registrazione della risposta o l'esecuzione di una formattazione o un mashup.
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 che contiene il flusso condiviso.
- Accedi alla pagina Hook di flusso, come descritto di seguito.
Edge
Per accedere alla pagina Hook di flusso utilizzando l'interfaccia utente Edge:
- Accedi a apigee.com/edge.
- Seleziona l'organizzazione che contiene 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 al di fuori di questa organizzazione.
- Seleziona Amministrazione > Ambienti > Hook di flusso nella barra di navigazione a sinistra.
Edge classico (Cloud privato)
Per accedere alla pagina Hook di flusso utilizzando l'interfaccia utente Edge classica:
- Accedi a
http://ms-ip:9000, dove ms-ip è l' indirizzo IP o il nome DNS del nodo del server di gestione. - Seleziona l'organizzazione che contiene 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 al di fuori di questa organizzazione.
- Seleziona API > Configurazione ambiente > Hook di flusso nella barra di navigazione in alto.
- Nell'elenco degli hook di flusso, identifica l'hook di flusso a cui vuoi collegare il flusso condiviso
in base alla posizione in cui vuoi che venga eseguito il flusso condiviso.
Posizione dell'hook di flusso Descrizione Hook di flusso pre-proxy PRIMA dell'esecuzione di un endpoint proxy Hook di flusso pre-target PRIMA dell'esecuzione di un endpoint target Hook di flusso post-target DOPO l'esecuzione della risposta target Hook di flusso post-proxy DOPO l'endpoint proxy e subito prima dell'invio della risposta al client - Posiziona il cursore sull'hook di flusso nell'elenco per visualizzare la colonna delle azioni.
- Fai clic su
. - Nella finestra di dialogo Flusso condiviso, seleziona il flusso condiviso che vuoi collegare nel menu a discesa Flusso condiviso.
- Fai clic su OK.
- Collega i flussi condivisi ad altri hook di flusso, se necessario.