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.
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'app | Redirection 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 nouveau | Donner à un réseau ou à un client son propre sous-domaine d'entrée |
| Déclarée dans | Architecture > URLs, section Redirections | Onglet Redirections d'URL du réseau ou de la configuration du client |
| Source | Un sous-domaine ou la racine d'un domaine personnalisé | Un sous-domaine d'un domaine personnalisé ou d'un domaine plateforme |
| Cible | Une URL ou le domaine racine de l'app | Une route de l'app, dans un environnement choisi |
| Chemin et paramètres de la cible | Aucun : https://<nom cible> | Chemin et paramètres au choix |
| Mise en ligne | Instanciée environnement par environnement | Mise 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 redirection301vershttps://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=mailmè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
wwwsurexemple.fr, instanciée en staging avec le préfixestaging:www.staging.exemple.frredirige vershttps://staging.exemple.fr(la racine de staging) ; - redirection réseau
client-xsur 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
wwwvers la racine : domaine racineexemple.frexposé, redirection d'app depuiswwwvers Domaine racine (apex).- Ancien nom : après un renommage, redirection d'app depuis
ancien-nomsurexemple.frvers l'URLapp. - Entrée par client : redirection client
acmesurexemple.frvers la route front, environnement prod, Chemin de destination/login, Paramètres (query string)org=acme. Le client reçoit l'adressehttps://acme.exemple.fr.