# Redirections

> Rediriger un domaine, sa racine ou un sous-domaine dédié à un réseau ou à un client vers une URL de votre application.

Une redirection renvoie le visiteur d'un nom d'hôte vers une adresse de votre application. Wakastart en propose deux sortes : la **redirection d'app**, qui fait pointer un nom de votre domaine vers une URL de l'app (`www.exemple.fr` vers `exemple.fr`), et la **redirection dédiée à un réseau ou à un client**, qui donne à un tenant son propre sous-domaine d'entrée (`client-x.exemple.fr` vers la page de connexion).

## Comment ça marche

```mermaid
sequenceDiagram
  participant N as Navigateur
  participant G as Gateway Wakastart
  participant P as Proxy de redirection
  participant A as Votre application
  N->>G: GET http://www.exemple.fr/promo
  G-->>N: 301 vers https://www.exemple.fr/promo
  N->>G: GET https://www.exemple.fr/promo
  G->>P: nom d'hôte www.exemple.fr
  P-->>N: 302 Location: https://exemple.fr
  N->>A: GET https://exemple.fr
```

1. La plateforme crée pour le nom source un enregistrement DNS et un certificat, comme pour une URL.
2. La gateway passe d'abord en HTTPS (301), puis confie la requête au proxy de redirection de la plateforme.
3. Le proxy choisit la cible **d'après le seul nom d'hôte** et répond par une redirection temporaire `302`. Le chemin de la requête d'origine n'est pas conservé.

Le détail est dans [Fonctionnement des redirections](/v1.0/redirections/fonctionnement-des-redirections).

## Choisissez votre redirection

::::cards{cols=2}
:::card{title="Redirection d'app" href="/v1.0/redirections/rediriger-un-domaine-vers-l-app" icon="Waypoints"}
Un sous-domaine ou la racine de votre domaine vers une URL ou le domaine racine de l'app. Déclarée dans l'architecture, instanciée par environnement.
:::
:::card{title="Sous-domaine réseau ou client" href="/v1.0/redirections/creer-un-sous-domaine-reseau-ou-client" icon="Building2"}
Un sous-domaine propre à un réseau ou à un client vers une route de l'app, avec un chemin et des paramètres au choix.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Comprendre les redirections" href="/v1.0/redirections/fonctionnement-des-redirections" icon="BookOpen"}
Code HTTP, conservation du chemin, conflits et limites.
:::
:::card{title="Rediriger www vers la racine" href="/v1.0/redirections/rediriger-un-domaine-vers-l-app" icon="Waypoints"}
Le cas le plus courant, pas à pas.
:::
:::card{title="Donner un sous-domaine à un client" href="/v1.0/redirections/creer-un-sous-domaine-reseau-ou-client" icon="Users"}
Une adresse d'entrée personnalisée par tenant.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Domaines et URLs" href="/v1.0/domaines-et-urls" icon="Globe"}
Déclarer les domaines et les URLs que les redirections ciblent.
:::
:::card{title="Organisations" href="/v1.0/organisations" icon="Building2"}
Les réseaux et les clients à qui vous attribuez un sous-domaine.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Comment la connexion se poursuit une fois le visiteur arrivé sur l'app.
:::
::::

## Ressources

- [Référence des redirections](/v1.0/redirections/reference)
- [Résoudre les problèmes de redirection](/v1.0/redirections/depannage)
