Passer au contenu principal

Dépannage de la configuration du domain personnalisé et HTTPS/SSL

Vous rencontrez des problèmes pour configurer votre domain personnalisé dans le Help Center ? Cet article présente plusieurs étapes de dépannage à essayer.

Écrit par Ivan Branimir Skoric

Configurer HTTPS (configuration manuelle) ou HTTP

Pour activer HTTPS ou HTTP pour votre domain personnalisé :

  • Accédez à Settings > Help Center > Configure & Style

  • Dans la section « Domain », localisez le paramètre « Security protocol »

  • Réglez le « Security protocol » sur HTTPS (configuration manuelle) ou HTTP

  • Enregistrez vos modifications

Vérifiez que vous avez configuré le CNAME correctement

Si vous utilisez HTTPS (configuration manuelle) ou HTTP, vérifiez que l’enregistrement CNAME est configuré sur :

  • Si votre espace de travail est hébergé aux États-Unis - custom.intercom.help

  • Si votre espace de travail est hébergé en Europe - custom.eu.intercom.help

  • Si votre espace de travail est hébergé en Australie : custom.au.intercom.help

Si vous utilisez HTTPS (configuration rapide), vérifiez que l’enregistrement CNAME est configuré sur :

  • Si votre espace de travail est hébergé aux États-Unis - us.intercomhelpcenter.com

  • Si votre espace de travail est hébergé en Europe - eu.intercomhelpcenter.com

  • Si votre espace de travail est hébergé en Australie : au.intercomhelpcenter.com

HTTPS (configuration rapide) pourrait ne pas être disponible pour votre espace de travail.

Pour vérifier dans quelle région votre espace de travail est hébergé, regardez la barre d’URL de votre navigateur lorsque vous utilisez Intercom.

Si l’URL commence par :

  • app.intercom.com, votre espace de travail est hébergé aux États-Unis

  • app.eu.intercom.com, votre espace de travail est hébergé en Europe

  • app.au.intercom.com, votre espace de travail est hébergé en Australie

Vérifiez que les modifications du CNAME ont été propagées

Les modifications du CNAME prennent du temps à se propager. Cela peut prendre jusqu’à 72 heures selon votre fournisseur.

Vous pouvez vérifier si la modification du CNAME a été propagée en utilisant un outil comme MXToolbox.

Un autre outil utile pour vérifier la propagation DNS est whatsmydns.net, qui peut confirmer que vos modifications DNS ont été propagées globalement.

Assurez-vous d’utiliser la recherche CNAME dans MXToolbox

Si vous utilisez HTTPS (configuration manuelle) - dans ce cas, une vérification CNAME ne renverra généralement aucune donnée car il n’est pas nécessaire que le DNS soit lié à un domain Intercom. La configuration se fait dans le service que vous avez mis en place pour implémenter HTTPS.

Vérifiez vos paramètres Cloudflare

Si vous utilisez Cloudflare, assurez-vous que le nuage à côté de votre enregistrement CNAME est orange et que vous avez réglé SSL dans la section « Crypto » sur « Flexible » ou « Full ».

Ne choisissez pas « Full (Strict) » car cela entraînera un certificat SSL invalide.

Assurez-vous que votre Help Center est en ligne

Allez dans Settings > Help Center et assurez-vous que votre Help Center est Live.

Résolution des erreurs SSL dans votre Help Center Intercom

Lorsque vous rencontrez des erreurs SSL comme ERR_SSL_VERSION_OR_CIPHER_MISMATCH ou SSL_ERROR_NO_CYPHER_OVERLAP dans votre Help Center Intercom, cela indique un problème de connexion sécurisée entre votre navigateur et le serveur. Ce guide vous aidera à comprendre et résoudre ces problèmes courants.

Comprendre ERR_SSL_VERSION_OR_CIPHER_MISMATCH

Cette erreur se produit lorsque votre navigateur ne peut pas établir une connexion sécurisée avec le serveur à cause de problèmes de configuration SSL (Secure Sockets Layer).

Causes courantes

Paramètres DNS mal configurés ou délais de propagation : Les enregistrements DNS (Domain Name System) peuvent être mal configurés ou ne pas être complètement propagés sur Internet.

Exemple : Un enregistrement CNAME (Canonical Name) pointant vers us.intercomhelpcenter.com d’Intercom pourrait ne pas encore avoir été propagé.

