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é tel que décrit dans l'article Gérer les applications et fonctionnalités de la base de connaissances. L'application est répertoriée sur l'onglet Fonctionnalités supplémentaires de Docebo.
Nom du 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.
Exemples :
-
est un exemple de domaine de 3e niveau.learning.entreprise.com -
est un exemple de domaine de 4e niveau.learning.support.marque.com
À noter : 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.
À noter : lors de l’ajout d’un enregistrement DNS, veuillez prévoir un délai adéquat pour que l’enregistrement se propage correctement avant de tester votre domaine. Par ailleurs, si vous modifiez un enregistrement existant, veuillez laisser s’écouler le délai TTL (Time To Live) de l’ancien enregistrement avant de tenter d’utiliser le nouveau.
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 :
| Option | Description |
|---|---|
| Certificat géré par la plateforme | utilisez un certificat géré par la plateforme. Pour cela, vous n’avez besoin de rien préparer à ce stade. |
| Certificat personnalisé |
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. |
Astuce : 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.
Tout d’abord, sélectionnez Menu de navigation > Configuration (icône de clé à molette) > Configuration de la plateforme et outils > Gestion des domaines. Ensuite, dans l’onglet Domaine principal , cochez la case Activer le domaine personnalisé et saisissez le nom de domaine précédemment configuré avec votre fournisseur d’enregistrement. Ensuite, cliquez sur Tester la configuration pour vérifier qu’elle pointe vers entreprise.docebosaas.com comme prévu.
Astuce : 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.
Ensuite, rendez-vous à 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é. Dans le cas d’un certificat SSL personnalisé, sélectionnez celui que vous avez précédemment ajouté à la plateforme depuis le menu déroulant.
Astuce : la liste n’affichera que les certificats correspondant au nom de domaine.
Avec l’option 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
Puis 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).
Attention : les certificats gérés par Docebo le sont en partenariat avec un service externe sur lequel Docebo n’exerce aucun contrôle (Let’s Encrypt - le lien s’ouvre dans un nouvel onglet). Par conséquent Docebo ne peut garantir son fonctionnement avec les mêmes standards que ceux selon lesquels fonctionne la plateforme Docebo Learn. À ce titre, la fonctionnalité de création de certificats gérée par Docebo doit être considérée comme une étape intermédiaire.
Notez également que pour les certificats gérés par Docebo, il existe une limite de 5 certificats par domaine par semaine.
Afin de garantir une sécurité maximale et de disposer d’un contrôle total sur vos certificats, Docebo vous recommande vivement d’obtenir les certificats numériques requis par l’intermédiaire de votre partenaire de confiance et de demander l’aide de votre équipe informatique ou de sécurité pour ce faire.