Come posso inoltrare l'header host con integrazione privata per un'API REST API Gateway?

Breve descrizione

Amazon API Gateway sovrascrive il valore dell'host ricevuto nella richiesta originale all'endpoint di integrazione. Amazon API Gateway assegna il valore dell'host in base all'URL dell'endpoint della richiesta di integrazione.

Per utilizzare il valore dell'intestazione host di un endpoint API Gateway nel backend, usa l'intestazione personalizzata. È possibile utilizzare l'intestazione personalizzata nella richiesta di integrazione che contiene il valore dell'intestazione dell'host della richiesta.

Risoluzione

Crea un’API REST API Gateway

1.    Apri la console API Gateway.

2.    Scegli Create API (Crea API).

-oppure-

(Se è la prima volta che utilizzi API Gateway) Viene visualizzata una pagina di introduzione alle caratteristiche del servizio. In REST API, scegli Build (Costruisci). Quando viene visualizzato il popup Create Example API (Crea API di esempio), scegli OK.

3.    Per Scegli un tipo di API, nel riquadro API REST scegli Costruisci.

4.    In Create new API (Crea nuova API), scegli New API (Nuova API).

5.    In Impostazioni, procedi come segue:
Per Nome API, inserisci un nome che descriva lo scopo dell'API. Ad esempio: ForwardHostHeader.
(Facoltativo) Per Descrizione, inserisci una breve descrizione dello scopo della tua API, ad esempio Forward host header per l'integrazione privata.
Per Tipo di endpoint, scegli Regionale, Ottimizzato per Edge o Privato.

6.    Scegli Create API (Crea API).

Configura la richiesta del metodo e la richiesta di integrazione della tua API

1.    Apri la console API Gateway.

2.    Segui le istruzioni per creare un'API con integrazione privata utilizzando la console API Gateway.

3.    In Method Request, aggiungi gli header delle richieste HTTP come host.

4.    In Richiesta di integrazione, espandi gli header HTTP e scegli Aggiungi header.

5.    Inserisci un nome per l'header personalizzata. Ad esempio, my_host.

6.    In Mapped from (Mappato da), inserisci la richiesta del metodo. Ad esempio, method.request.header.host, quindi scegli l'icona del segno di spunta.

Implementa l'API in una nuova fase

1.    Apri la console API Gateway.

2.    Segui le istruzioni in Implementa un'API REST in una fase. Per ulteriori informazioni, consulta Configurazione di una fase utilizzando la console API Gateway.

3.    Nel riquadro Editor di fase, copia l'URL di richiamo negli appunti. Puoi usare questo URL per richiamare la tua API.

Esempio di URL di richiamo di un'API REST

https://1a2bc3d456.execute-api.us-east-1.amazonaws.com/stage

4.    Se utilizzi un Application Load Balancer per il tuo backend, puoi testare questa configurazione aggiungendo una regola. Scegli "http header" come condizione e specifica "my_host" come intestazione e valore del valore dell'host API Gateway.

5.    Incolla l'URL dell'API Gateway in una finestra del browser per richiamare la tua API. La configurazione dell'intestazione "my_host" in API Gateway inoltra il valore dell'host API Gateway all'Application Load Balancer. L'Application Load Balancer corrisponde al set di condizioni e quindi restituisce la risposta configurata.

---

Informazioni correlate

Configura le mappature dei dati di richiesta e risposta utilizzando la console API Gateway

Configurare un'API utilizzando la console API Gateway

Note importanti su Amazon API Gateway

In che modo è possibile integrare un'API REST del Gateway API con un Application Load Balancer?