# Référence des domaines et URLs

> Écrans, champs, formats, statuts et limites des domaines, URLs, routes, domaines racines, préfixes et hôtes IAM.

Les domaines et les URLs se gèrent depuis la console Wakastart (`https://app.wakastart.app`). Il n'existe pas d'API publique pour ces opérations.

## Écrans

| Écran | Chemin dans la console | Accès |
|---|---|---|
| **Domaines** | *App* > **Architecture** > **URLs** > **Domaines** | Droit « Infra Client » |
| **URLs publiques** | *App* > **Architecture** > **URLs** | Droit « Infra Client » |
| **URLs & IAM** | *App* > **Environnements** > *environnement* > onglet **URLs & IAM** | Droit « Voir les URLs/routage » pour l'afficher, « Gérer les URLs/routage » pour agir, « Modifier un environnement » pour le préfixe et la gateway ; « Accès infrastructure en production » en plus sur un environnement prod |
| Section **Hôtes IAM** | Onglet **URLs & IAM** | Niveau Administrateur réseau et droit « Gérer les URLs/routage » |
| **Mapping IAM** | *App* > **Environnements** > onglet **Mapping IAM** | Droit « Infra Client » |

## Domaine

| Champ à l'écran | Format | Notes |
|---|---|---|
| **Nom de domaine** | 1 à 255 caractères | Unique sur toute la plateforme. Non modifiable |
| **Provider DNS** | **OVH**, **IONOS Cloud**, **IONOS Hosting** | Non modifiable depuis la console |
| **Zone DNS** | Nom de la zone chez le fournisseur | La zone doit déjà exister chez le fournisseur |
| **Credentials DNS** | Champs propres au fournisseur | Stockés dans le coffre, jamais réaffichés |

| Fournisseur | Champs d'identifiants |
|---|---|
| OVH | **OVH Endpoint** (`ovh-eu`, `ovh-ca`, `ovh-us`), **Application Key**, **Application Secret**, **Consumer Key** |
| IONOS Cloud | **API Token** |
| IONOS Hosting | **API Key** |

| État affiché (colonne **Credentials DNS**) | Signification |
|---|---|
| **Aucun credential DNS configuré** | Aucun identifiant enregistré |
| **Configuration en cours...** | Identifiants enregistrés, mise à disposition en cours |
| **Credentials actifs** | Identifiants disponibles pour les écritures DNS |
| **Échec de la configuration** | La mise à disposition a échoué ; le motif s'affiche dessous |

## URL

| Champ | Format | Notes |
|---|---|---|
| **Sous-domaine** | `^[a-z][a-z0-9-]{0,61}[a-z0-9]$` ou une seule lettre, 63 caractères au plus | Unique par domaine dans l'app |
| **Domaine** | Domaine plateforme ou domaine personnalisé de l'app | — |

Statuts d'une URL dans l'architecture : **Actif**, **Détachée** (sans domaine), **Suppression...**, **Supprimé**.

## Route

| Champ | Valeurs | Défaut |
|---|---|---|
| **URL de rattachement** | Une URL active de l'app | — |
| **Chemin** | Commence par `/`, sans `/` final sauf pour `/` | `/` |
| **Type de chemin** | `PathPrefix`, `Exact`, `RegularExpression` | `PathPrefix` |
| **Service** | Une définition de service de l'app | — |
| **Port (optionnel)** | À laisser vide | Port de la définition du service |
| **URL front officielle de l'app** | Case à cocher, une seule route par app, service de rôle FRONT | Non cochée |

Un même chemin ne peut exister qu'une fois par URL.

## Domaine racine

| Champ | Valeurs | Défaut |
|---|---|---|
| **Domaine** | Domaine personnalisé sans domaine racine ni redirection depuis sa racine | — |
| **Service** | Une définition de service de l'app | — |
| **Chemin** / **Type de chemin** | Comme une route | `/`, `PathPrefix` |

Un seul domaine racine par domaine. Enregistrement DNS toujours de type `A` ou `AAAA`.

## Préfixe d'environnement

| Règle | Valeur |
|---|---|
| Format | `^[a-z][a-z0-9-]{0,19}$` : commence par une lettre minuscule, puis minuscules, chiffres et tirets, 20 caractères au plus |
| Vide | Noms publiés sans préfixe ; un seul environnement par app |
| Unicité | Un préfixe par environnement au sein d'une app |

## Formule du nom d'hôte

| Cas | Nom d'hôte |
|---|---|
| URL sur un domaine personnalisé | `<sous-domaine>[.<préfixe>].<domaine>` |
| URL sur un domaine plateforme | `<sous-domaine>[.<préfixe>].<identifiant court de l'app>.<domaine>` |
| Domaine racine | `[<préfixe>.]<domaine>` |

## Statuts d'une route, d'un domaine racine ou d'une redirection dans un environnement

| Statut | Signification |
|---|---|
| `PENDING` | Instanciation enregistrée, pas encore prise en charge |
| `PROVISIONING` | Création du rattachement, du certificat et du DNS en cours |
| `PROVISIONED` | Certificat valide et DNS écrit, trafic servi |
| `FAILED` | Échec durable |
| `DESTROYING` | Retrait en cours |
| `DESTROYED` | Retiré |

## Hôte IAM

| Champ | Format | Notes |
|---|---|---|
| **Pattern d'hôte** | Nom d'hôte complet, 255 caractères au plus | Unique sur toute la plateforme pour une app |
| **Wildcard ( *. )** | Case à cocher | Couvre les sous-domaines du motif |
| **App mobile (deep link)** | Case à cocher | Remplace le motif par **Schéma** (`^[a-z][a-z0-9+.-]*$`, 100 caractères au plus) et **Chemin callback** (défaut `callback`) |
| **Actif** | Case à cocher | Un hôte inactif n'est plus résolu |
| Hôte local | `<identifiant de l'app>.localhost:<port>` | En dev uniquement |

## Valeurs fixées par la plateforme

| Élément | Valeur |
|---|---|
| Certificat | Let's Encrypt, défi HTTP-01, un par nom d'hôte, sans wildcard |
| Relance d'un certificat en échec | après 10 min, puis après 30 min ; `FAILED` au troisième échec |
| Redirection HTTP vers HTTPS | `301` |
| TTL des enregistrements DNS | 300 s (3 600 s chez IONOS Hosting) |
| Délais du load balancer | 180 s d'inactivité côté client et côté service, 20 s pour établir la connexion |
| Prise en charge d'une instanciation | demandes explicites toutes les 10 s, nouvelles ressources toutes les 30 s, rattrapage toutes les 5 min |
