Clause de non-responsabilité: Cet article a été généré par traduction automatique.

Mappage personnalisé de domaine

Prev Next

Plans prenant en charge cette fonctionnalité : Professional Business Enterprise

Domaine par défaut

Lorsque vous créez un nouveau projet dans Document360, il attribue automatiquement un nom de domaine par défaut dans ce format : project-name.document360.com.

Par exemple, si vous nommez votre projet Project Greenfield, le domaine attribué sera project-greenfield.document360.com.


Modifier un domaine par défaut

Vous pouvez créer une adresse web plus personnalisée qui reflète votre marque et vos préférences en modifiant l'adresse web par défaut ou en créant un domaine personnalisé, comme help.yourcompany.com, ce qui facilite la recherche et la mémoire de votre site par les utilisateurs.

Pour modifier l'adresse web par défaut,

  1. Naviguez vers () > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.

  2. Dans le panneau de navigation de gauche, naviguez vers Custom domain.

    Custom domain mapping setup instructions with highlighted domain configuration details.

  3. Cliquez sur l' icône Modifier () dans le champ de domaine fourni par Document360 .

    image.png

  4. Saisissez votre domaine préféré dans le domaine.

    • Si votre domaine préféré n'est pas disponible, le bouton Mettre à jour sera inactif. Vous devrez essayer un autre domaine.

    • Si le domaine est déjà utilisé, le bouton Mettre à jour restera inactif.

    • Si votre domaine préféré est disponible, le bouton Mettre à jour sera activé.

  5. Cliquez sur Mettre à jour pour mettre à jour l'adresse web de votre site de base de connaissances.


Création d'un domaine personnalisé

Vous pouvez configurer un domaine personnalisé sous la marque, comme help.yourcompany.com pour votre site de base de connaissances, en suivant les étapes suivantes :

  1. Ajouter le domaine personnalisé dans Document360

  2. Configurez un enregistrement CNAME avec votre registraire de domaine

  3. Vérifiez le domaine dans Document360

Ajout d'un domaine personnalisé dans Document360

  1. Naviguez vers () > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.

  2. Dans le panneau de navigation de gauche, naviguez vers Custom domain > Mappage de domaine personnalisé.

  3. Entrez le domaine personnalisé dans le champ de configuration du domaine .

  4. Cliquez sur Ajouter un domaine.

    image.png

  5. Une fois la configuration terminée du domaine personnalisé et la configuration terminée, les enregistrements du domaine personnalisé seront générés et vous serez notifié via le portail de la base de connaissances.

Configuration de l'enregistrement CNAME dans votre registraire de domaine

Une fois le domaine ajouté dans Document360, vous devrez configurer un enregistrement CNAME dans votre registraire de domaine pour lier votre domaine personnalisé aux serveurs de Document360.

Pour configurer l'enregistrement CNAME,

  1. Connectez-vous au registraire de domaine où vous avez acheté votre domaine (par exemple, GoDaddy, Namecheap, Google Domains).

  2. Dans le panneau de gestion de domaine, allez dans les paramètres DNS.

  3. Ajoutez un nouveau CNAME dans les paramètres DNS.

    1. Saisissez votre domaine personnalisé préféré dans le champ Nom/Hôte (par exemple, help.yourcompany.com).

    2. Entrez le CNAME fourni par Document360 dans le champ Points à/Value.

  4. Saisissez les détails de tout autre champ pertinent et enregistrez le nouveau CNAME.

Exemple pour configurer un enregistrement CNAME

Ceci estun exemple pour démontrer la correspondance CNAME pour les domaines enregistrés chez Hostinger.
11_Screenshot-Nameservers_example

  1. Allez sur la page de gestion de domaine de Hostinger.

  2. Ouvrez la section Domaines et sélectionnez votre domaine.

  3. Cliquez sur DNS/Serveurs de noms à gauche et sélectionnez l'onglet des enregistrements DNS .

  4. Choisissez le type d'enregistrement dans la liste déroulante (CNAME).

  5. Collez la valeur copiée de Document360 dans le champ Points vers .

  6. Ajoutez lavaleur TTL (Time-To-Live) et cliquez sur le bouton Ajouter un enregistrement .

