Skip to content

Fonctionnement des redirections

Les deux sortes de redirections, leur code HTTP, ce qu'elles conservent de la requête, leurs conflits avec les URLs et le domaine racine, et leurs limites.

ConceptDeveloperAdministrator

This page has not been translated yet and is shown in French.

Une redirection associe un nom d'hôte source à une adresse cible. Le visiteur qui ouvre le nom source reçoit une réponse 302 vers la cible. Les deux sortes de redirections partagent ce mécanisme ; elles diffèrent par ce qu'elles ciblent et par qui les gère.

Définition

Redirection d'appRedirection réseau ou client
Sert àFaire pointer un nom de votre domaine vers une URL de l'app : www vers la racine, un ancien nom vers le nouveauDonner à un réseau ou à un client son propre sous-domaine d'entrée
Déclarée dansArchitecture > URLs, section RedirectionsOnglet Redirections d'URL du réseau ou de la configuration du client
SourceUn sous-domaine ou la racine d'un domaine personnaliséUn sous-domaine d'un domaine personnalisé ou d'un domaine plateforme
CibleUne URL ou le domaine racine de l'appUne route de l'app, dans un environnement choisi
Chemin et paramètres de la cibleAucun : https://<nom cible>Chemin et paramètres au choix
Mise en ligneInstanciée environnement par environnementMise en ligne dès l'enregistrement

Pourquoi ça existe

Les visiteurs tapent www.exemple.fr, gardent d'anciens favoris ou reçoivent une adresse personnalisée dans un e-mail. Plutôt que de servir l'application sous tous ces noms — avec autant de certificats, d'hôtes IAM et de risques de contenu dupliqué — une redirection les ramène vers l'adresse canonique. Pour un réseau ou un client, le sous-domaine dédié donne une porte d'entrée reconnaissable sans créer une URL par tenant dans l'architecture.

Comment ça marche

Code HTTP et contenu de la réponse

  • Une requête en http:// reçoit d'abord une redirection 301 vers https:// sur le même nom.
  • En HTTPS, le proxy de redirection répond par une redirection temporaire 302. Le code n'est pas paramétrable.
  • La cible est fixe : le chemin et les paramètres de la requête d'origine ne sont pas repris. https://www.exemple.fr/promo?ref=mail mène à https://exemple.fr, pas à https://exemple.fr/promo?ref=mail.
  • Pour une redirection réseau ou client, la cible est https://<nom de la route dans l'environnement cible><chemin>[?<paramètres>]. Le chemin est celui que vous saisissez dans Chemin de destination, sinon celui de la route.
  • Un nom d'hôte que le proxy ne connaît pas reçoit une réponse 404.

Nom source et environnement

Le nom source reçoit le préfixe de l'environnement, comme une URL :

  • redirection d'app www sur exemple.fr, instanciée en staging avec le préfixe staging : www.staging.exemple.fr redirige vers https://staging.exemple.fr (la racine de staging) ;
  • redirection réseau client-x sur un domaine plateforme, environnement cible prod sans préfixe : client-x.<identifiant de l'app>.<domaine-plateforme>.

Pour une redirection réseau ou client, le préfixe est celui de l'environnement cible. Changer d'environnement cible peut donc changer le nom source.

Conflits et priorités

Il n'y a pas d'ordre de priorité entre une URL, un domaine racine et une redirection : un nom d'hôte ne sert qu'à une seule chose. La plateforme refuse les combinaisons qui se chevauchent :

  • une seule redirection par nom source et par domaine ;
  • une seule redirection depuis la racine par domaine, et jamais en même temps qu'un domaine racine exposé ;
  • une URL ou un domaine racine ciblé par une redirection ne peut pas être supprimé tant que la redirection existe.

N'utilisez pas comme source un sous-domaine qui porte déjà une URL de l'app : choisissez l'un ou l'autre.

Écart de cible

Une redirection réseau ou client calcule sa cible à partir de la route et de l'environnement. Si la route change (nouveau chemin, nouveau préfixe), la redirection affiche le badge Cible modifiée jusqu'à ce que la nouvelle cible soit appliquée.

Exemples

  • www vers la racine : domaine racine exemple.fr exposé, redirection d'app depuis www vers Domaine racine (apex).
  • Ancien nom : après un renommage, redirection d'app depuis ancien-nom sur exemple.fr vers l'URL app.
  • Entrée par client : redirection client acme sur exemple.fr vers la route front, environnement prod, Chemin de destination /login, Paramètres (query string) org=acme. Le client reçoit l'adresse https://acme.exemple.fr.

Pour aller plus loin