Domaines

Cette page donne les valeurs exactes des enregistrements, les statuts et les règles de propriété. Pour brancher un domaine pas à pas, voir Brancher un domaine.

Enregistrements DNS

Deux enregistrements, chez ton hébergeur DNS : un TXT de preuve, et un trafic qui arrive sur Host.

Enregistrement	Nom	Valeur	Quand
TXT	_agenthost.<domaine>	Le jeton affiché dans la console	Toujours : prouve que le domaine t’appartient
CNAME	<sous-domaine>	La cible affichée dans la console	Pour un sous-domaine, comme www
A	<domaine racine>	L’adresse IPv4 affichée dans la console	Pour un domaine racine, comme exemple.ch

Le CNAME ne peut pas être posé sur la racine d’un domaine : le DNS l’interdit. Pour un domaine racine, utilise le A.

Les valeurs peuvent changer. La console affiche toujours les valeurs à utiliser : suis-les plutôt qu’une valeur copiée d’une ancienne page. L’icône à côté du nom et de la valeur les copie. Dans Modifier, la même icône copie le domaine.

Statuts

Ce que dit la carte	Signification	Servi ?
Configuration en attente	Le TXT, le trafic ou le certificat manque	Non
Configuration valide	Le TXT est là, le trafic arrive et le certificat est émis	Oui
Configuration incorrecte	Le trafic n’arrive pas à Host, ou le certificat a échoué	Non

Une carte qui n’est pas Configuration valide a le bouton Voir ce qui ne va pas : il ouvre les enregistrements encore en attente, ou l’erreur du certificat.

Un domaine valide est revérifié chaque jour. Si le TXT disparaît, une seconde vérification a lieu une heure plus tard. Si elle échoue aussi, la carte repasse en attente et le domaine n’est plus servi.

La vérification se relance toutes les 15 minutes tant que la configuration n’est pas valide. L’icône à côté de Modifier la relance tout de suite. Une configuration déjà valide reste valide pendant cette revérification.

Certificat HTTPS

Dès que le DNS est bon, Host demande un certificat HTTPS. Il se renouvelle seul. La carte n’affiche pas la date d’échéance. Tant que le certificat n’est pas émis, elle reste Configuration en attente. S’il échoue, elle passe à Configuration incorrecte. Un certificat n’est émis que pour un domaine dont le trafic arrive bien.

Usages

La colonne à droite du nom dit ce que le domaine sert. Modifier change ce choix, ou retire le domaine.

Colonne	Ce qui est servi
Production	Le dernier déploiement de production prêt
Preview	La dernière preview prête de la branche affichée en dessous, par exemple staging
Redirection	Un autre domaine du même projet, avec le code et la cible en dessous. Le chemin est conservé

Dans Ajouter un domaine ou Modifier, ce choix s’appelle Relier à un environnement (Production ou Preview) ou Rediriger vers un domaine.

Une redirection vise un domaine du même projet qui sert un site. Une redirection ne peut pas pointer vers une autre redirection.

Pour un domaine racine en production, la case Ajouter aussi www. crée www en redirection permanente vers le domaine racine.

Codes de redirection

Code	Type	Méthode conservée
308	Permanente (par défaut)	Oui
301	Permanente	Non
307	Temporaire	Oui
302	Temporaire	Non

Préfère 308 ou 307 : elles conservent la méthode et le corps de la requête.

Propriété

• La preuve TXT l’emporte. Une revendication non prouvée par une autre organisation ne bloque pas le propriétaire réel : l’organisation qui pose le TXT obtient le domaine.
• Deux TXT prouvés en même temps : le premier prouvé garde le domaine.
• Les noms de la plateforme ne peuvent pas être ajoutés comme domaine client : Host répond « Ce domaine appartient à la plateforme. »

Limites

Limite	Valeur
Domaines par organisation	50
Vérifications de domaine	20 par minute, avec des rafales de 5
Revendications concurrentes d’un même nom	10 au plus

Voir Limites.

Propagation DNS

Un enregistrement neuf peut mettre de quelques minutes à quelques heures à apparaître. La vérification interroge des résolveurs DNS publics. Si aucun résolveur ne répond, le statut ne change pas.