Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.
Esponi le API su Apigee implementando i proxy API. I proxy API disaccoppiano l'API rivolta alle app dai servizi di backend, proteggendo queste app dalle modifiche al codice del backend.
Sviluppa i tuoi proxy API utilizzando Apigee in Cloud Code, come descritto nelle sezioni seguenti. Vedi anche Gestire cartelle e file in un'area di lavoro Apigee.
Creazione di un proxy API
Per creare un proxy API utilizzando Apigee in {code_name}}:
Esegui una delle seguenti azioni:
Nella sezione Apigee, posiziona il cursore sulla cartella apiproxies e fai clic su .
Seleziona Visualizza > Tavolozza dei comandi per aprire la tavolozza dei comandi e seleziona Cloud Code: Crea bundle proxy Apigee.
Viene visualizzata la procedura guidata Crea proxy.
Seleziona una delle seguenti opzioni:
Tipo Descrizione Reverse proxy
Un proxy API che indirizza le richieste in entrata ai servizi di backend HTTP esistenti. Può essere un'API JSON o XML. Consulta Creazione di un proxy inverso per un servizio HTTP più avanti in questa sezione.
No target
Un proxy API senza backend API ("nessuna destinazione"). Come per la creazione di un proxy inverso per un servizio HTTP, l'unica differenza consiste nel dover specificare un URL di destinazione esistente quando si definiscono i dettagli del proxy API.
Le seguenti sezioni descrivono i passaggi aggiuntivi necessari per creare ciascun tipo di proxy API.
Creazione di un proxy inverso per un servizio HTTP
Apigee genera proxy API inversi in base alle seguenti informazioni:
- URL del servizio di backend
- Percorso URI che identifica in modo univoco l'API che verrà esposta dal proxy API alle app consumer
Quando selezioni Inverti proxy durante la creazione di un proxy API, ti verranno chieste i dettagli relativi all'autenticazione di sicurezza e ai dettagli del proxy API descritti nelle tabelle seguenti.
Per Autenticazione di sicurezza, seleziona una delle seguenti opzioni:
Autenticazione di sicurezza | Descrizione |
---|---|
API key based authentication |
Aggiunge una semplice verifica della chiave API al proxy API che stai definendo. Apigee aggiunge automaticamente i seguenti criteri al proxy API:
|
Access token based authentication |
Aggiunge l'autenticazione basata su OAuth 2.0 al proxy API. Apigee aggiunge automaticamente i seguenti criteri al proxy API:
|
No authentication |
Nessuna autenticazione richiesta. Le richieste vengono passate al backend senza controlli di sicurezza su Apigee. |
Per la sezione Dettagli del proxy API, rispondi a ogni messaggio di richiesta e premi Invio per confermare e procedere o Esc per annullare la procedura guidata:
Campo | Descrizione |
---|---|
Backend target URL |
URL del servizio di backend richiamato da questo proxy API. |
API proxy name |
Nome visualizzato per l'API. Specifica caratteri alfanumerici, trattini (-) o trattini bassi (_). |
API proxy base path |
Frammento URI visualizzato dopo l'indirizzo http://[host] o https://[host] del proxy API. Apigee utilizza l'URI del percorso di base per associare e instradare i messaggi di richiesta in entrata al proxy API corretto.
Utilizzare caratteri jolly nei percorsi di base Utilizza uno o più caratteri jolly |
Dopo aver completato i passaggi della procedura guidata, la nuova cartella apiproxy-name
viene aggiunta in apiproxies
nella sezione Apigee. Ogni cartella del proxy API è strutturata come descritto nella sezione Struttura della directory di configurazione del proxy API.
Di seguito è riportato un esempio della configurazione predefinita creata per un proxy API inverso denominato helloworld
con criteri aggiunti per supportare l'autenticazione basata su chiave API.
Per una descrizione della configurazione predefinita, consulta Esplorazione della configurazione predefinita del proxy API.
Creazione di un proxy API senza destinazione di backend
Il processo di creazione di un proxy API senza destinazione di backend è uguale alla creazione di un proxy inverso, ad eccezione del fatto che non ti viene richiesto di specificare un URL per il servizio di backend (Target (Existing API)
) e la configurazione predefinita dell'endpoint di destinazione non è inclusa. Per ulteriori informazioni, vedi Creazione di un proxy inverso per un servizio HTTP.
Esplorazione della configurazione predefinita del proxy API
La seguente tabella riassume i contenuti inclusi nella configurazione predefinita quando crei un proxy API in base al tipo di proxy API e alle opzioni di autenticazione selezionate.
Nessun target | ||||
---|---|---|---|---|
proxies/default.xml Configurazione predefinita degli endpoint proxy. |
||||
targets/default.xml Configurazione predefinita dell'endpoint di destinazione. |
||||
impose-quota.xml Criteri per le quote per definire una quota predefinita. |
||||
remove-header-authorization.xml CriterioAssignMessage per rimuovere l'intestazione Authorization che viene passata per l'autenticazione. |
> |
|||
remove-query-param-apikey.xml CriterioAssignMessage per rimuovere il parametro di query apikey che viene passato per l'autenticazione. |
||||
verify-api-key.xml Criterio VerificationAPIKey per applicare la verifica delle chiavi API. |
||||
verify-oauth-v2-access-token.xml Criterio OAuthV2 per convalidare i token di accesso OAuth V2. |
Caricare un bundle proxy API
Per caricare un bundle proxy API su Apigee in Cloud Code:
Esegui una delle seguenti azioni:
Nella sezione Apigee, posiziona il cursore sulla cartella apiproxies e fai clic su .
Seleziona Visualizza > Tavolozza dei comandi per aprire la tavolozza dei comandi e seleziona Cloud Code: importa bundle proxy Apigee.
Vai al bundle proxy API che vuoi caricare e fai clic su Importa proxy. Il bundle proxy API deve essere strutturato come descritto nell'articolo Struttura della directory di configurazione del proxy API.
(Facoltativo) Per impostazione predefinita, per il nome del proxy API viene utilizzato il nome del file ZIP meno la sua estensione. Se si tratta di un nome non univoco, viene richiesto di specificarne uno univoco.
La cartella apiproxy-name
caricata viene aggiunta in apiproxies
nella sezione Apigee.
Gestione degli endpoint proxy
Come descritto in Che cos'è un proxy API?, un endpoint proxy (ProxyEndpoint) definisce il modo in cui le app client utilizzano le API. Devi configurare l'endpoint del proxy per definire l'URL del proxy API. L'endpoint proxy determina inoltre se le app accedono al proxy API tramite HTTP o HTTPS. Puoi collegare criteri all'endpoint proxy per applicare la sicurezza, i controlli delle quote e altri tipi di controllo dell'accesso e limitazione di frequenza.
Crea e configura gli endpoint proxy come descritto nelle sezioni seguenti.
Creazione di endpoint proxy
Quando crei un proxy API, viene aggiunto un endpoint proxy predefinito alla configurazione del proxy API. Per ulteriori informazioni, consulta Esplorazione della configurazione predefinita del proxy API. Puoi creare endpoint proxy aggiuntivi in base alle esigenze.
Per creare un endpoint proxy utilizzando Apigee in Cloud Code:
Nella sezione Apigee, esegui una delle seguenti azioni:
- Nella sezione Apigee, posiziona il cursore su una delle seguenti cartelle, fai clic su e seleziona Crea endpoint proxy:
apiproxy-name
bundle proxyapiproxy-name/apiproxy
- Nella sezione Apigee, posiziona il cursore sulla cartella
apiproxy-name/apiproxy/proxies
e fai clic su .
Viene visualizzata la procedura guidata Crea endpoint proxy.
- Nella sezione Apigee, posiziona il cursore su una delle seguenti cartelle, fai clic su e seleziona Crea endpoint proxy:
Inserisci i valori per il successivo insieme di prompt. Premi Invio dopo ogni passaggio per confermare e procedere o Esc per annullare.
Campo Descrizione Proxy endpoint name
Nome utilizzato per identificare l'endpoint proxy. API proxy base path
Parte dell'URL utilizzato per effettuare richieste all'API. Apigee utilizza l'URL per associare e instradare le richieste in entrata al proxy API appropriato.
L'endpoint viene creato e aggiunto alla cartella apiproxy-name/apiproxy/proxies
nella sezione Apigee e aperto nell'editor. Configura l'endpoint del proxy come descritto nella sezione seguente.
Configurazione degli endpoint proxy
Per configurare gli endpoint proxy, consulta le sezioni seguenti:
- Controllo dell'esecuzione di un proxy con i flussi
- Determinazione dell'URL dell'endpoint proxy API
- Aggiunta di funzionalità mediante i criteri
- Gestione delle risorse
- Configurazione proxyEndpoint
- Riferimento per la configurazione del flusso
- Riferimento per le proprietà degli endpoint
Gestione degli endpoint di destinazione
Come descritto in Che cos'è un proxy API?, un endpoint di destinazione (TargetEndpoint) definisce il modo in cui il proxy API interagisce con i servizi di backend. Devi configurare l'endpoint di destinazione per inoltrare le richieste al servizio di backend appropriato, definendo eventuali impostazioni di sicurezza, protocollo HTTP o HTTPS e altre informazioni sulla connessione. Puoi allegare criteri all'endpoint di destinazione per assicurarti che i messaggi di risposta siano formattati correttamente per l'app che ha effettuato la richiesta iniziale.
Crea e configura gli endpoint di destinazione come descritto in questa sezione.
Creazione di endpoint di destinazione
Quando crei un proxy API inverso, viene aggiunto un endpoint di destinazione predefinito alla configurazione del proxy API. Quando crei un proxy API senza destinazione di backend, alla configurazione del proxy API viene aggiunto solo l'endpoint del proxy predefinito e non viene aggiunto nessun endpoint di destinazione. Per ulteriori informazioni, consulta Esplorazione della configurazione predefinita del proxy API.
Crea endpoint di destinazione in base alle esigenze.
Per creare un endpoint di destinazione utilizzando Apigee in Cloud Code:
Nella sezione Apigee, esegui una delle seguenti azioni:
- Nella sezione Apigee, posiziona il cursore su una delle seguenti cartelle, fai clic su e seleziona Crea endpoint di destinazione:
apiproxy-name
bundle proxyapiproxy-name/apiproxy
- Nella sezione Apigee, posiziona il cursore sulla cartella
apiproxy-name/apiproxy/targets
e fai clic su .
Viene visualizzata la procedura guidata Crea endpoint di destinazione.
- Nella sezione Apigee, posiziona il cursore su una delle seguenti cartelle, fai clic su e seleziona Crea endpoint di destinazione:
Esegui i seguenti passaggi in base al tipo di endpoint di destinazione che vuoi creare:
Tipo Procedura Destinazione HTTP(s) esterna Per definire una destinazione HTTP(s) esterna:
- Seleziona Target HTTP(S).
- Inserisci il nome dell'endpoint di destinazione in Nome endpoint di destinazione.
- Inserisci l'URL del servizio di backend richiamato da questo endpoint di destinazione in URL di destinazione di backend.
Per maggiori informazioni, consulta Determinazione dell'URL dell'endpoint di destinazione.
Concatenamento dei proxy Per definire come destinazione un proxy API di cui è stato eseguito il deployment localmente:
- Seleziona Concatenamento proxy.
- Inserisci il nome dell'endpoint di destinazione in Nome endpoint di destinazione.
- Seleziona un proxy API.
- Seleziona l'endpoint del proxy.
Per saperne di più, consulta l'articolo Aggiungere i proxy insieme.
Target con bilanciamento del carico Per definire un target con bilanciamento del carico utilizzando i server di destinazione definiti nell'ambiente:
- Seleziona Destinazione con bilanciamento del carico.
- Inserisci il nome dell'endpoint di destinazione in Nome endpoint di destinazione.
Per ulteriori informazioni, consulta Configurazione di un TargetEndpoint per bilanciare il carico tra TargetServers denominati.
L'endpoint di destinazione viene creato e aggiunto alla cartella apiproxy-name/apiproxy/targets
nella sezione Apigee e aperto nell'editor. Configura l'endpoint di destinazione, come descritto nella sezione seguente.
Configurazione degli endpoint di destinazione
Configura gli endpoint di destinazione, come descritto nei seguenti argomenti.
- Bilanciamento del carico tra server di backend
- Controllo dell'esecuzione di un proxy con i flussi
- Unione dei proxy API
- Determinare l'URL dell'endpoint di destinazione
- Aggiunta di funzionalità mediante i criteri
- Gestione delle risorse
- Configurazione degli endpoint di destinazione
- Riferimento per la configurazione del flusso
- Riferimento per le proprietà degli endpoint