12_Screenshot-DNS_record_mapping_in_hostinger

Registraires de domaine commun

Voici une liste de certains registraires de domaines courants :


Vérification du domaine personnalisé dans Document360

Après avoir configuré le CNAME, suivez les étapes ci-dessous pour compléter la configuration personnalisée de la mappage de domaine.

  1. Retournez dans les paramètres de domaine personnalisé de Document360.

  2. Sélectionnez la case à cocher qui dit « J'ai ajouté les enregistrements ».

  3. Cliquez sur le bouton Vérifier , et le processus de vérification est lancé.

  4. Si la vérification réussit, vous recevrez un message de réussite grillée.

NOTE

S'il y a un problème lors de la configuration du domaine personnalisé, consultez les étapes de dépannage dans la section ci-dessous de cet article.

Après avoir cartographié le domaine personnalisé, cliquez sur l'icône Aller dans votre site de base de connaissances pour voir le changement de l'URL du site.


Problèmes de cartographie après les débuts

Message « Site trompeur à avance » lors de l'accès au site après une cartographie personnalisée de domaine réussie.

13_Screenshot-Deceptive_site_ahead_warning

Cela signifie que Google a signalé le domaine personnalisé que vous avez cartographié comme dangereux pour la navigation.

  • Pour vérifier le statut signalé, utilisez le statut du site Navigation Sécurisée de Google.

  • Tapez votre domaine mappé et vérifiez s'il y a des problèmes.

  • Résoudre et corriger les problèmes détectés (attaques de phishing, infestation de malwares, violation des règles de la communauté, etc.).

  • Soumettez une demande d'avis depuis Google Search Console. Google mettra à jour le statut et supprimera l'avertissement de votre site web.

Voici un article d'aide du support Google.

8_Screenshot-Troubleshooting_site_status


Équilibreur de charge

Un équilibreur de charge rédistribue le trafic entrant de manière égale sur plusieurs serveurs, garantissant que votre site de base de connaissances reste rapide et fiable, même lors des périodes de forte fréquentation. Cela aide à éviter qu'un serveur ne soit surchargé et améliore la performance globale ainsi que la sécurité de votre site.

La mise à niveau de l'équilibreur de charge peut apporter des avantages supplémentaires, tels que des fonctionnalités de sécurité améliorées et une meilleure gestion du trafic.

Mise à niveau de l'équilibreur de charge

  1. Naviguez vers () > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.

  2. Dans le panneau de navigation de gauche, naviguez vers Custom domain > Mappage de domaine personnalisé.

  3. Cliquez sur Upgrade.

  4. Vérifiez la configuration personnalisée de la mappage de domaine dans Document360.

  5. Copiez l'enregistrement CNAME généré dans Document360.

  6. Configurez l'enregistrement CNAME dans votre registraire de domaine.

  7. Vérifiez la configuration personnalisée de la mappage de domaine dans Document360.

NOTE

  • Cette mise à niveau ne provoque aucun temps d'arrêt. Cependant, nous recommandons cette mise à niveau pendant vos heures hors bureau

  • Cette mise à niveau est entièrement gratuite

Veuillez contacter notre équipe de support pour obtenir de l'aide.


Configuration d'un domaine personnalisé pour les domaines Apex

Lors de la configuration d'un domaine personnalisé pour Document360, vous pouvez vouloir utiliser votre domaine Apex (domaine root), comme abc.com sans sous-domaine comme www. Bien que la configuration des sous-domaines soit simple, la configuration des domaines Apex nécessite quelques étapes supplémentaires, notamment concernant les enregistrements DNS.

L'aplatissement DNS est une méthode qui permet d'utiliser un enregistrement CNAME au niveau du domaine Apex (racine), ce que tous les registraires de domaine ne supportent pas. Si votre registraire ne supporte pas l'aplatissement DNS, vous ne pourrez pas ajouter d'enregistrement CNAME pour votre domaine Apex.

