Une politique de réécriture HTTP modifie le chemin et le nom d'hôte d'une requête avant son transfert vers un service backend. Vous disposez ainsi d'un contrôle précis du routage pour répondre à vos exigences métier et architecturales.
Configurer une politique de réécriture HTTP
La réécriture HTTP modifie le chemin et le nom d'hôte de la requête d'origine.
-
Cloud-native API Gateway propose deux méthodes pour configurer une politique de réécriture HTTP : pour les API gérées en dehors d'une instance et pour les API gérées au sein d'une instance.
APIs outside an instance
Connectez-vous à la console Cloud-native API Gateway. Dans le volet de navigation de gauche, cliquez sur API, puis sélectionnez une région dans la barre de menu supérieure.
Cliquez sur l'API cible. Dans la liste déroulante All instances en haut de la page, sélectionnez l'instance cible ou choisissez All Instances.
Sous l'onglet Routes, sélectionnez la route cible.
APIs within an instance
Connectez-vous à la console Cloud-native API Gateway. Dans le volet de navigation de gauche, cliquez sur Instance, puis sélectionnez une région dans la barre de menu supérieure.
Sur la page Instance, cliquez sur l'ID de l'instance de passerelle cible. Dans le volet de navigation de gauche, cliquez sur API, puis sélectionnez l'API cible.
Sous l'onglet Routes, sélectionnez la route cible.
Accédez à l'onglet Configure Policy. Ensuite, dans la section Inbound Processing, cliquez sur Enable Policy/Plug-in.
Cliquez sur la carte HTTP Rewrite. Dans le panneau Add Policy: HTTP Rewrite, configurez les paramètres et cliquez sur Add.
Réécriture de chemin
Cloud-native API Gateway prend en charge deux méthodes de réécriture de chemin : la réécriture par préfixe et la réécriture par expression régulière.
Réécriture par préfixe
La réécriture par préfixe modifie le préfixe du chemin d'une requête.
Exemple 1
Pour modifier le chemin d'une requête de /app/test vers /test avant de la transférer à un service backend, utilisez la configuration suivante :
Condition de correspondance de la route : le type de correspondance est Prefix Match et le chemin est
/app/.Rewrite : le type de réécriture est Prefix Rewrite et le chemin est
/.
Le chemin défini dans la condition de correspondance de la route doit être /app/. En effet, la réécriture par préfixe ne remplace que la chaîne correspondant à la règle de préfixe. Si le chemin de la condition était défini sur /app, le chemin réécrit deviendrait //test, ce qui n'est pas le résultat escompté.
Exemple 2
Pour modifier le chemin d'une requête de /v1/test vers /v2/test, utilisez la configuration suivante :
Condition de correspondance de la route : le type de correspondance est Prefix Match et le chemin est
/v1.Rewrite : le type de réécriture est Prefix Rewrite et le chemin est
/v2.
La réécriture par préfixe nécessite que le type de correspondance de la route soit défini sur Prefix Match. Ce type de réécriture n'est pas pris en charge pour les routes utilisant Exact Match ou Regex Match. Étant donné qu'une correspondance par préfixe s'applique à toutes les requêtes partageant le même préfixe de chemin, vérifiez attentivement si toutes les requêtes correspondantes doivent être réécrites. Si ce n'est pas le cas, envisagez d'utiliser une réécriture par expression régulière.
Réécriture par expression régulière
La réécriture par expression régulière modifie une partie du chemin d'une requête à l'aide d'un paramètre mode (le modèle d'expression régulière à faire correspondre) et d'un paramètre replacement (la chaîne de substitution). Pour plus de détails sur la syntaxe, consultez la syntaxe des expressions régulières.
Exemple 1
Pour modifier le chemin d'une requête de /aaa/one/bbb/one/ccc vers /aaa/two/bbb/two/ccc, utilisez la configuration suivante :
Condition de correspondance de la route : le type de correspondance est Exact Match et le chemin est
/aaa/one/bbb/one/ccc.Rewrite : le type de réécriture est Regex Rewrite, le paramètre
modeestoneet le paramètrereplacementesttwo.
Exemple 2
Pour supprimer le préfixe /httpbin d'un chemin tel que /httpbin/(.*)/(.*) et inverser les deux groupes capturés, utilisez la configuration suivante :
Condition de correspondance de la route : le type de correspondance est Regex Match et le chemin est
/httpbin/(.*)/(.*).Rewrite : le type de réécriture est Regex Rewrite, le paramètre
modeest/httpbin/(.*)/(.*)et le paramètrereplacementest/\2/\1. Dans cette chaîne,\1représente le premier groupe capturé par l'expression régulière et\2représente le second. Cela fonctionne de manière similaire aux variables $1 et $2 utilisées dans Nginx.
La réécriture par expression régulière est une fonctionnalité avancée dont la syntaxe complexe est généralement réservée à des cas particuliers. Nous vous recommandons d'utiliser la réécriture par préfixe si elle répond à vos besoins.
Réécriture de nom d'hôte
Cloud-native API Gateway prend en charge la réécriture exacte du nom d'hôte.
Par exemple, pour modifier le nom d'hôte de la requête de test.com vers dev.com, définissez le nom d'hôte de réécriture sur dev.com dans la configuration de la politique.