# Rediriger un domaine vers l'app

> Déclarer une redirection d'app depuis un sous-domaine ou la racine de votre domaine, puis l'instancier dans chaque environnement.

Une redirection d'app fait pointer un nom de votre domaine vers une URL ou vers le domaine racine de l'application. Le cas le plus courant : `www.exemple.fr` vers `exemple.fr`. Comme une URL, elle se déclare une fois dans l'architecture et s'instancie par environnement.

## Avant de commencer

- La source est un **domaine personnalisé** de l'app, avec des identifiants DNS actifs. La section **Redirections** n'apparaît dans l'architecture que si l'app a un domaine personnalisé.
- La cible existe et est active : une URL de l'app, ou le domaine racine déclaré (voir [Exposer le domaine racine](/v1.0/domaines-et-urls/exposer-le-domaine-racine)).
- Le nom source n'est pas déjà utilisé par une URL de l'app. Pour rediriger depuis la racine, le domaine ne doit pas avoir de domaine racine exposé.

## Déclarer la redirection

1. Dans le menu, sous le nom de votre application, cliquez sur **Architecture**, puis sur **URLs**.
2. Dans la section **Redirections**, cliquez sur **Nouvelle redirection**.
3. Dans **Domaine**, choisissez le domaine source.
4. Dans **Sous-domaine source**, saisissez le sous-domaine, par exemple `www`. Laissez le champ vide pour rediriger depuis la racine du domaine.
5. Dans **Cible**, choisissez une adresse du groupe **URLs de l'app** ou **Domaine racine (apex)**.
6. Cliquez sur **Déclarer la redirection**.

Résultat : le message **Redirection déclarée** s'affiche, avec « Instanciez cette redirection dans un environnement pour la provisionner. » Rien n'est encore publié.

## Instancier la redirection

1. Ouvrez l'environnement, puis l'onglet **URLs & IAM**.
2. Dans la section **Redirections**, repérez la ligne dans **Redirections déclarées à instancier dans cet environnement** (**SOURCE**, **CIBLE**).
3. Cliquez sur **Instancier**. Si la source est la racine du domaine, lisez l'avertissement **Attention : exposition du domaine racine**, puis confirmez.

Résultat : le message **Redirection instanciée** s'affiche. La redirection suit le cycle `PENDING`, `PROVISIONING`, `PROVISIONED` : DNS et certificat du nom source, puis inscription auprès du proxy de redirection. En cas d'échec, le message d'erreur s'affiche sous le statut `FAILED`.

Répétez l'instanciation dans chaque environnement. Le nom source y prend le préfixe de l'environnement.

## Retirer ou supprimer la redirection

1. Dans chaque environnement, onglet **URLs & IAM**, cliquez sur **Supprimer** sur la ligne de la redirection, puis confirmez dans **Retirer la redirection de cet environnement**. Le message **Suppression de la redirection lancée** s'affiche.
2. Quand elle n'est plus instanciée nulle part, supprimez la déclaration dans **Architecture > URLs**, section **Redirections**, bouton **Supprimer**.

Pour changer la cible, supprimez la redirection et déclarez-en une nouvelle.

## Vérifier le résultat

```bash
curl -sI https://www.exemple.fr/
```

```text
HTTP/2 302
location: https://exemple.fr
```

## Voir aussi

- [Fonctionnement des redirections](/v1.0/redirections/fonctionnement-des-redirections)
- [Exposer le domaine racine](/v1.0/domaines-et-urls/exposer-le-domaine-racine)
- [Résoudre les problèmes de redirection](/v1.0/redirections/depannage)
