Votre application répond déjà sur un sous-domaine offert en .apps.heberghub.app. Ce guide la fait répondre aussi sur un nom que vous possédez, comme www.exemple.fr, avec un certificat HTTPS gratuit.
Le sous-domaine offert reste actif à côté de votre nom : rien ne change pour ceux qui l'utilisent déjà.
Ce qu'il vous faut
- Une application en ligne sur l'hébergement applicatif. Toutes les formules sont concernées, sans supplément.
- Un nom de domaine acheté chez un registrar. HebergHub ne vend pas de noms de domaine.
- L'accès à sa zone DNS, chez votre registrar ou votre hébergeur DNS.
Vous pouvez rattacher 5 noms au plus par application.
1. Déclarer le nom dans votre espace client
- Ouvrez la fiche de votre service dans votre espace client.
- Sur la carte de l'application, cliquez sur Réglages.
- Dans la section Domaines personnels, saisissez votre nom, sans
https://:exemple.frouwww.exemple.fr. - Laissez cochée la case Inclure aussi www si vous saisissez un nom comme
exemple.fret voulez aussiwww.exemple.fr. Cela compte pour un nom de plus. - Cliquez sur Ajouter ce nom.
Le panneau affiche alors les enregistrements à créer, avec un bouton Copier pour chacun. Le nom reste En attente du DNS tant que vous n'avez pas fini : il n'est pas encore réservé pour vous, le premier qui prouve qu'il en est propriétaire l'obtient.
2. Créer les enregistrements DNS
Dans la zone DNS de votre nom, créez les enregistrements indiqués par le panneau. Il y en a deux sortes.
Un enregistrement TXT, qui prouve que le nom est à vous. Sa valeur est propre à votre application :
| Type | Nom | Valeur |
|---|---|---|
| TXT | _heberghub-verify.exemple.fr |
hh-verify=... (à copier depuis le panneau) |
Un enregistrement qui dirige le nom vers votre application. Il dépend de la forme du nom :
| Votre nom | Type | Nom | Valeur |
|---|---|---|---|
www.exemple.fr, app.exemple.fr |
CNAME | le nom | votre-app.apps.heberghub.app |
exemple.fr, sans préfixe |
ALIAS ou ANAME | le nom | votre-app.apps.heberghub.app |
Selon les interfaces, le nom s'écrit en entier (www.exemple.fr) ou sans le domaine (www, ou _heberghub-verify pour le TXT). Certaines interfaces veulent un point final après la valeur.
Un nom sans préfixe, sans ALIAS
Beaucoup d'hébergeurs DNS ne proposent pas d'ALIAS. Vous pouvez alors créer un enregistrement A vers l'adresse IP affichée dans le panneau.
Cela fonctionne, avec une limite : si cette adresse change de notre côté, votre nom cesse de répondre, et nous ne pouvons pas vous prévenir. Si votre hébergeur DNS propose ALIAS ou ANAME, préférez-le. Vous pouvez aussi publier votre application sur www.exemple.fr, en CNAME, et rediriger exemple.fr vers lui chez votre registrar.
Trois réglages qui bloquent la vérification
- Cloudflare : mettez ces enregistrements en DNS only (nuage gris). Le proxy de Cloudflare n'est pas pris en charge.
- Autres adresses sur le nom : retirez tout autre enregistrement A du même nom, comme une page de parking du registrar.
- IPv6 : retirez tout enregistrement AAAA du même nom. La vérification le refuse, car le certificat pourrait être demandé à une autre adresse.
3. Lancer la vérification
Une fois les enregistrements créés, cliquez sur Vérifier.
La propagation DNS prend de quelques minutes à quelques heures. Si la vérification échoue, le message dit quoi corriger : attendez un peu, puis cliquez de nouveau. Les messages les plus courants sont expliqués plus bas.
Si tout est bon, votre application redémarre sur une nouvelle version pour prendre le nom en compte, sauf si elle est arrêtée : le nom sera pris en compte à son prochain démarrage.
4. Attendre le certificat
Le nom passe à Certificat en cours, puis à Actif. Le certificat HTTPS est émis par Let's Encrypt, en général en quelques minutes, parfois jusqu'à 24 heures si le DNS se propage lentement. Il est renouvelé automatiquement.
Une fois le nom Actif, ouvrez https://www.exemple.fr : vous arrivez sur votre application.
Si votre application construit ses liens à partir de son adresse publique, indiquez le nouveau nom dans ses variables d'environnement, puis redéployez-la.
Les états d'un nom
| État | Ce que cela veut dire |
|---|---|
| En attente du DNS | Enregistrements à créer, puis cliquer sur Vérifier |
| Raccordement en cours | Vérification réussie, mise en place du nom |
| Certificat en cours | Certificat HTTPS en cours d'émission |
| Actif | Le nom répond en HTTPS |
| Erreur | Le message indique la cause ; corrigez-la puis cliquez sur Vérifier |
| Retrait en cours | Le retrait se termine tout seul en quelques minutes |
Si la vérification échoue
| Message | Que faire |
|---|---|
| L'enregistrement TXT est introuvable | Vérifiez son nom et sa valeur, puis attendez la propagation |
| Le nom ne pointe encore vers aucune adresse | Créez le CNAME, l'ALIAS ou le A indiqué |
| Le nom ne pointe pas (ou pas seulement) vers votre application | Retirez les autres enregistrements A, et contrôlez la valeur |
| Le nom passe par le proxy de Cloudflare | Passez l'enregistrement en DNS only (nuage gris) |
| Le nom a un enregistrement AAAA (IPv6) | Retirez cet enregistrement |
| Ce nom est déjà utilisé | Il est rattaché ailleurs chez HebergHub. Si c'est bien le vôtre, ouvrez un ticket |
| Le certificat n'a pas pu être obtenu en 24 heures | Contrôlez le DNS et le proxy, puis cliquez sur Vérifier |
Pour contrôler vous-même votre DNS depuis un terminal :
dig +short www.exemple.fr
dig +short TXT _heberghub-verify.www.exemple.frLe premier doit donner les mêmes adresses que dig +short votre-app.apps.heberghub.app. Le second doit afficher votre valeur hh-verify=....
Retirer un nom
Dans Réglages, cliquez sur Retirer en face du nom, puis confirmez. Le nom cesse de répondre chez nous, et le sous-domaine offert reste actif. Vous pouvez ensuite supprimer les enregistrements DNS.
Pensez aussi à retirer les enregistrements si vous supprimez l'application ou résiliez le service : nos routes sont retirées automatiquement, mais votre zone DNS reste chez vous.
Questions fréquentes
Faut-il changer les serveurs de noms de mon domaine ? Non. Votre DNS reste chez votre registrar ou votre hébergeur DNS, seuls les enregistrements ci-dessus s'ajoutent.
Mes e-mails sont-ils touchés ? Non, tant que vous ne modifiez pas les enregistrements MX de votre domaine.
Puis-je changer le sous-domaine offert ensuite ? Oui, dans Réglages, et vos noms personnels sont conservés. Si votre CNAME vise l'ancien sous-domaine, mettez-le à jour vers le nouveau.
Puis-je utiliser un joker comme *.exemple.fr ? Non. Indiquez chaque nom précisément.
Puis-je utiliser un nom accentué ? Oui, sous sa forme xn--, que votre registrar vous indique.
Une question ou un blocage ? Ouvrez un ticket en indiquant le nom concerné et le message affiché.