Configuration des domaines Apex

Si votre registraire de domaine ne prend pas en charge le flattening DNS (par exemple, GoDaddy), vous pouvez opter pour un fournisseur DNS qui le fait, comme Cloudflare. Cloudflare propose des forfaits gratuits incluant l'aplatissement DNS, vous permettant de configurer avec succès votre domaine personnalisé pour le domaine Apex.

Par exemple, supposons que vous utilisiez GoDaddy, qui ne prend pas en charge l'aplatissement DNS. Dans ce cas, passer à un fournisseur DNS comme Cloudflare vous permettra d'ajouter un enregistrement CNAME pour votre domaine Apex.

NOTE

Pour plus d'informations, lisez l'article sur le planisseur CNAME de Cloudflare.

Utilisation d'un certificat SSL personnalisé

Utilisez le certificat SSL fourni par Document360 pour votre domaine afin d'assurer des connexions sécurisées, car il offre un renouvellement automatique et fluide pour une expérience fluide. Fournissez les informations suivantes pour traiter votre demande d'installation d'un certificat SSL personnalisé :

  • Nom commun (CN) : Le nom de domaine entièrement qualifié pour le certificat.

  • Organisation (O) : Le nom légal de votre organisation.

  • Unité organisationnelle (OU) : Le département ou la division au sein de votre organisation.

NOTE

Le certificat est généralement valable pendant 90 jours. Vous devrez renouveler le certificat à temps et nous fournir le certificat mis à jour afin que nous puissions l'installer sur votre domaine.


Dépannage

Échec de la vérification du domaine

Si vous rencontrez des difficultés à vérifier votre domaine personnalisé, assurez-vous que le CNAME correspond à l'hébergeur du domaine.

7_Screenshot-Troubleshooting_invalid_record

Il est possible qu'un autre enregistrement soit mappé à la place de CNAME (comme les enregistrements AAAA). Cela provoquerait aussi une erreur.

Suggestion : Pour consulter le CNAME de votre domaine et d'autres informations DNS, utilisez Digwebinterface ou la recherche DNS de Google, ou tout autre outil de recherche DNS disponible sur le web
9_Screenshot-Troubleshooting_digwebinterface

NOTE

Pour des raisons de sécurité, certains registraires de domaines peuvent masquer ou restreindre la découverte des enregistrements DNS dans les outils de recherche DNS. Un exemple est Cloudflare.
Dans de tels cas, vous pouvez contacter votre registraire de domaine pour plus d'informations.

Une fois le CNAME correct cartographié, il peut falloir jusqu'à 24 heures pour que la cartographie soit réussie.


Délai d'attente après la mise à jour des enregistrements DNS

Si la correspondance CNAME et le problème de vérification du domaine persistent, le TTL (Time-To-Live) peut être une raison possible.

Si vous mettez à jour une valeur d'enregistrement DNS existante, il peut falloir du temps pour que le TTL configuré se reflète globalement. Si le TTL est réglé à 3600 pour un enregistrement DNS, il peut falloir jusqu'à 1 heure (3600 secondes) pour refléter la valeur de l'enregistrement DNS du DNS Name server DNS à l'échelle mondiale.


Restriction CAA définie par le registraire de domaine

Certains registraires de domaine imposent une restriction selon laquelle le certificat SSL doit être provisionné par une autorité de certification spécifique (CA).

Par exemple, si un enregistrement CAA a une valeur de 0 « letsencrypt.org », alors seul le Let's Encrypt (CA) pourra générer un certificat pour le domaine personnalisé particulier. D'autres autorités de certification (DigiCert, dans notre cas) verraient cette configuration et refuseraient de générer un certificat SSL.

Vérifiez si vous avez des enregistrements CAA configurés dans la configuration DNS pour le domaine personnalisé.


Résolution de l'erreur « Ce site est inaccessible » lors de la configuration d'un domaine personnalisé

Erreur : Ce site est injoignable

