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
PENDING: la demande est enregistrée. La plateforme la prend en charge en quelques secondes.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.PROVISIONED: le certificat est valide, le DNS est écrit, le trafic est servi.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.
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 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: unCNAME appest ajouté dans la zoneexemple.fr, un certificat est demandé pourapp.exemple.fr, la route passe àPROVISIONED. - Passage de
appen préfixestaging:app.staging.exemple.frreçoit son propre enregistrement et son propre certificat ;app.exemple.frest retiré de cet environnement une fois le nouveau nom prêt. - Domaine racine
exemple.fr: un enregistrementA(ouAAAA) 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.