Référence
Domaines
Enregistrements DNS, statuts, usages, codes de redirection et règles de propriété des 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.
Statuts
| Statut | Signification | Servi ? |
|---|---|---|
| En attente des DNS | Le TXT ou le trafic manque | Non |
| Vérifié | Le TXT est là et le trafic arrive | Oui |
| Ne pointe pas vers nous | Le TXT est là, mais le trafic n’arrive pas à Host | Non |
Un domaine vérifié est revérifié chaque jour. Si le TXT disparaît, une seconde vérification a lieu une heure plus tard. Si elle échoue aussi, le domaine repasse en attente et n’est plus servi.
La vérification se relance toutes les 15 minutes tant que le domaine n’est pas vérifié. Vérifier la relance tout de suite.
Certificat HTTPS
Dès qu’un domaine est Vérifié, Host demande un certificat HTTPS. Le certificat affiche sa date d’échéance dans la console, et se renouvelle seul. Un certificat n’est émis que pour un domaine vérifié.
Usages
| Usage | Ce qui est servi |
|---|---|
| Production | Le dernier déploiement de production prêt |
| Branche | La dernière preview prête de la branche choisie, par exemple staging.exemple.ch |
| Redirection | Un autre domaine du même projet, chemin conservé |
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, 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.
Cette page t'a aidé ?
Merci, c'est noté.