Aller au contenu

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.

GuideAdministrateur
Accès requis
Administrateur réseau pour un réseau ; administrateur client pour un client
Durée
5 min
Voir en Markdown

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).
  • 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), 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/
Texte
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.

Voir aussi