Conseil : Attendez jusqu’à 24 heures pour que les modifications DNS prennent effet. La propagation DNS peut prendre du temps selon votre fournisseur de domain et votre fournisseur d’accès Internet.

Certificats SSL conflictuels ou en double : Si vous utilisez HTTPS avec un domain personnalisé (configuration rapide), Intercom fournit le certificat SSL. Tout certificat supplémentaire ou en conflit configuré chez votre fournisseur de domain provoquera des erreurs et doit être supprimé.

Astuce pro : Assurez-vous que seul le certificat SSL fourni par Intercom est actif pour votre domain personnalisé afin d’éviter les conflits.

Comprendre SSL_ERROR_NO_CYPHER_OVERLAP

Ce problème survient lors de la négociation SSL/TLS (Transport Layer Security) quand le serveur et le client ne peuvent pas s’accorder sur les protocoles de chiffrement ou suites de chiffrement supportés.

Résolution des problèmes de chevauchement de chiffrement

Assurez-vous d’utiliser des standards de chiffrement à jour : Votre navigateur et le serveur doivent supporter des standards de chiffrement modernes.

Note : Les navigateurs ou systèmes d’exploitation anciens peuvent ne pas supporter les protocoles de chiffrement récents, ce qui cause cette erreur.

Conseil : Mettez à jour votre navigateur web vers la dernière version pour garantir la prise en charge des standards de chiffrement actuels.


Résolution des erreurs de poignée de main SSL pour le link branding

Intercom ne configure pas SSL pour le link branding sur les custom domains. Vous êtes responsable de la configuration et de la gestion des certificats SSL auprès de votre fournisseur de domain pour le link branding.

Résolution des problèmes SSL de Link Branding

Visitez les paramètres SSL de votre domain provider : Pour résoudre les problèmes de poignée de main SSL pour le link branding, vous devez configurer le certificat SSL directement avec votre domain provider.

Note : Ceci est distinct du certificat SSL qu’Intercom fournit pour le domaine principal de votre Help Center.

Important : Consultez la documentation ou le support de votre domain provider pour des instructions spécifiques sur la configuration et le dépannage des certificats SSL.

Si votre certificat SSL est géré par un fournisseur tiers, assurez-vous qu’il est toujours valide.

Assurez-vous d’avoir au moins un article publié

Si vous voyez Not found en essayant de visiter votre Help Center, assurez-vous d’avoir au moins un article publié. S’il n’y a aucun article publié, votre Help Center sera inactif et retournera Not found.

Erreur 1014 - CNAME Cross-User Banned

Si vous rencontrez une erreur 1014 en visitant votre custom Help Center domain, cela est probablement dû à un problème Cloudflare Cross User CNAME. Pour résoudre cette erreur :

  • Paramètres DNS Cloudflare : Assurez-vous que l’enregistrement CNAME est en mode DNS-only (icône nuage grise) dans Cloudflare, pas en mode proxifié. Le mode proxifié (icône nuage orange) peut provoquer l’erreur 1014.

  • Enregistrement CNAME : Créez un enregistrement CNAME et assurez-vous que votre custom domain pointe vers custom.intercom.help ou us.intercomhelpcenter.com (selon votre méthode de configuration HTTPS)

  • Laissez jusqu’à 48 heures pour la propagation DNS. Si le problème persiste, une investigation plus approfondie des paramètres serveur peut être nécessaire.

Notes :

  • Le proxy Cloudflare activé provoque un échec de la poignée de main SSL pour le link branding car Intercom ne présente que des certificats *.intercom-mail.com.

  • La correction nécessite une règle d’origine Cloudflare (réservée aux comptes Enterprise).

  • Les clients non-Enterprise doivent utiliser le mode DNS-only.

Une cause fréquente mais facile à manquer de l’erreur 1014 est de ne pas sélectionner le protocole de sécurité correct dans les paramètres de votre Intercom Help Center après avoir créé l’enregistrement CNAME. Même si votre DNS est correctement configuré, le custom domain ne sera pas validé tant que cette étape n’est pas complétée. Pour résoudre ce problème, allez dans Paramètres > Help Center > Configurer & Style, ouvrez la section Domain, et sélectionnez l’option correspondant à votre configuration DNS : HTTPS (Configuration rapide) si votre CNAME pointe vers us.intercomhelpcenter.com, ou HTTPS (Configuration manuelle) si votre CNAME pointe vers custom.intercom.help. N’oubliez pas d’enregistrer vos modifications après sélection.

