Introduction

Un domaine personnalisé vous permet de remplacer l’URL docebosaas.com de votre plateforme par un domaine de votre choix (par ex. https://learn.mycompanyname.com), plus facile à retenir et à parcourir pour les apprenants, et reflétant mieux l’identité de marque souhaitée. 

Cet article explique comment configurer un domaine personnalisé pour votre plateforme. Le processus comprend quelques étapes préliminaires qui doivent être effectuées en dehors de la plateforme, telles que l’achat/l’enregistrement du domaine, la configuration de ses enregistrements DNS et l’obtention d’un certificat SSL. Ensuite, l’étape finale consiste à configurer le domaine personnalisé dans l’espace de Gestion des domaines de la plateforme.

Prérequis

Application Domaine personnalisé 

Activez l’application Domaine personnalisé comme décrit dans l’article Gérer les applications et fonctionnalités de la base de connaissances. L’application est répertoriée dans l’onglet Fonctionnalités supplémentaires de Docebo.

Nom de domaine :

Vous devez posséder le nom de domaine que vous souhaitez utiliser comme domaine personnalisé. Généralement, cela se fait via votre fournisseur d'enregistrement ou le service informatique de votre entreprise. 

• un domaine personnalisé peut être entre le 3ème et le 5ème niveau. 
• learning.votreentreprise.com est un exemple de domaine de 3ème niveau. learning.support.maarque.com est un exemple de domaine de 4ème niveau.
• ne réutilisez pas un domaine de messagerie comme domaine personnalisé, car les configurations DNS requises peuvent entrer en conflit : la plupart des services DNS n’autorisent pas la coexistence d’un enregistrement CNAME et d’un enregistrement SPF pour le même domaine.

Paramètres DNS :

Le domaine que vous avez obtenu doit être configuré pour pointer vers votre plateforme (par ex. → monentreprise.docebosaas.com). Cela nécessite la mise à jour des enregistrements DNS de votre domaine, et s'effectue généralement par l'intermédiaire de votre registraire de domaine, de votre hébergeur ou de votre service informatique d'entreprise si vous disposez d'un serveur DNS auto-hébergé. 

Par exemple, pour un domaine personnalisé de troisième niveau tel que subdomain.votreentreprise.com, vous devrez fournir un enregistrement CNAME, résolvant votre domaine de troisième niveau vers votreentreprise.docebosaas.com. 

➢ Pour plus d'informations, consultez l’article sur la Gestion des domaines : exigences de configuration DNS.

Lors de l’ajout d’un enregistrement DNS, veuillez prévoir un délai suffisant pour que l’enregistrement se propage correctement avant de tester votre domaine. De plus, si vous modifiez un enregistrement existant, veuillez laisser passer le TTL (Time to Live) de l’ancien enregistrement avant de tenter d’utiliser l’enregistrement mis à jour.

N’oubliez pas qu’une configuration DNS correcte doit être en place avant que vous ne puissiez obtenir un certificat SSL pour le domaine ou configurer le domaine personnalisé dans la Gestion des domaines.

Certificat SSL :

Le domaine personnalisé devra être protégé par un certificat SSL. Vous avez deux options pour cela : 

• utilisez un certificat géré par la plateforme. Pour cela, vous n’avez besoin de rien préparer à ce stade.
• utilisez un certificat que vous avez obtenu vous-même auprès d'une autorité de certification (CA) ou d'un fournisseur. Dans ce cas, vous devrez le téléverser sur la plateforme avant de configurer le domaine.
  → Suivez les instructions dans Gestion des domaines : certificats SSL personnalisés pour Ajouter un certificat SSL à la plateforme.
  → Vous pouvez également commencer à configurer le domaine avec un certificat géré par la plateforme à titre de mesure provisoire, puis le remplacer par un certificat que vous avez obtenu vous-même.

Configurer le domaine personnalisé

Une fois que vous avez terminé toutes les étapes des Prérequis, vous pouvez passer à la configuration du domaine personnalisé dans la plateforme. 

1. Sélectionnez Menu de navigation > Configuration (icône de clé à molette) > Configuration de la plateforme et outils > Gestion des domaines.
2. Dans l’onglet Domaine principal, cochez la case Activer le domaine personnalisé, et saisissez le nom de domaine que vous avez précédemment configuré avec votre fournisseur d'enregistrement. 
3. Cliquez sur Tester la configuration pour vérifier qu'il pointe bien vers votreentreprise.docebosaas.com comme prévu.
   → Si la validation échoue, vérifiez les paramètres DNS de votre domaine et assurez-vous d'avoir laissé suffisamment de temps pour que ces paramètres se propagent.
4. Faites défiler vers le bas jusqu'à la section Certificat SSL. Ici, vous devez définir si vous souhaitez utiliser un certificat Géré par la plateforme ou un Certificat SSL personnalisé.
5. Dans le cas d'un certificat SSL personnalisé, sélectionnez le certificat que vous avez précédemment ajouté à la plateforme dans la liste déroulante.
   → la liste n'affichera que les certificats correspondant au nom de domaine
6. Dans le cas de géré par la plateforme, aucune autre action n'est nécessaire. La plateforme va : 
   • créer le certificat SSL
   • téléverser le certificat SSL
   • garantir la distribution correcte du certificat
   • gérer automatiquement le renouvellement du certificat avant sa date d'expiration
7. Cliquez sur Enregistrer les modifications.

En cas d'erreur avec le certificat Géré par la plateforme, vérifiez que les paramètres DNS de votre domaine sont corrects, comme indiqué dans l'article Gestion des domaines : exigences de configuration DNS > Certificats SSL Let’s Encrypt (gérés par la plateforme).