Dépannage DNS de White Label Lite

La plupart des problèmes DNS de White Label Lite ont l’une des quatre causes suivantes : l’enregistrement est absent, sa valeur diffère de celle de la table Branding, un proxy est activé ou l’étape du certificat nécessite une intervention.

Commencez par la table DNS for your brand dans l’onglet Branding du domaine. Elle constitue la référence pour votre nom d’hôte et sa cible. Ne copiez pas une cible CNAME depuis un ancien article, un autre compte ou un outil de vérification DNS.

Procédure rapide

1. Ouvrez Branding et copiez l’hôte, le type et la valeur de l’adresse concernée.
2. Créez ou corrigez cet enregistrement chez le fournisseur DNS qui héberge la zone DNS active.
3. Laissez l’enregistrement en mode DNS uniquement si le fournisseur propose une option de proxy.
4. Revenez dans Branding et sélectionnez Verify DNS. Ne partagez l’adresse que lorsque son statut est Active.

Vérifier le DNS sans terminal

Avant toute autre recherche, comparez l’enregistrement chez votre fournisseur DNS à la ligne correspondante dans Branding :

• Host ou Name
• Type, qui est CNAME pour un hôte personnalisé de tableau de bord ou de webmail
• Value ou Target
• Le réglage du proxy, qui doit être désactivé pour un hôte personnalisé utilisant Cloudflare

Utilisez l’action Verify DNS dans Branding après avoir enregistré l’enregistrement. Elle place une nouvelle vérification dans la file d’attente et la page affiche le statut obtenu.

Pour effectuer une vérification indépendante, utilisez un service public de recherche DNS ou demandez à votre fournisseur DNS de rechercher le nom d’hôte complet en tant que CNAME. La réponse doit correspondre exactement au champ Value actuel de Branding. Un outil public peut confirmer ce qu’il voit, mais ne remplace pas le statut Active de la plateforme.

Vous n’avez pas besoin d’un terminal pour terminer la configuration. Si vous en utilisez un, interrogez le nom d’hôte complet et comparez le CNAME renvoyé à la valeur affichée dans Branding.

Le statut indique « Pending DNS »

Pending DNS signifie que la plateforme n’a pas encore trouvé l’enregistrement attendu pour cet hôte. Sélectionnez Verify DNS après avoir corrigé un enregistrement, puis revenez dans l’onglet Branding une fois le statut actualisé. Effectuez ces vérifications dans l’ordre :

Vous avez modifié le mauvais fournisseur DNS. Vérifiez quel fournisseur fait autorité pour le DNS de votre domaine. Il est possible de modifier le panneau d’un bureau d’enregistrement alors que la zone DNS active est hébergée ailleurs.

La cible CNAME n’est pas la cible actuelle. Copiez Value ou Target depuis la table Branding. Ne supprimez un ancien enregistrement conflictuel pour le même nom d’hôte qu’après avoir vérifié qu’un autre service ne l’utilise pas.

Le type d’enregistrement est incorrect. Un hôte de tableau de bord ou de webmail nécessite l’enregistrement CNAME affiché dans Branding. Un enregistrement A ou AAAA au même nom d’hôte peut empêcher le résultat attendu.

Le nom d’hôte est saisi sous la mauvaise forme. Certains fournisseurs attendent uniquement le préfixe, comme dashboard, tandis que d’autres demandent le nom d’hôte complet. Suivez l’indication du champ du fournisseur et comparez l’enregistrement obtenu à l’hôte affiché dans Branding.

Si l’enregistrement correspond, laissez-le en place et utilisez à nouveau Verify DNS. Modifier plusieurs fois un enregistrement correct peut prolonger le délai nécessaire pour que tous les résolveurs DNS voient la même réponse.

Le nuage orange de Cloudflare empêche le provisionnement SSL

Si vous utilisez Cloudflare comme fournisseur DNS, une icône en forme de nuage apparaît à côté de chaque enregistrement. Un nuage orange signifie que Cloudflare transmet la requête par son proxy. Le CNAME d’un tableau de bord ou d’un webmail personnalisé doit rester en mode DNS uniquement afin que la plateforme puisse le vérifier et émettre son certificat.

Correction : sélectionnez le nuage à côté du CNAME de l’hôte personnalisé concerné jusqu’à ce qu’il devienne gris, puis enregistrez. Revenez dans Branding et sélectionnez Verify DNS.

Cette règle concerne l’enregistrement de l’hôte personnalisé, et non automatiquement tous les autres enregistrements du domaine. Si un autre fournisseur propose une option de proxy ou de CDN, désactivez-la pour ce CNAME, sauf instructions différentes dans la table Branding.

Le statut indique « SSL could not be issued » et mentionne CAA

Un enregistrement CAA indique aux fournisseurs de certificats quelles organisations peuvent émettre un certificat pour votre domaine. Ne le modifiez que lorsque le statut Branding ou l’assistance désigne précisément CAA comme cause du blocage.