Important : Si vous avez un compte Cloudflare Enterprise ou supérieur, assurez-vous que Zone Hold est désactivé pour votre domain. Zone Hold valide que les noms d’hôtes résolvent vers des adresses IP associées au même compte Cloudflare, ce qui empêchera la Configuration rapide HTTPS de fonctionner et retournera une erreur 1014 Cross-User Banned. Pour le désactiver, allez dans les paramètres de votre compte Cloudflare et désactivez Zone Hold pour le domain concerné.

Erreur « Access Denied » lors de la configuration HTTPS

Si vous rencontrez une erreur « Access Denied » lors de la configuration HTTPS :

  • Vérifiez que votre enregistrement CNAME pointe vers le bon domain régional

  • Si vous utilisez Cloudflare, assurez-vous que le mode SSL est réglé sur « Flexible » ou « Full » (pas « Full (Strict) »)

  • Redémarrer la configuration SSL en désactivant la configuration HTTPS, en attendant quelques minutes, puis en la réactivant est une étape de dépannage recommandée.

Utilisez-vous Amazon CloudFront ?

Assurez-vous de suivre toutes les étapes du guide.

Utilisez-vous un Custom Reverse Proxy ?

  • Assurez-vous que les guides sont suivis.

  • Exemple de recherche CNAME pour une configuration de reverse proxy : ne trouvera rien mais indiquera quel serveur DNS vous utilisez.


Rencontrez-vous une erreur 502 en accédant à custom.domain/robots.txt ?

Si vous utilisez nginx (ou ingress nginx), vérifiez vos journaux pour :

“upstream sent too big header while reading response header from upstream”
​
Si vous trouvez ce message dans vos journaux, vous devez augmenter, dans l’annotation de votre ingress (la valeur par défaut est 4k) :

nginx.ingress.kubernetes.io/proxy-buffer-size: "8k"


Cela résoudra le problème de l’erreur 502 lors de l’accès à custom.domain/robots.txt

Que faire si le statut de configuration HTTPS reste « Pending » pendant une longue période ?

Si le statut de configuration HTTPS reste « Pending » pendant une longue période, suivez ces étapes :

  • Vérifiez votre configuration DNS pour les problèmes courants :
    • Assurez-vous que l’enregistrement CNAME est correctement formaté et ne contient pas de parties de domain supplémentaires (par exemple, ne pas ajouter votre propre domain à l’hôte Intercom).
    • Assurez-vous d’utiliser un enregistrement CNAME, pas un enregistrement A.
    • Le CNAME doit pointer vers le bon domain régional Intercom (par exemple, us.intercomhelpcenter.com pour les espaces de travail US).

  • Après corrections, laissez le temps à la propagation DNS, qui peut prendre de 1 à 72 heures selon votre fournisseur.

  • Une fois le DNS correctement configuré et propagé, retournez dans les paramètres de votre Help Center et essayez de réactiver HTTPS (configuration rapide).

  • Si le statut reste « Pending » après ces étapes et un délai suffisant, revérifiez votre configuration DNS pour détecter d’éventuelles erreurs.

Comment assurer la sécurité et la stabilité à long terme ?

Une fois la configuration rapide HTTPS activée et fonctionnelle, les problèmes récurrents sont peu probables sauf modification ou mauvaise configuration. Intercom fournit la certification SSL dans le cadre de cette configuration pour garantir la fiabilité.

Les liens vers les articles et pages de collection redirigeront-ils automatiquement vers mon custom domain ?

Après avoir configuré votre custom domain, les liens d’articles redirigeront automatiquement, mais les liens des pages de collection peuvent encore s’ouvrir sous le domain Intercom par défaut s’ils sont accédés directement. Pour les entreprises qui privilégient le SEO, assurez-vous que les collections sont correctement mises à jour pour fonctionner avec le custom domain.

Scénarios après réactivation ou suspension de paiement

Si le problème survient après la réactivation de votre Help Center ou la résolution des suspensions de paiement :

  • Vérifiez les paramètres de votre custom domain dans Intercom et assurez-vous que tous les champs sont correctement mis à jour.

  • Supprimez le custom domain pendant le dépannage si nécessaire et revenez temporairement au domain Intercom par défaut.


Vous rencontrez toujours des problèmes ?

Si tout ce qui précède semble en ordre et que vous rencontrez toujours des problèmes, contactez notre équipe Support via Messenger, ils se feront un plaisir d'examiner cela plus en détail pour vous !

Avez-vous trouvé la réponse à votre question ?