Comment puis-je transférer l'en-tête de l'hôte avec intégration privée pour une API REST API Gateway ?

Brève description

Amazon API Gateway remplace la valeur d'hôte qu'il reçoit dans la demande initiale envoyée au point de terminaison d'intégration. En fonction de l'URL du point de terminaison de la demande d'intégration, Amazon API Gateway attribue la valeur d'hôte.

Pour utiliser la valeur d'en-tête d'hôte d'un point de terminaison API Gateway dans le backend, utilisez l'en-tête personnalisé. Utilisez l'en-tête personnalisé dans la demande d'intégration qui contient la valeur de l'en-tête de l'hôte de la demande.

Résolution

Création d'une API REST pour la Passerelle API

1.    Ouvrez la console API Gateway.

2.    Sélectionnez Créer une API.

-ou-

Si c'est la première fois que vous utilisez API Gateway, une page vous présentant le service s'affiche. Pour l'API REST, choisissez Création. Lorsque la fenêtre contextuelle Créer un exemple d'API apparaît, cliquez sur OK.

3.    Pour Choisir un type d'API, dans le volet API REST, choisissez Création.

4.    Dans Créer une nouvelle API, sélectionnez Nouvelle API.

5.    Dans Réglages, entrez les valeurs suivantes :
Pour le Nom de l'API, entrez un nom qui décrit l'objectif de votre API. Par exemple : ForwardHostHeader.
(Facultatif) Dans Description, entrez une brève description de l'objectif de votre API. Par exemple, en-tête d'hôte Forward pour une intégration privée.
Pour le Type de point de terminaison, choisissez Régional, Optimisé pour la périphérie ou Privé.

6.    Sélectionnez Créer une API.

Configurez la demande de méthode et la demande d'intégration de votre API

1.    Ouvrez la console API Gateway.

2.    Suivez les instructions pour créer une API avec intégration privée à l'aide de la console API Gateway.

3.    Dans Demande de méthode, ajoutez les en-têtes de requête HTTP en tant qu'hôte.

4.    Dans Demande d'intégration, développez les en-têtes HTTP et choisissez Ajouter un en-tête.

5.    Entrez un nom pour l'en-tête personnalisé. Par exemple, mon_hôte.

6.    Dans Mappage à partir de, entrez la demande de méthode. Par exemple, method.request.header.host. Cliquez ensuite sur l’icône en forme de coche.

Déployer votre API vers une nouvelle étape

1.    Ouvrez la console API Gateway.

2.    Suivez les instructions pour déployer une API REST vers une étape. Pour plus d'informations, consultez Configuration d'une étape à l'aide de la console API Gateway.

3.    Dans le volet Éditeur d’étape, copiez l'URL Invoke dans votre presse-papiers. Utilisez cette URL pour appeler votre API.

**Exemple d'URL d'appel d'API REST : **

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

4.    Si vous utilisez un équilibreur de charge d'application pour votre backend, ajoutez une règle pour tester votre configuration. Choisissez « en-tête http » comme condition, puis spécifiez « my_host » comme en-tête et valeur identiques à la valeur de l'hôte API Gateway.

5.    Collez l'URL d'API Gateway dans une fenêtre de navigateur pour invoquer votre API. La configuration de l'en-tête « my_host » dans API Gateway transmet la valeur de l'hôte API Gateway à l'équilibreur de charge d'application. L'équilibreur de charge d'application associe la condition définie, puis renvoie la réponse telle que configurée.

Informations connexes

Configurer des mappages de données de demande et de réponse à l’aide de la console API Gateway

Configuration d'une API à l'aide de la console API Gateway

Remarques importantes sur Amazon API Gateway

Comment intégrer une API REST API Gateway à un équilibreur de charge d'application ?