Cette erreur survient généralement lorsque l' enregistrement CNAME n'est pas ajouté rapidement dans votre DNS après sa génération dans Document360. En cas de retard, le CNAME peut expirer, ce qui entraîne un échec de la vérification du domaine.

D'autres causes possibles incluent :

  • Délais de propagation DNS

  • Duplique les entrées CNAME dans votre DNS

  • Enregistrements CAA manquants pour des fournisseurs SSL pris en charge comme Let's Encrypt, DigiCert ou Google

Error message indicating the site cannot be reached with troubleshooting suggestions.

Étapes à résoudre :

  1. Vérifiez quand le CNAME a été configuré

    • Confirmez si l'enregistrement CNAME a été ajouté à votre DNS immédiatement après sa création dans Document360.

    • Sinon, le CNAME pourrait avoir expiré.

  2. Supprimer et reconfigurer le domaine personnalisé

    • Allez chez votre fournisseur DNS et supprimez l'enregistrement CNAME existant.

    • Ensuite, dans Document360, supprimez l'entrée de domaine personnalisée existante.

    • Attendez 15 minutes avant de continuer.

  3. Ajouter à nouveau l'enregistrement CNAME

    • Naviguez vers () > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.

    • Dans le panneau de navigation de gauche, naviguez dans Custom domain > Mappage de domaine personnalisé, puis créez à nouveau le domaine personnalisé.

    • Copiez immédiatement l'enregistrement CNAME et ajoutez-le à votre fournisseur DNS avec un TTL (Temps de Vie) de 5 minutes.

    • Retournez à Document360 et cliquez sur Vérifier.

    • Attendez quelques minutes que la configuration soit terminée.

  4. Vérifier la propagation DNS

    • Les modifications DNS prennent généralement 2 à 4 heures, mais dans certains cas jusqu'à 24 heures.

    • Attendez la propagation complète avant de vérifier à nouveau le domaine.

  5. Vérifier le DNS avec l'outil Google Dig

    • Utilisez l'outil Google Dig pour vérifier si vos enregistrements DNS sont corrects.

    • Cherchez des entrées CNAME en double pour le même nom d'hôte. Si vous trouvez des doublons, supprimez les doublons.

  6. Vérifiez les conflits de dossiers de la CAA

    • Utilisez dnschecker.org pour consulter les enregistrements CAA de votre domaine.

    • Si des enregistrements CAA sont configurés, assurez-vous qu'ils permettent aux fournisseurs SSL de Document360 :

Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360


Résoudre des erreurs telles que « Votre connexion n'est pas privée » ou « Votre connexion n'est pas sécurisée » lors de l'accès au site de la base de connaissances

Cette erreur survient généralement pour les raisons suivantes :

  1. Problème : Certificat SSL expiré

  1. Vérifiez si le certificat SSL a expiré.

  2. Visitez le site de la base de connaissances et cliquez sur l'option Voir les informations du site dans la barre d'URL.

  3. Cliquez sur Connexion est sécurisée pour consulter les détails du certificat SSL.

B. Si le certificat SSL n'a pas expiré, essayez alors les étapes de dépannage ci-dessous :

  1. Essayez d'accéder au site depuis un autre navigateur pour écarter des problèmes spécifiques à chaque navigateur.

  2. Désactivez toutes les extensions de site web dans votre navigateur et vérifiez à nouveau.

  3. Vérifiez si tous les utilisateurs rencontrent le même problème afin d'identifier s'il est spécifique à l'utilisateur ou à l'échelle du système.

  4. Vivez le cache de votre navigateur ou changez de navigateur, car cela résout souvent le problème.

C. VPN connection

  1. Désactivez votre VPN et essayez d'accéder à nouveau au site :

  2. Si désactiver le VPN résout le problème, c'est peut-être le VPN qui cause le problème.

  3. Contactez votre équipe informatique pour obtenir de l'aide supplémentaire.

D. Problème d'enregistrements DNS

