Outils pour les domaines personnalisés
Vous reliez et gérez les domaines avec les outils d’hébergement.
Sur cette page
Reliez un domaine, vérifiez son DNS et choisissez le domaine principal. Configurez vous-même les enregistrements DNS chez votre fournisseur.
À savoir
La connexion inclut le Space. Vous en êtes membre, et il n’est pas bloqué. Un Space est un espace de travail partagé dans l’app.
Les quatre outils nécessitent le rôle Propriétaire, Administrateur ou Utilisateur. Le rôle Lecture seule ne suffit pas.
hosting_add_domain Add domain
modifie des données
Ajoute un domaine personnalisé à un projet. Le domaine est ensuite en attente : il ne sert le site que lorsque le DNS est configuré, que hosting_check_domain l’a reconnu comme correct et que le certificat est disponible.
La réponse indique les enregistrements DNS nécessaires. S’ils manquent à cause d’une transmission en attente, appelez hosting_check_domain.
- Le nom d’hôte comporte au maximum 253 caractères, n’est pas une adresse IP et ne contient ni
https://ni chemin. TEISENDA refuse les noms des zonesteisenda.com,teisendapages.cometteisendahosting.com. - Un projet peut avoir au maximum 19 domaines personnalisés.
- L’offre limite les domaines personnalisés par Space : autant que le nombre de projets autorisé, soit 1 avec Free et 10 avec Max. Un abonnement Max permet des packs de 5 projets et donc 5 domaines personnalisés supplémentaires chacun ; consultez Acheter et retirer des packs. Si le nombre est atteint, TEISENDA refuse l’appel et ne modifie rien.
Quels enregistrements DNS la réponse indique-t-elle, et à quoi servent-ils ?
La liste ne contient un enregistrement AAAA que si le nœud d’hébergement en indique un. L’enregistrement TXT nommé _teisenda-hosting.<Domain> avec la valeur teisenda-hosting=<Nachweis> prouve que le domaine vous appartient.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
hostname | Texte | obligatoire | Un nom d’hôte sans https:// ni chemin, par exemple www.example.com. |
hosting_check_domain Check domain
modifie des données
Vérifie le DNS et active le domaine si les enregistrements sont corrects. Le certificat est ensuite émis en arrière-plan.
Rappelez l’outil pour vérifier l’état actuel. Après un échec du certificat, il lance une nouvelle tentative.
Si le DNS est incorrect, la réponse indique les problèmes et Définissez soit l'enregistrement CNAME, soit l'enregistrement A, ainsi que l'enregistrement TXT comme preuve de propriété..
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
hostname | Texte | obligatoire | Un nom d’hôte sans https:// ni chemin, par exemple www.example.com. |
hosting_set_primary_domain Set primary domain
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Définit le domaine principal : l’adresse vers laquelle toutes les autres adresses du projet redirigent. C’est un domaine personnalisé actif ou, si hostname manque, l’adresse TEISENDA du projet.
Le domaine principal change dès le premier appel. Un domaine personnalisé doit être actif ; les visiteurs voient la modification dès sa transmission.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
hostname | Texte | facultatif | Le domaine personnalisé à utiliser comme domaine principal : un nom d’hôte sans https:// ni chemin, par exemple www.example.com. S’il manque, l’adresse TEISENDA devient le domaine principal. |
hosting_remove_domain Remove domain
modifie des donnéessupprime, remplace ou modifie des éléments visiblesdeux étapes
Retire le domaine et le certificat. S’il était le domaine principal, l’adresse TEISENDA reprend ce rôle.
Appelez d’abord l’outil sans confirm. Seul le second appel avec la phrase de confirmation fournie retire le domaine ; l’application doit obtenir votre accord auparavant.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro du projet indiqué par hosting_list_projects. |
hostname | Texte | obligatoire | Un nom d’hôte sans https:// ni chemin, par exemple www.example.com. |
confirm | Texte | facultatif | Les instructions demandent à l’application de l’omettre lors du premier appel ; la réponse indique alors une phrase de confirmation. Elle ne doit envoyer exactement cette phrase qu’après votre accord. |
En cas de problème
Si une solution mentionne un outil, demandez à l’application de l’appeler. Les messages concernant l’offre indiquent le chemin vers les paramètres du Space ; l’entrée s’appelle Facturation.
Ce n'est pas un nom d'hôte valide. Saisissez-le sans https:// et sans chemin.
Le nom d’hôte est invalide. Il doit comporter au maximum 253 caractères, ne pas être une adresse IP et ne contenir ni https:// ni chemin. Indiquez uniquement le nom d’hôte, par exemple www.example.com.
Ce domaine est bloqué.
Le nom d’hôte appartient à une zone interdite aux projets : teisenda.com ou teisendapages.com. Utilisez un domaine personnalisé.
Les adresses de cette zone sont attribuées exclusivement par TEISENDA.
Le nom d’hôte appartient à la zone teisendahosting.com, où TEISENDA attribue les adresses TEISENDA. Utilisez un domaine personnalisé.
Ce domaine mène déjà à un projet.
Le domaine est déjà relié à un projet : celui-ci, un autre projet du Space ou un projet d’un autre Space. Le même message apparaît si le nœud d’hébergement connaît le domaine pour un projet. Un nom d’hôte ne peut appartenir qu’à un projet, tous Spaces confondus. Retirez-le d’abord de l’autre projet avec hosting_remove_domain, ou choisissez un autre nom d’hôte.
Il n'est pas possible d'avoir plus de … domaines personnalisés.
Le projet a déjà 19 domaines personnalisés. Retirez d’abord un domaine.
L'offre de ce Space n'autorise aucun domaine personnalisé supplémentaire : … sur … sont ajoutés. Rien n'a été modifié. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.
L’offre du Space n’autorise aucun domaine personnalisé supplémentaire : autant sont autorisés que le nombre de projets de l’offre. TEISENDA n’a rien modifié. Retirez un domaine. Max et ses packs autorisent davantage de projets et donc de domaines personnalisés ; consultez Offres Free et Max et Acheter et retirer des packs.
Le domaine … n'appartient pas à ce projet.
Le domaine n’appartient pas à ce projet. Consultez les domaines du projet avec hosting_project_status.
Possible seulement une fois le domaine actif.
hosting_set_primary_domain a été appelé pour un domaine encore inactif. Terminez la configuration du DNS et appelez hosting_check_domain jusqu’à ce que le domaine soit actif.
Le DNS de … n'est pas encore correct :
Ce n’est pas un refus : hosting_check_domain a constaté que le DNS du domaine n’est pas encore correct. Une ligne par problème suit la phrase ; ces lignes sont expliquées dans la section suivante. Configurez les enregistrements chez votre fournisseur DNS et rappelez hosting_check_domain.
Problèmes signalés par hosting_check_domain
Aucune de ces lignes n’est un refus. Les neuf premières figurent dans le résultat de hosting_check_domain tant que le DNS est incorrect. Les trois dernières correspondent au problème enregistré pour le domaine ; hosting_project_status et hosting_check_domain l’affichent comme problème du domaine.
Il n'existe aucun enregistrement DNS pour ce domaine.
Le nom du domaine ne mène nulle part : au bout de sa chaîne CNAME, le nœud ne trouve ni enregistrement A ni AAAA. Configurez l’enregistrement CNAME ou A indiqué dans le résultat.
L'enregistrement A est manquant.
Le domaine a un enregistrement AAAA, mais aucun A. Ajoutez l’enregistrement A avec la valeur indiquée dans le résultat, ou le CNAME à sa place.
Il existe un autre enregistrement A qui pointe ailleurs.
En plus de l’enregistrement A pointant vers le nœud, le domaine en a un autre qui pointe ailleurs. Supprimez cet autre enregistrement A chez votre fournisseur DNS.
Le domaine pointe vers un autre serveur.
Le domaine a des enregistrements A, mais aucun n’est l’adresse du nœud d’hébergement : il pointe vers un autre serveur. Remplacez le CNAME ou l’enregistrement A existant par celui indiqué dans le résultat.
Il existe un enregistrement AAAA qui pointe ailleurs.
Le domaine a un enregistrement AAAA qui n’est pas l’adresse IPv6 du nœud. L’autorité de certification privilégie IPv6 et échoue avec cet enregistrement. Supprimez cet AAAA, ou utilisez la valeur indiquée dans le résultat si celui-ci en fournit une.
Un enregistrement CAA interdit l'émission du certificat.
Un enregistrement CAA du domaine ou d’un nom parent n’autorise que des autorités de certification autres que Let’s Encrypt, utilisée par le nœud. Modifiez ou supprimez le CAA chez votre fournisseur DNS afin d’autoriser letsencrypt.org.
La preuve de propriété est manquante : l'enregistrement TXT n'est pas défini.
La preuve de propriété manque : le domaine ne pointe pas par CNAME vers une adresse du même projet sous teisendahosting.com, et le TXT _teisenda-hosting.<Domain> ne porte pas la valeur attendue. Un enregistrement A seul ne prouve rien. Configurez le TXT avec le nom et la valeur indiqués dans le résultat.
Le DNS du domaine ne répond pas.
Les résolveurs interrogés par le nœud n’ont pas répondu pour le domaine. Le DNS n’a donc pas pu être vérifié. Vérifiez auprès de votre fournisseur DNS que le domaine se résout et rappelez hosting_check_domain.
Les enregistrements ne sont pas encore arrivés partout. Réessayez dans quelques minutes.
L’un des deux résolveurs publics interrogés par le nœud voit déjà correctement les enregistrements, l’autre pas encore. Cette ligne apparaît alors seule. Attendez quelques minutes et rappelez hosting_check_domain.
Le DNS n'est pas encore correct.
Lors d’une tentative d’activation, le DNS n’était pas correct à cet instant. Aucun certificat n’a donc été demandé. Corrigez le DNS et rappelez hosting_check_domain.
Le certificat a été refusé.
L’émission du certificat a échoué, quelle qu’en soit la cause. Le domaine a alors l’état failed. Vérifiez les enregistrements DNS, particulièrement un CAA, et rappelez hosting_check_domain ; cela lance une nouvelle tentative dès que le DNS est correct. Si le problème persiste, contactez le support.
Le nœud d'hébergement signale un problème avec ce domaine.
Le nœud signale un problème pour lequel TEISENDA n’a pas de phrase spécifique, par exemple si un redémarrage du nœud a interrompu l’émission du certificat. Rappelez hosting_check_domain.
Les messages concernant le Space et le numéro de projet figurent dans les outils pour les Spaces et les projets. Les autres messages communs aux outils figurent dans Résoudre les problèmes du Connector.