# Créer un sous-domaine pour un réseau ou un client

> Donner à un réseau ou à un client sa propre adresse d'entrée, qui redirige vers une route de l'application avec un chemin et des paramètres choisis.

Une redirection réseau ou client donne à un tenant une adresse reconnaissable — `acme.exemple.fr` — qui mène à une page précise de l'application, par exemple sa page de connexion avec un paramètre qui l'identifie. Elle se crée depuis le réseau ou le client, sans toucher à l'architecture de l'app.

## Avant de commencer

- L'application a au moins un domaine : un domaine plateforme, ou un domaine personnalisé avec des identifiants DNS actifs. Sinon, le dialogue affiche « Aucun domaine n'a été configuré pour cette application. Créez d'abord un domaine pour pouvoir configurer une redirection. »
- La route cible existe dans l'architecture et elle est en ligne dans l'environnement visé (voir [Mettre une route en ligne](/v1.0/domaines-et-urls/mettre-une-route-en-ligne)).
- Vous administrez le réseau ou le client concerné : une redirection ne peut être créée que pour votre propre réseau ou votre propre client.

## Ouvrir les redirections

- **Pour un réseau** : dans le menu, cliquez sur **Administration** > **Réseaux**, ouvrez le réseau, puis l'onglet **Redirections d'URL**. L'application est celle du réseau.
- **Pour un client** : ouvrez la configuration de votre client (voir [Organisations](/v1.0/organisations)), puis l'onglet **Redirections d'URL**. Choisissez l'application dans **Application**.

La liste **Redirections d'URL** affiche **Sous-domaine**, **Route cible**, **Environnement cible** et le statut de chaque redirection.

## Créer la redirection

1. Cliquez sur **Nouvelle redirection**.
2. Dans le bloc **Source** :
   1. Dans **Sous-domaine**, saisissez le libellé, par exemple `acme` (minuscules, chiffres et tirets).
   2. Dans **Domaine**, choisissez un domaine du groupe **Domaines plateforme** ou **Domaines personnalisés**.
3. Dans le bloc **Destination** :
   1. Dans **Route cible**, choisissez la route de l'app.
   2. Dans **Environnement cible**, choisissez l'environnement. L'**URL source calculée** se met à jour avec le préfixe de cet environnement.
   3. Optionnel : dans **Chemin de destination**, saisissez un chemin qui remplace celui de la route, par exemple `/login`. Il commence par `/`.
   4. Optionnel : dans **Paramètres (query string)**, saisissez les paramètres sans `?`, par exemple `org=acme`.
4. Vérifiez l'**URL source calculée** et l'**URL de destination calculée**, puis cliquez sur **Enregistrer**.

Résultat : le message **Succès** s'affiche et la redirection apparaît dans la liste avec le statut **En attente**, puis **En cours de création**, puis **Active**.

## Modifier la cible

1. Sur la ligne de la redirection, cliquez sur l'icône **Modifier**. Le dialogue **Modifier la redirection** s'ouvre.
2. Changez la **Route cible**, l'**Environnement cible**, le **Chemin de destination** ou les **Paramètres (query string)**. La source ne se modifie pas.
3. Cliquez sur **Enregistrer**.

Résultat : la nouvelle cible est appliquée. Si l'environnement cible a un autre préfixe, le nom source change en conséquence.

Quand la route ciblée change dans l'architecture, la ligne affiche le badge **Cible modifiée** jusqu'à ce que la nouvelle adresse soit appliquée.

## Supprimer la redirection

1. Sur la ligne, cliquez sur l'icône **Supprimer**.
2. Dans **Supprimer cette redirection ?**, cliquez sur **Supprimer**.

Résultat : la ligne passe à **En cours de suppression**, puis disparaît. Le sous-domaine cesse de rediriger une fois la suppression terminée.

## Vérifier le résultat

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

```text
HTTP/2 302
location: https://app.exemple.fr/login?org=acme
```

## Dépannage

- « Ce sous-domaine est déjà utilisé sur ce domaine pour cette application. » : choisissez un autre libellé.
- « Non provisionné — cette route n'a pas encore de domaine attaché. » sous l'URL de destination : rattachez un domaine à l'URL de la route dans l'architecture.
- Autres cas : voir [Résoudre les problèmes de redirection](/v1.0/redirections/depannage).

## Voir aussi

- [Fonctionnement des redirections](/v1.0/redirections/fonctionnement-des-redirections)
- [Organisations](/v1.0/organisations)