Il peut y avoir des problèmes avec le résolveur DNS si les enregistrements DNS n'ont pas été mis à jour avec succès.

  1. Utilisez un vérificateur DNS (par exemple, DNS Checker) pour vérifier les enregistrements DNS.

  2. Vérifiez si tous les dossiers ont été mis à jour correctement.

  3. Si les enregistrements ne sont pas correctement synchronisés, contactez votre fournisseur DNS ou votre registraire de domaine pour vous assurer que la zone DNS est correctement configurée et synchronisée pour le domaine.

Si le problème persiste après avoir suivi ces étapes, veuillez contacter l’équipe d’assistance Document360 pour obtenir de l’aide supplémentaire : Contacter l’assistance Document360


Résoudre l'erreur « Connexion sécurisée échouée - SSL_ERROR_NO_CYPHER_OVERLAP » lors de la configuration d'un domaine personnalisé

Erreur : Connexion sécurisée échouée - SSL_ERROR_NO_CYPHER_OVERLAP

Cette erreur indique généralement que le certificat SSL n'a pas pu être émis en raison d'un décalage dans la configuration CNAME. Si le domaine personnalisé ne pointe pas vers le domaine Document360 correct, la validation SSL échoue, entraînant l'erreur.

Étapes à résoudre :

  1. Va à dnschecker.org.

  2. Dans la barre de recherche, saisissez votre domaine personnalisé et sélectionnez CNAME dans le menu déroulant.

  3. Vérifiez le résultat :
    La valeur CNAME doit correspondre exactement à celle fournie dans le portail Document360 lors de la configuration du domaine.

  4. Si le CNAME est incorrect :

    • Supprimez le domaine personnalisé actuel de votre projet Document360.

    • Corrigez l'enregistrement CNAME dans votre fournisseur DNS en ajoutant celui fourni dans Document360.

    • Attends quelques minutes, puis reconfigure le domaine personnalisé dans Document360 et vérifie à nouveau.

Une fois le CNAME correct en place et vérifié, le certificat SSL sera délivré avec succès, résolvant ainsi l' erreur.

DNS check results showing Google and other service locations with IP addresses.


FAQ

Ai-je besoin d'un certificat SSL pour configurer un domaine personnalisé ?

Document360 fournit automatiquement un certificat SSL pour votre domaine personnalisé lorsque vous le mappez à votre projet. Vous n'avez pas besoin d'acheter un certificat SSL supplémentaire. Cependant, si vous préférez utiliser votre propre certificat SSL plutôt que celui fourni par Document360, veuillez contacter notre équipe de support à support@document360.com.

L'URL personnalisée du domaine sera-t-elle reflétée dans l'e-mail d'invitation envoyé aux lecteurs ?

Oui, si l'e-mail d'invitation est envoyé aux lecteurs après que le domaine personnalisé ait été mappé avec succès, les liens vers l'email pointeront vers le domaine personnalisé.

Que dois-je faire si le CNAME n'est pas vérifié après la mise à jour du DNS ?

Si le CNAME n'est pas vérifié après la mise à jour du DNS, vous devrez reconfigurer votre domaine personnalisé.

  • Supprimez la configuration actuelle du domaine personnalisé.

  • Réajoutez le domaine personnalisé et mettez à jour le CNAME sur votre DNS.

  • Assurez-vous que le CNAME est vérifié pour finaliser la configuration.

Puis-je configurer deux domaines personnalisés pour un seul site de base de connaissances ?

Non, il n'est pas possible de configurer deux domaines personnalisés pour un seul site de base de données. Cependant, vous pouvez configurer une redirection d'un domaine vers l'autre. Ainsi, les visiteurs du premier domaine seront redirigés vers le second domaine.

Puis-je configurer plusieurs domaines pour un seul projet dans Document360 ?

Actuellement, Document360 ne prend en charge qu'un seul domaine personnalisé par projet.

Qu'est-ce qu'un Naked Domain ?

Un domaine nu est un domaine qui n'inclut pas le préfixe « www ». Par exemple, si le domaine est example.com, c'est un domaine nu, tandis que www.example.com n'est pas.

Par défaut, la plupart des domaines auront le sous-domaine « www », mais un domaine nu comme yourcompany.com n'inclut pas ce sous-domaine.

