# DNS et certificats TLS

> Ce que Wakastart crée quand une route passe en ligne — DNS, certificat Let's Encrypt, rattachement à la gateway — et les statuts qui le suivent.

Vous n'écrivez aucun enregistrement DNS et ne commandez aucun certificat : la plateforme le fait au moment où une route, un domaine racine ou une redirection est instancié dans un environnement. Cette page décrit ce qui est créé, dans quel ordre, et comment le suivre.

## Définition

Instancier une route déclenche trois créations, toutes pilotées par Wakastart :

| Élément | Ce qui est créé | Détail |
|---|---|---|
| **Rattachement à la gateway** | Un écouteur HTTPS (port 443) pour le nom d'hôte, et les règles qui envoient chaque chemin vers son service | La gateway est celle de l'environnement : mutualisée par défaut, dédiée si vous en avez une |
| **Certificat TLS** | Un certificat Let's Encrypt **par nom d'hôte**, validé par le défi HTTP-01 | Pas de certificat wildcard. Le renouvellement est automatique |
| **Enregistrement DNS** | Un `CNAME` vers le nom d'hôte de la gateway, ou un enregistrement `A` vers son adresse si elle n'a pas de nom | TTL de 300 secondes (3 600 chez IONOS Hosting). Pour un domaine racine, toujours un `A` ou un `AAAA` |

Sur un domaine personnalisé, l'enregistrement est écrit **dans votre zone**, chez votre fournisseur, avec les identifiants que vous avez confiés à la plateforme. Sur un domaine plateforme, Wakastart l'écrit dans sa propre zone.

## Pourquoi ça existe

Un certificat HTTP-01 ne peut être délivré que si le nom d'hôte pointe déjà vers le serveur qui répond au défi. En confiant à la même plateforme le DNS, la gateway et la demande de certificat, l'ordre est toujours respecté et aucun nom n'est publié sans HTTPS. Le même mécanisme démonte tout proprement : retirer une route d'un environnement supprime sa règle, son certificat (s'il ne sert plus) et son enregistrement DNS.

## Comment ça marche

```mermaid
stateDiagram-v2
  [*] --> PENDING: Instancier
  PENDING --> PROVISIONING: prise en charge (10 s à 30 s)
  PROVISIONING --> PROVISIONED: certificat délivré et DNS écrit
  PROVISIONING --> FAILED: échec durable
  FAILED --> PROVISIONING: nouvel essai
  PROVISIONED --> PROVISIONING: route ou préfixe modifié
  PROVISIONED --> DESTROYING: Supprimer route
  DESTROYING --> DESTROYED: DNS, certificat et règle retirés
  DESTROYED --> [*]
```

1. **`PENDING`** : la demande est enregistrée. La plateforme la prend en charge en quelques secondes.
2. **`PROVISIONING`** : la plateforme crée l'écouteur, demande le certificat et écrit l'enregistrement DNS. Let's Encrypt ne délivre le certificat qu'une fois le nom résolu vers la gateway : la durée de cette étape dépend de la propagation DNS chez votre fournisseur. Aucun délai n'est garanti.
3. **`PROVISIONED`** : le certificat est valide, le DNS est écrit, le trafic est servi.
4. **`FAILED`** : un échec durable. Si l'émission du certificat échoue, la plateforme la relance après 10 minutes, puis après 30 minutes ; au troisième échec, la route passe à `FAILED`.

Ces statuts s'affichent dans l'onglet **URLs & IAM** de l'environnement, colonne **STATUS**. Le cycle commun à toutes les ressources est décrit dans [Cycle de vie des ressources](/v1.0/applications/cycle-de-vie).

### Modifier ce qui est en ligne

Tout changement qui modifie un nom d'hôte — nouveau préfixe d'environnement, URL rattachée à un domaine — recrée l'écouteur, un nouveau certificat et un nouvel enregistrement DNS. L'ancien nom continue de servir le trafic jusqu'à ce que le nouveau soit prêt, puis son enregistrement DNS est retiré.

### Les identifiants de votre fournisseur DNS

Les identifiants saisis pour un domaine personnalisé sont écrits dans le [coffre de secrets](/v1.0/glossaire#coffre-de-secrets) de la plateforme. Ils ne sont plus jamais affichés. La mention **Credentials actifs** signifie qu'ils sont enregistrés et mis à disposition du moteur DNS ; leur validité n'est vérifiée qu'à la première écriture d'un enregistrement.

La plateforme ne vérifie pas que vous êtes propriétaire du domaine : elle écrit dans la zone à laquelle vos identifiants donnent accès.

## Exemples

- **Première mise en ligne de `app.exemple.fr`** : un `CNAME app` est ajouté dans la zone `exemple.fr`, un certificat est demandé pour `app.exemple.fr`, la route passe à `PROVISIONED`.
- **Passage de `app` en préfixe `staging`** : `app.staging.exemple.fr` reçoit son propre enregistrement et son propre certificat ; `app.exemple.fr` est retiré de cet environnement une fois le nouveau nom prêt.
- **Domaine racine `exemple.fr`** : un enregistrement `A` (ou `AAAA`) vers l'adresse de la gateway est écrit à la racine de la zone.

## Comparaison : gateway mutualisée ou dédiée

| | Mutualisée | Dédiée |
|---|---|---|
| Choix | Décidée par la plateforme, par défaut | Créée par l'équipe Wakastart à votre demande, puis choisie dans l'environnement |
| Adresse IP publique | Partagée avec d'autres apps | Propre à l'environnement |
| Bascule | — | Changement d'adresse : courte coupure le temps de la propagation DNS |

Voir [Utiliser une gateway dédiée](/v1.0/domaines-et-urls/utiliser-une-gateway-dediee).

## Pour aller plus loin

- [Mettre une route en ligne](/v1.0/domaines-et-urls/mettre-une-route-en-ligne)
- [Ajouter un domaine personnalisé](/v1.0/domaines-et-urls/ajouter-un-domaine-personnalise)
- [Résoudre les problèmes de domaines et d'URLs](/v1.0/domaines-et-urls/depannage)
