En bref. Le paramètre Conserver le chemin sans correspondance se règle sur Oui pour ajouter le chemin situé après le préfixe source à la destination de la réécriture.

Définition : Azure Front Door Standard et Premium utilisent l’action Réécriture d’URL (URL rewrite) pour remplacer un préfixe du chemin de la requête envoyée à l’origine. Le paramètre Conserver le chemin sans correspondance (Preserve unmatched path) se règle sur Oui (Yes) lorsque la partie du chemin située après le modèle source doit être ajoutée au nouveau chemin de destination.

Points clés

La référence des actions des ensembles de règles d’Azure Front Door de Microsoft indique que l’action Réécriture d’URL modifie le chemin d’une requête acheminée vers l’origine.
Le modèle source repose sur une correspondance de préfixe, et la valeur / permet de faire correspondre tous les chemins d’URL.
Seule la partie du chemin située après les modèles de correspondance de la configuration de l’itinéraire (route) est prise en compte pour le modèle source.
Le chemin de destination remplace le modèle source.
Lorsque Conserver le chemin sans correspondance est réglé sur Oui, le reste du chemin situé après le modèle source est ajouté au nouveau chemin de destination.
La documentation sur la correspondance des itinéraires d’Azure Front Door indique que le service recherche une correspondance exacte du chemin avant une correspondance avec un chemin comportant un caractère générique, et renvoie une erreur 404 si aucune ne correspond.

Que change le paramètre Conserver le chemin sans correspondance ?

L’action Réécriture d’URL comporte trois valeurs pertinentes : Modèle source (Source pattern), Destination et Conserver le chemin sans correspondance. Azure décrit le modèle source comme une correspondance de préfixe. La destination remplace ce préfixe. Lorsque Conserver le chemin sans correspondance est réglé sur Oui, Azure ajoute à la destination la partie du chemin qui reste après le modèle source. Lorsque le paramètre est réglé sur Non (No), la destination est utilisée sans cette partie restante.

La référence des actions présente la structure de configuration ci-dessous. La valeur true sélectionne le comportement documenté pour Oui.

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": true,
    "typeName": "DeliveryRuleUrlRewriteActionParameters"
  }
}

Le modèle source est évalué sur la partie du chemin d’URL située après la valeur du paramètre Modèles de correspondance (Patterns to match) de l’itinéraire. Ce préfixe défini au niveau de l’itinéraire détermine donc les caractères sur lesquels l’action de réécriture peut rechercher une correspondance et ceux qu’elle peut conserver.

À quel chemin l’itinéraire doit-il correspondre ?

Azure Front Door sélectionne d’abord un itinéraire pour la requête entrante. Sa documentation sur les itinéraires indique qu’un itinéraire associe un domaine à un groupe d’origines. Pour le chemin, le service recherche une correspondance exacte, puis un chemin comportant un caractère générique, et rejette la requête avec une erreur 404 Bad Request si aucune correspondance n’est trouvée.

Pour Standard et Premium, le caractère générique * est valide uniquement s’il est le dernier caractère du chemin et s’il est précédé de /. Un chemin sans caractère générique est un chemin à correspondance exacte, tout comme un chemin se terminant par /. Ces règles d’itinéraire sont distinctes du modèle source de la réécriture d’URL, que la référence des actions décrit comme reposant sur une correspondance de préfixe.

Une fois un itinéraire correspondant trouvé, Azure traite son ensemble de règles dans l’ordre. La documentation sur les itinéraires précise qu’un ensemble de règles peut remplacer le groupe d’origines utilisé pour la requête. Sans ensemble de règles, Azure transmet la requête au groupe d’origines sans modification.

Comment configurer et inspecter la réécriture ?

Dans l’action de l’ensemble de règles, la configuration consiste à saisir le préfixe source et le chemin de destination, puis à choisir Oui pour Conserver le chemin sans correspondance. La valeur / sert de modèle source lorsque l’action doit s’appliquer à tous les chemins d’URL pris en compte par l’itinéraire. La référence des actions documente également la capture dynamique du chemin d’URL au moyen de la variable serveur {url_path:seg#}, ainsi que la conversion en minuscules ou en majuscules au moyen de {url_path.tolower} et de {url_path.toupper}.

Les propriétés sourcePattern, destination et preserveUnmatchedPath sont à examiner dans la définition de la règle déployée. La requête est réécrite pendant son acheminement vers l’origine ; le résultat à vérifier est donc le chemin transmis par Azure Front Door après la sélection de l’itinéraire et le traitement des règles.

Termes associés

Questions fréquentes

Le modèle source de la réécriture utilise-t-il un caractère générique ?

Azure décrit le modèle source comme reposant sur une correspondance de préfixe. La syntaxe des caractères génériques de l’itinéraire relève d’une fonctionnalité distincte de correspondance des chemins, tandis que / est la valeur du modèle source qui correspond à tous les chemins d’URL.

Que se passe-t-il lorsque Conserver le chemin sans correspondance est réglé sur Oui ?

La partie du chemin qui reste après le modèle source correspondant est ajoutée au chemin de destination. Le paramètre s’applique à l’action Réécriture d’URL qui envoie la requête vers l’origine.

Que se passe-t-il lorsqu’aucun chemin d’itinéraire ne correspond à la requête ?

Azure Front Door recherche un chemin exact, puis un chemin correspondant comportant un caractère générique. Si le service ne trouve ni l’un ni l’autre, la documentation sur la correspondance des itinéraires indique qu’il rejette la requête avec une erreur 404 Bad Request.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment Azure Front Door conserve-t-il le reste d’un chemin lors d’une réécriture ?