Ne modifiez pas le CNAME et vérifiez si le domaine possède déjà un enregistrement CAA. Votre fournisseur DNS peut l’afficher, ou un outil DNS indépendant peut interroger le domaine racine.

Si l’enregistrement doit autoriser l’émetteur de certificat de la plateforme, ajoutez la valeur CAA exacte fournie par l’assistance ou indiquée dans les consignes actuelles du produit. Ne supprimez pas des entrées CAA sans rapport dans le seul but de réussir cette étape. Plusieurs enregistrements CAA peuvent coexister.

Pour le processus de certificat actuel, la valeur requise est normalement :

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

Si vous n’avez aucun enregistrement CAA, n’en ajoutez pas un par simple précaution. Après toute modification CAA, revenez dans Branding et sélectionnez Verify DNS.

Le statut indique « SSL could not be issued » sans préciser de raison

Le CNAME est peut-être déjà correct. Ne le supprimez pas et ne le recréez pas à répétition. Procédez plutôt ainsi :

1. Vérifiez que l’enregistrement correspond toujours à l’hôte et à la cible de Branding et qu’il n’est pas transmis par un proxy.
2. Sélectionnez Verify DNS une fois.
3. Si le statut reste inchangé, contactez l’assistance en indiquant le nom d’hôte et le statut affiché et en joignant une capture d’écran de l’enregistrement DNS.

Le travail sur le certificat ne se corrige pas en modifiant un CNAME qui est déjà correct. L’équipe d’assistance peut examiner le résultat du côté de la plateforme sans vous demander de divulguer les identifiants de votre fournisseur DNS.

Le domaine était actif, mais son statut a changé

Lorsqu’un hôte est Active, il est prêt à fonctionner. Si son statut change par la suite :

• Retour à « Pending DNS » : comparez le CNAME actuel à la table Branding. L’enregistrement a peut-être été modifié, supprimé ou placé derrière un proxy.
• « SSL could not be issued » : laissez en place un CNAME correspondant, sélectionnez Verify DNS et contactez l’assistance si le statut persiste.
• Off : vérifiez si Branding a été désactivé pour ce domaine ou si l’abonnement White Label est inactif. Si aucune de ces raisons ne s’applique, contactez l’assistance.

Scénarios courants

« J’ai modifié mon CNAME, mais le statut est toujours en attente. » Vérifiez que vous avez modifié le fournisseur DNS faisant autorité et que le nouveau CNAME correspond exactement à Branding. Utilisez ensuite Verify DNS. Évitez d’alterner entre plusieurs valeurs pendant la vérification.

« J’ai supprimé l’ancien CNAME chez mon ancien fournisseur, mais le nouveau n’est pas trouvé. » Si vous avez changé de fournisseur DNS, assurez-vous que le bureau d’enregistrement délègue le domaine aux serveurs de noms du nouveau fournisseur. Sinon, demandez au fournisseur qui héberge la zone DNS faisant autorité de confirmer l’enregistrement.

« Mon site principal utilise un proxy. L’hôte personnalisé peut-il aussi l’utiliser ? » Laissez le CNAME personnalisé en mode DNS uniquement. Le reste du domaine peut utiliser ses propres réglages de proxy tant que l’hôte précis de Branding ne passe pas par un proxy.

« Puis-je utiliser un CNAME générique ? » Configurez le nom d’hôte précis affiché dans Branding. La plateforme dispose ainsi d’une adresse non ambiguë à vérifier et à tester. Ne remplacez pas l’hôte indiqué dans la table par un enregistrement générique.

« Je souhaite utiliser un autre sous-domaine. » Modifiez le libellé dans l’onglet Branding du domaine, en enregistrant un hôte à la fois. Copiez le nouveau CNAME depuis la table, ne testez le nouvel hôte qu’une fois le statut Active atteint et conservez l’ancienne adresse client jusqu’à la fin de la transition.

« Un réseau ne voit pas le nouvel enregistrement. » Testez depuis un autre réseau ou demandez au client concerné de réessayer plus tard. Si la table Branding indique Active et que l’hôte fonctionne ailleurs, le retard restant se trouve probablement dans le cache DNS de ce réseau.

Prochaines étapes

• Configurer White Label Lite : étapes de configuration initiales si vous n’avez pas terminé.
• FAQ sur les prix de White Label Lite : questions relatives à la facturation.
• Résilier White Label Lite : ce qu’il advient de votre domaine en cas de résiliation.
• Enregistrements DNS recommandés : vue d’ensemble des enregistrements DNS utilisés par TrekMail.

Si le problème persiste, ouvrez un ticket d’assistance en indiquant le nom d’hôte, le statut exact affiché dans Branding et le fournisseur DNS, et en joignant une capture d’écran de l’enregistrement. N’envoyez jamais de mot de passe ni de jeton API de votre fournisseur DNS.