La cartographie personnalisée de domaine dans Document360 vous permet de remplacer l’URL par défaut project-name.document360.com par un domaine appartenant entièrement à votre organisation, comme help.yourcompany.com. Cartographier un domaine personnalisé renforce votre identité de marque et offre aux lecteurs une expérience cohérente et personnalisée lorsqu’ils visitent votre site de base de connaissances. Document360 provisionne automatiquement un certificat SSL pour votre domaine mappé, afin que le site reste sécurisé sans configuration supplémentaire.
Quand utiliser la cartographie de domaine personnalisée
Utilisez une cartographie de domaine personnalisée lorsque vous souhaitez que votre site de base de connaissances fonctionne sous votre propre marque plutôt qu’un sous-domaine fourni par Document360.
Vous voulez que les lecteurs accèdent au contenu de support à une URL par exemple
help.yourcompany.comau lieu d’un sous-domaine Document360.Vous avez besoin d’une vérification Google Search Console pour votre site de base de connaissances, qui n’est prise en charge que sur un domaine personnalisé.
Vous voulez une adresse web plus courte et mémorable pour le marketing ou les supports de soutien.
Avant que tu commences
Un domaine fourni par Document360 et un domaine personnalisé ne peuvent pas coexister — le mappage d’un domaine personnalisé remplace le domaine par défaut.
Vous avez besoin d’accéder aux paramètres DNS de votre registraire de domaine (par exemple, GoDaddy, Namecheap ou Cloudflare) pour ajouter des enregistrements TXT et CNAME.
Document360 ne supporte actuellement qu’un seul domaine personnalisé par projet.
Comment modifier le domaine par défaut
Chaque nouveau projet Document360 se voit automatiquement attribuer un domaine par défaut dans le format project-name.document360.com. Vous pouvez personnaliser cette adresse par défaut avant ou à la place de mapper un domaine entièrement personnalisé.
Naviguez dans > > .
Cliquez sur Modifier le domaine dans le champ de domaine fourni par Document360 . La boîte de dialogue Modifier le sous-domaine apparaît.
Saisissez votre domaine préféré dans le domaine. Le bouton Mettre à jour reste inactif si le domaine n’est pas disponible ou déjà utilisé, et devient actif dès que vous entrez dans un domaine disponible.
Cliquez sur Mettre à jour pour mettre à jour l’adresse web de votre base de connaissances.
Comment cartographier un domaine personnalisé
La cartographie d’un domaine personnalisé comporte trois étapes : ajouter le domaine dans Document360, configurer les enregistrements DNS avec votre registraire, et vérifier la configuration.
Ajouter le domaine personnalisé dans Document360
Naviguez dans > > .
Cliquez sur Ajouter un domaine.
Saisissez votre nom de domaine personnalisé dans le champ Entrer votre domaine personnalisé et cliquez sur Voir la configuration.
Votre domaine personnalisé est désormais ajouté à Document360.
Configurez le DNS avec Document360
.png)
Configurez l’enregistrement TXT dans votre registre de domaine
Connectez-vous à votre registraire de domaine (par exemple, GoDaddy, Namecheap ou Google Domains).
Naviguez dans les paramètres DNS et cliquez sur Ajouter un nouvel enregistrement.
Sélectionnez TXT Record comme type d’enregistrement.
Saisissez les détails d’hébergement et de valeur/cible de Document360 dans votre registre de domaine.
Cliquez sur l’icône à cocher pour enregistrer les modifications.
Dans Document360, cliquez sur Vérifier. Le statut du dossier TXT passe de En attente à Vérifié.
NOTE
La vérification des enregistrements DNS dans Document360 peut prendre un certain temps à être effectuée.
Configurez l’enregistrement CNAME dans votre registre de domaine
Cliquez sur Ajouter un nouvel enregistrement et sélectionnez Enregistrement CNAME comme type d’enregistrement.
Saisissez les détails d’hébergement et de valeur/cible de Document360 dans votre registre de domaine.
.png)
Cliquez sur l’icône à cocher pour enregistrer les modifications. Dans Document360, le statut de l’enregistrement CNAME passe de En attente à Vérifié.
Vérifier la configuration DNS
Document360 provisionne automatiquement un certificat SSL une fois la vérification DNS terminée ; Cela peut prendre un certain temps à terminer.
Cliquez sur Vérification de la réessayage.
Une fois vérifié, un message de réussite apparaît et votre domaine personnalisé devient accessible.
.png)
Cliquez sur Aller sur le site de votre base de connaissances pour voir le changement de l’URL du site.
Votre domaine personnalisé est désormais cartographié et accessible aux lecteurs.
Comment configurer un domaine Apex
Un domaine Apex (également appelé domaine racine) est un domaine sans sous-domaine, tel que abc.com plutôt que www.abc.com. La configuration d’un domaine Apex nécessite des étapes DNS supplémentaires par rapport à un sous-domaine standard.
L’aplatissement DNS permet d’utiliser un enregistrement CNAME au niveau Apex, mais tous les registraires de domaine ne le prennent pas en charge. Si votre registraire ne prend pas en charge le flattening DNS — GoDaddy, par exemple — vous pouvez passer à un fournisseur DNS qui le fait, comme Cloudflare, qui propose le flattening DNS sur son forfait gratuit.
NOTE
Pour plus de détails, consultez la documentation de Cloudflare sur l’aplatissement CNAME.
Utilisation d’un certificat SSL personnalisé
Document360 fournit automatiquement un certificat SSL pour votre domaine, avec un renouvellement fluide. Si vous préférez installer votre propre certificat, fournissez les informations suivantes :
Terrain | Description |
|---|---|
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 de votre organisation. |
Renouvellement du certificat
Les certificats SSL personnalisés sont généralement valables pendant 90 jours. Renouvelez votre certificat à temps et fournissez le certificat mis à jour pour qu’il puisse être réinstallé sur votre domaine.
Comment améliorer l’équilibreur de charge
Un équilibreur de charge rédistribue le trafic entrant de manière égale sur plusieurs serveurs, gardant votre site de base de connaissances rapide et fiable lors des périodes de forte fréquentation et évitant qu’un serveur ne soit surchargé.
Naviguez vers > dans la barre de navigation de gauche du portail de la base de connaissances.
Naviguez dans > Mappage de domaine personnalisé.
Cliquez sur Upgrade.
Vérifiez la configuration personnalisée de la mappage de domaine dans Document360.
Copiez l’enregistrement CNAME généré dans Document360.
Configurez l’enregistrement CNAME dans votre registraire de domaine.
Vérifiez à nouveau la configuration personnalisée de la cartographie de domaine dans Document360. Le statut passe de En attente à Vérifié.
NOTE
Cette mise à niveau ne provoque pas de temps d’arrêt, bien que nous recommandions de la réaliser hors heures de travail. Contactez le support Document360 pour obtenir de l’aide.
L’équilibreur de charge est désormais mis à jour pour votre site de base de connaissances.
Limites
Limite | Valeur | Notes |
|---|---|---|
Domaines personnalisés par projet | 1 | Un second domaine n’est pas pris en charge ; Configurez plutôt une redirection d’un domaine vers l’autre. |
Domaines par version | Non supporté | Chaque version utilise un chemin personnalisable au sein du même domaine, et non un domaine séparé. |
Validité des certificats SSL personnalisés | 90 jours | Renouvelez et soumettez à nouveau le certificat avant son expiration. |
Vérification Google Search Console | Domaine personnalisé requis | La vérification n’est pas prise en charge sur un sous-domaine fourni par Document360. |
Meilleures pratiques
Utilisez des liens relatifs (par exemple,
/docs/article-name) au lieu d’URL complètes dans votre contenu, afin que les liens ne se cassent pas si vous changez de domaine plus tard.Si vous configurez un domaine Apex et que votre registraire ne supporte pas l’aplatissement DNS, passez à un fournisseur qui le fait, comme Cloudflare, plutôt que de contourner cette limitation.
Programmez les mises à jour de l’équilibreur de charge en dehors des heures de travail, même si le processus ne cause pas de temps d’arrêt, afin de minimiser tout risque lors du changement.
Renouvelez les certificats SSL personnalisés avant leur expiration de 90 jours afin d’éviter une interruption d’accès sécurisé.
Registraires de domaine commun
Registraire | Référence |
|---|---|
NameCheap | |
Domain.com | |
Google Domaines | |
Dreamhost | |
Vol stationnaire | |
GoDaddy | |
Cloudflare | |
Hôte bleu |
FAQ
Ai-je besoin d’un certificat SSL pour configurer un domaine personnalisé ?
Non. Document360 fournit automatiquement un certificat SSL lorsque vous mappez votre domaine personnalisé. Si vous préférez utiliser votre propre certificat, contactez 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. Les emails d’invitation envoyés après que le domaine personnalisé a été mappé avec succès utiliseront le domaine personnalisé dans leurs liens.
Que dois-je faire si le CNAME n’est pas vérifié après la mise à jour du DNS ?
Supprimez la configuration actuelle du domaine personnalisé, réajoutez le domaine personnalisé, mettez à jour le CNAME sur votre DNS, et confirmez qu’il est bien vérifié.
Puis-je configurer deux domaines personnalisés pour un seul site de base de connaissances ?
Non, mais vous pouvez configurer une redirection d’un domaine vers un autre afin que les visiteurs du premier domaine atterrissent sur le second.
Qu’est-ce qu’un domaine nu ?
Un domaine nu n’inclut pas le préfixe « www » — par exemple, example.com est nu, tandis que www.example.com ne l’est pas. La plupart des domaines incluent « www » par défaut.
Qu’est-ce qu’un registraire de domaine ?
Un registre de domaines est l’entreprise où vous achetez et gérez votre nom de domaine, comme GoDaddy, Namecheap ou Google Domains. Vous mettrez à jour vos paramètres de domaine personnalisés là-bas pour le connecter à Document360.
Qu’est-ce qu’un enregistrement CNAME ?
Un enregistrement CNAME est un paramètre DNS qui relie votre domaine personnalisé, comme help.yourcompany.com, à une autre adresse, comme le domaine par défaut fourni par Document360. Il garantit que les lecteurs accèdent à votre site de base de connaissances lorsqu’ils tapent votre domaine personnalisé.
Pourquoi dois-je passer au nouvel équilibreur de charge ?
Le nouvel équilibreur de charge implémente le déchargement SSL au niveau de l’équilibreur de charge pour réduire la charge des serveurs et améliorer la sécurité, inclut un pare-feu d’applications web contre les attaques courantes comme l’injection SQL et le cross-site scripting, et utilise la gestion dynamique du trafic pour de meilleures performances.
Est-il possible de créer un domaine séparé pour chaque version de mon projet ?
Non. Chaque version utilise un chemin personnalisable au sein du domaine existant plutôt qu’un domaine séparé.
Changer le domaine personnalisé affectera-t-il le widget ou les liens d’articles existants ?
Non. Le widget s’authentifie à l’aide d’un jeton API, donc il continue de fonctionner 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 non plus. Si vous avez utilisé des URL complètes à la place, relisez-les et mettez-les à jour manuellement — utiliser des liens relatifs est la meilleure pratique pour éviter cela.
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, puisque Cloudflare bloque les enregistrements CNAME sur différents comptes. Sur un compte Cloudflare payant, vérifiez si « Empêcher également les sous-domaines » (zone hold) est activé — désactivez-le temporairement, laissez le domaine vérifier, puis réactivez-le. Sur un compte gratuit, la zone hold est désactivée par défaut ; assurez-vous que vos enregistrements CNAME se propagent dans les 7 jours suivant leur génération dans Document360, et si la vérification échoue toujours, retirez et reconfigurez le domaine personnalisé. Si les problèmes persistent, contactez le support Cloudflare, car la cause peut être liée à la facturation.
L’ajout d’un domaine personnalisé modifie-t-il mon lien vers le portail Document360 ?
Non. L’URL de votre portail reste la même — le domaine personnalisé ne s’applique qu’au site de la base de connaissances, pas au portail administratif.
Puis-je personnaliser la structure des URL de ma base de connaissances ?
Non, la structure de l’URL est fixe. Vous pouvez configurer un domaine personnalisé ou modifier un slug d’article, mais les composants essentiels comme la version du projet, le langage et les chemins définis par le système (par exemple, /docs/) ne peuvent pas être modifiés.
Comment puis-je obtenir une URL plus propre ou plus conviviale pour ma base de connaissances ?
Le format URL lui-même est fixe, mais vous pouvez le rendre plus propre en modifiant le sous-domaine par défaut (via Paramètres > Domaine personnalisé > Modifier le domaine), en configurant un domaine personnalisé pour remplacer complètement le sous-domaine Document360, ou en renommant votre projet avec un nom plus court, ce qui met également à jour le sous-domaine par défaut. Supprimer le code de la langue de l’URL n’est pas pris en charge, et la redirection au niveau de l’article ne peut pas changer le format de l’URL lui-même.
Pourquoi la vérification Google Search Console ne fonctionne-t-elle pas pour mon site de base de connaissances ?
La vérification Google Search Console ne fonctionne que sur un domaine personnalisé. Si votre site est sur un sous-domaine Document360, la vérification échoue quelle que soit la méthode, car les sous-domaines Document360 partagent le domaine racine de la plateforme et leur vérification pourrait entrer en conflit avec le branding et le SEO propres à Document360. Configurez d’abord un domaine personnalisé, puis effectuez la vérification avec n’importe quelle méthode prise en charge.
Changer le sous-domaine fourni par Document360 affectera-t-il ma configuration SSO ou SCIM ?
Non. Changer le sous-domaine fourni par Document360 n’affecte pas l’authentification SSO existante ni la configuration SCIM, bien que les utilisateurs se connectant via SSO devront utiliser le sous-domaine mis à jour par la suite.