Qu'est-ce qu'un registraire de domaine ?

Un registraire de domaines est une entreprise où vous achetez et gérez le nom de domaine de votre site web (par exemple, GoDaddy, Namecheap ou Google Domains). C'est là que vous mettrez à jour les paramètres de votre domaine personnalisé pour le connecter à Document360.

Qu'est-ce qu'un enregistrement CNAME ?

Un enregistrement CNAME (Nom Canonique) est un type de paramètre DNS (DNS, ou Domain Name System, est comme le carnet d'adresses d'Internet, dirigeant les utilisateurs vers le bon serveur web). Le CNAME connecte votre domaine personnalisé (par exemple, help.yourcompany.com) à une autre adresse, comme le domaine par défaut fourni par Document360. Cela garantit que lorsqu'une personne tape votre domaine personnalisé, elle est dirigée vers votre site de base de connaissances.

Pourquoi dois-je passer au nouvel équilibreur de charge ?

  • Il met en œuvre le déchargement SSL, réduisant la charge sur les serveurs et améliorant la sécurité en gérant le chiffrement/déchiffrement SSL au niveau de l'équilibreur de charge.

  • Il inclut un pare-feu d'applications web (WAF) pour se protéger contre les attaques web courantes telles que l'injection SQL et le scripting inter-sites.

  • Il utilise des algorithmes de gestion dynamique du trafic pour une distribution optimale du trafic et une amélioration des performances.

Nous recommandons vivement de passer à cette solution avancée pour une meilleure sécurité et fiabilité.

Est-il possible de créer un domaine séparé pour chaque version de mon projet ?

Non, il n'est actuellement pas possible d'attribuer des domaines séparés à des versions individuelles. Lorsque vous créez une nouvelle version, vous ne pouvez personnaliser le chemin que dans le domaine existant.

Changer le domaine personnalisé affectera-t-il le widget ou les liens d'articles existants ?

Non, changer le domaine de votre base de connaissances n'affectera pas la fonctionnalité du widget.

  • Le widget fonctionne à l'aide d'un jeton API, il continue donc de fonctionner même après un changement de domaine.

  • Les liens d'articles dans Document360 sont généralement relatifs (par exemple, /docs/article-name), donc ils ne casseront pas après la mise à jour du domaine.

  • Cependant, si vous avez utilisé des URL complètes (par exemple, https://yourproject.document360.io/docs/article-name), vous devriez les consulter et les mettre à jour manuellement.

  • Comme bonne pratique, utilisez des liens relatifs autant que possible pour éviter les problèmes lors de la mise à jour du domaine.

Pourquoi est-ce que je reçois l'erreur Cloudflare 1014 – CNAME Cross-User Banned lors de la configuration de mon domaine personnalisé ?

Cela se produit lorsque Document360 et votre domaine sont hébergés sur Cloudflare. Cloudflare empêche les enregistrements CNAME sur différents comptes Cloudflare.

Pour résoudre cela :

  1. Si vous êtes sur un compte Cloudflare payant, vérifiez si « Empêcher aussi les sous-domaines » (blocage de zone) est activé. Décochez-le temporairement, attendez que le domaine vérifie, puis réactivez-le.

  2. Si vous êtes sur un compte Cloudflare gratuit, la zone de blocage est désactivée par défaut. Dans ce cas:

    • Assurez-vous que les enregistrements CNAME sont ajoutés et propagés rapidement (dans les 7 jours suivant la génération des enregistrements dans Document360).

    • Si la vérification échoue, retirez le domaine personnalisé de Document360 et relancez la configuration.

    • Si les problèmes persistent, contactez le support Cloudflare, car cela peut être lié à la facturation (par exemple, carte expirée).

L'ajout d'un domaine personnalisé modifie-t-il mon lien vers le portail Document360 ?

Non. L' URL du portail (par exemple, https://portal.us.aaa.document360.io/dashboard) reste la même. Le domaine personnalisé s'applique uniquement au site de la base de connaissances, pas au portail administratif.