# Référence des redirections

> Écrans, champs, statuts, codes HTTP et limites des redirections d'app et des redirections réseau ou client.

Les redirections se gèrent depuis la console Wakastart. Il n'existe pas d'API publique pour ces opérations.

## Écrans

| Écran | Chemin dans la console | Accès |
|---|---|---|
| Section **Redirections** (déclaration) | *App* > **Architecture** > **URLs** | Droit « Infra Client » ; visible si l'app a un domaine personnalisé |
| Section **Redirections** (instanciation) | *App* > **Environnements** > *environnement* > onglet **URLs & IAM** | Droit « Gérer les URLs/routage », plus « Accès infrastructure en production » en prod |
| Onglet **Redirections d'URL** d'un réseau | **Administration** > **Réseaux** > *réseau* | Administrateur réseau du réseau |
| Onglet **Redirections d'URL** d'un client | Configuration du client | Administrateur client du client |

## Redirection d'app

| Champ | Valeurs | Notes |
|---|---|---|
| **Domaine** | Domaine personnalisé de l'app | Les domaines plateforme ne sont pas proposés |
| **Sous-domaine source** | `^[a-z][a-z0-9-]{0,61}[a-z0-9]$`, ou vide pour la racine | Une redirection par source et par domaine |
| **Cible** | Une URL active (**URLs de l'app**) ou le domaine racine (**Domaine racine (apex)**) de l'app | Adresse cible : `https://<nom cible dans l'environnement>` |

## Redirection réseau ou client

| Champ | Valeurs | Notes |
|---|---|---|
| **Application** | Une application du client | Fixée pour un réseau |
| **Sous-domaine** | Minuscules, chiffres, tirets | Non modifiable après création |
| **Domaine** | Domaine plateforme ou domaine personnalisé de l'app | Non modifiable après création |
| **Route cible** | Une route active de l'app | Modifiable |
| **Environnement cible** | Un environnement actif de l'app | Modifiable ; son préfixe s'applique au nom source |
| **Chemin de destination** | Commence par `/`, 255 caractères au plus | Remplace le chemin de la route |
| **Paramètres (query string)** | Sans `?`, 255 caractères au plus | Ajoutés à la cible après `?` |

| Statut affiché | Valeur |
|---|---|
| **En attente** | `PENDING` |
| **En cours de création** | `PROVISIONING` |
| **Active** | `PROVISIONED` |
| **Erreur** | `FAILED` |
| **En cours de suppression** | `DESTROYING` |
| **Supprimée** | `DESTROYED` |

Badge **Cible modifiée** : la cible calculée a changé depuis la dernière application.

## Comportement HTTP

| Requête | Réponse |
|---|---|
| `http://<source>/…` | `301` vers `https://<source>/…` |
| `https://<source>/…` | `302` vers l'adresse cible fixe, sans le chemin ni les paramètres d'origine |
| Nom inconnu du proxy de redirection | `404` |

## Limites

| Élément | Valeur |
|---|---|
| Redirection depuis la racine | Une par domaine, incompatible avec un domaine racine exposé |
| Redirections par nom source | Une |
| Code HTTP | `302`, non paramétrable |
| Conservation du chemin et des paramètres d'origine | Non |
| Certificat du nom source | Let's Encrypt, un par nom d'hôte |
