Skip to content

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.

ConceptDeveloper

This page has not been translated yet and is shown in French.

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émentCe qui est crééDétail
Rattachement à la gatewayUn écouteur HTTPS (port 443) pour le nom d'hôte, et les règles qui envoient chaque chemin vers son serviceLa gateway est celle de l'environnement : mutualisée par défaut, dédiée si vous en avez une
Certificat TLSUn certificat Let's Encrypt par nom d'hôte, validé par le défi HTTP-01Pas de certificat wildcard. Le renouvellement est automatique
Enregistrement DNSUn CNAME vers le nom d'hôte de la gateway, ou un enregistrement A vers son adresse si elle n'a pas de nomTTL 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

Loading diagram…
  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.

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 : 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éeDédiée
ChoixDécidée par la plateforme, par défautCréée par l'équipe Wakastart à votre demande, puis choisie dans l'environnement
Adresse IP publiquePartagée avec d'autres appsPropre à l'environnement
Bascule—Changement d'adresse : courte coupure le temps de la propagation DNS

Voir Utiliser une gateway dédiée.

Pour aller plus loin