Introduction

Les domaines secondaires sont utilisés sur les plateformes des entreprises étendues. Ils permettent d’accéder à un client d’une entreprise étendue via un nom de domaine de votre choix, par ex. https://www.companysales.com, plutôt que via une URL basée sur un sous-dossier comme  https://<votreentreprise>.docebosaas.com/sales.

Vous pouvez associer un domaine secondaire différent, nommé de manière descriptive, à chacun des clients de votre entreprise étendue. 

Cet article explique comment configurer un domaine secondaire pour un client d’une entreprise étendue. 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, vous pouvez configurer le domaine secondaire dans l’espace de gestion des domaines de la plateforme. L’étape finale consiste à associer le domaine secondaire à votre client de l’entreprise étendue.

Prérequis

Application Extended Enterprise

La fonctionnalité Extended enterprise doit être activée sur votre plateforme, car c’est ici que vous créez les clients de votre entreprise étendue qui seront associés à des domaines secondaires. Consultez l’article Gérer l'application Extended Enterprise. 

Application Domaine personnalisé (facultatif)

Ceci n’est nécessaire que si vous souhaitez avoir un domaine personnalisé pour accéder à votre plateforme principale, puis utiliser des sous-domaines de ce domaine personnalisé pour les clients de votre entreprise étendue. 

Nom de domaine :

Vous devez posséder le domaine secondaire que vous souhaitez associer à votre client dans votre entreprise étendue. Généralement, cela se fait via votre fournisseur d’enregistrement ou le service informatique de votre entreprise. 

• un domaine secondaire peut être entre le 3ème et le 5ème niveau. 
• un exemple de domaine de 3ème niveau est sales.yourcompany.com. Un exemple de domaine de 4ème niveau est learning.support.mamarque.com.
• si vous avez un domaine personnalisé de 5ème niveau, vous ne pourrez pas en créer un sous-domaine (6ème niveau) en tant que domaine secondaire.  Mais vous pouvez toujours utiliser tout autre nom de domaine des niveaux autorisés (du 3ème au 5ème) comme domaine secondaire. 
• ne réutilisez pas un domaine de messagerie comme domaine secondaire, 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 l’URL docebosaas principale de 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é. 

➢ Pour plus d’informations, consultez l’article sur la Gestion des domaines : exigences de configuration DNS > Domaines personnalisés et domaines secondaires.

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 secondaire dans la Gestion des domaines.

Certificat SSL :

Le domaine secondaire 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 secondaire

Une fois que vous avez terminé toutes les étapes des Prérequis, vous pouvez passer à la configuration du domaine secondaire 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. sélectionnez l’onglet Domaines secondaires. Cet espace affiche une liste des domaines secondaires déjà configurés dans la plateforme. 
3. cliquez sur l’icône plus (Nouveaux domaines et certificats) dans le coin supérieur droit et sélectionnez Nouveau domaine secondaire. 
4. dans le panneau de configuration qui s’ouvre, dans le champ Nom, saisissez le nom de domaine que vous avez précédemment configuré avec votre fournisseur d’enregistrement.
   
5. cliquez sur Tester la configuration pour vérifier qu’il pointe vers l’URL de votre plateforme, 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.
6. 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é.
7. 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
8. dans le cas de Géré par la plateforme, aucune autre action n’est nécessaire. La plateforme créera, téléversera et garantira la distribution correcte du certificat SSL, et gérera automatiquement son renouvellement.
9. cliquez sur Créer.

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 Exigences de configuration DNS > Certificats Let’s Encrypt (gérés par la plateforme). 

Associer un domaine secondaire à un client d’une entreprise étendue

Une fois que vous avez configuré un domaine secondaire dans la gestion des domaines, vous pouvez vous rendre sur la page d’Extended Enterprise et l’associer à un client nouveau ou existant. 

Astuce : vous pouvez initialement configurer un client d’entreprise étendue de type sous-dossier. Ensuite, lorsque tout est en place, vous pouvez modifier le client et le lier à un domaine secondaire. 

Sélectionnez Menu de navigation > Configuration (icône de clé à molette) > Configuration de la plateforme et outils > Gestion de l’entreprise étendue  pour accéder à la page dédiée. Sur cette page, vous verrez une liste de tous les clients existants. 

Pour créer un nouveau client, cliquez sur Nouveau client dans le coin supérieur gauche de la page. Pour modifier un client existant, cliquez sur l’icône d'édition sur la ligne de ce client. 

Dans la fenêtre Créer/Modifier le client, saisissez le Nom pour le client si nécessaire. Ensuite, sélectionnez l’option correspondant au type de domaine secondaire que vous avez configuré dans la Gestion des domaines :

• Sous-domaine : cette option apparaît si vous avez un domaine personnalisé configuré pour l’URL de votre plateforme principale. Si le domaine secondaire que vous avez configuré est un sous-domaine de votre domaine personnalisé, il apparaîtra ici.   
• Nouveau domaine : sinon, le domaine secondaire précédemment configuré apparaîtra ici. 

Après avoir sélectionné le domaine secondaire dans la liste déroulante, cliquez sur Suivant et poursuivez la configuration du client comme décrit dans l’article Gérer l'application Extended Enterprise > Créer des clients pour votre entreprise étendue. 

Gérer les domaines secondaires

Pour afficher la liste des domaines secondaires déjà configurés, sélectionnez Menu de navigation > Configuration (icône de clé à molette) > Configuration de la plateforme et outils > Gestion des domaines et sélectionnez ensuite l’onglet Domaines secondaires. 

Les domaines répertoriés ici sont ceux qui sont disponibles pour ou déjà associés à des clients d’une entreprise étendue.
→ Pour vérifier quels domaines sont encore disponibles, vous devez vous rendre sur la page Extended Enterprise et, dans la fenêtre Créer/Modifier le client, contrôlez ceux qui apparaissent dans les listes déroulantes Nouveau domaine ou Sous-domaine.

Vous pouvez filtrer les domaines secondaires par type de gestion de certificat SSL, ou saisir du texte dans la zone de recherche pour trouver rapidement un domaine spécifique. 

Sur la ligne d’un domaine, cliquez sur le bouton avec les points de suspension pour accéder aux actions disponibles :

• Modifier : un panneau de configuration s’ouvre où vous pouvez modifier  la configuration de ce domaine secondaire. Par exemple, ici vous pouvez remplacer le certificat SSL personnalisé d'un domaine ou en générer un Géré par la plateforme. Pour plus de détails, consultez le chapitre Configurer le domaine secondaire.
  Notez que si vous renommez le domaine, le nouveau nom doit avoir une configuration DNS valide et vous devrez téléverser ou générer un certificat SSL correspondant, comme indiqué dans le chapitre Prérequis. 
• Supprimer : si votre domaine est lié à un client de votre entreprise étendue, vous recevrez un message vous invitant à supprimer d’abord l’association avant de pouvoir supprimer le domaine.  Lorsque vous supprimez un domaine, l’association avec son certificat SSL est supprimée. Dans le cas d’un certificat SSL personnalisé, vous verrez dans l’onglet Certificats SSL que le domaine n’est plus attribué au certificat. Dans le cas d’un certificat Géré par la plateforme, le certificat est révoqué.