# 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 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

- [Rediriger un domaine vers l'app](/v1.0/redirections/rediriger-un-domaine-vers-l-app)
- [Créer un sous-domaine pour un réseau ou un client](/v1.0/redirections/creer-un-sous-domaine-reseau-ou-client)
- [Référence des redirections](/v1.0/redirections/reference)
