Introduction
The Domain Management settings serve as a central location where a Superadmin can:
- Set up email senders, used primarily for platform notifications and self-registration purposes, either using DKIM or SMTP
- Manage custom domains for the platform
- Manage secondary domains used for extended enterprise clients
- Configure SSL certificates to protect HTTP traffic
Functions of the Domain Management feature create a unified management area, replacing the HTTPS and Custom Domain app functionalities.
The purpose of this article is to provide an overview of how to navigate the Domain Management feature and to introduce the concepts contained within.
Important information after migrating to Domain Management
After migrating to Domain Management, you may find that your domain displays a message telling you This is an interim configuration and can not be edited in its current form. Docebo requires that all custom domains be protected with a valid SSL certificate for HTTPS traffic.
To remedy this message, you can choose to use a Docebo managed SSL certificate or you can paste your own certificate into the field labelled SSL Certificate, according to the guidelines in the article Domain Management: Managing self-supplied SSL certificates.
Please note: if you have previously uploaded a SSL certificate and receive this message, you will need to re-upload your SSL certificate.
Until a valid certificate has been added to your domain, the custom domain will remain in a read-only mode and can not be modified in any way.
Custom and secondary domains
What is a domain?
A domain name is a unique branded name that identifies a website. Learners can use this domain to access your learning platform. Your domain must be registered with a domain registrar.
Use case scenarios
A useful scenario for a custom domain is when, at your company, you as a platform Superadmin would like to redirect your users to a different URL than the docebosaas.com
URL that was provided with the contract. Updating the docebosaas.com
URL to a known company URL will make it easier for the learners to remember and navigate the platform’s URL.
First, make sure that the custom domain that you would like to change the platform URL to is purchased and owned by your company. Additionally, unless you choose the option to use a Docebo managed SSL certificate, your company will need to purchase an SSL certificate to ensure that the site is secure when the redirect is in place. Lastly, your company will need to update your domain name system (DNS) settings by adding a CNAME record redirecting to your docebosaas
URL before the custom domain is added to the platform along with the SSL certificate. Once the custom domain is created and selected in the platform, the SSL certificate is successfully uploaded, and the DNS settings are updated, the redirect will be in place. With the custom domain enabled, the user can simply go to the site via the custom domain, for example at https://learn.mycompanyname.com
, to access the platform as opposed to the docebosaas.com
URL.
Please note: When adding a DNS record, please allow for adequate time to pass in order for the record to properly propagate before testing your domain. Also, if you are changing an existing record, please allow the TTL time of the old record to pass before attempting to use the updated record.
Accessing Domain Management
To access the Domain Management settings, as a Superadmin, press the gears icon in the top right corner of the screen. Then, in the left menu locate and press Domain Management to navigate to the settings screen.
Navigating the Domain Management settings
Domain Management is split into four sections; Main Domain, Secondary Domains, Email Sender Domains and SSL Certificates. Each section can be accessed by pressing on the appropriately labeled tab.
The Main Domain tab
The Main Domain tab contains information about your platform's main domain, which is assigned by Docebo and is read-only. It also contains the functionality for assigning a custom domain and validating the DNS settings as well as assigning an SSL certificate to the domain from within the same screen. For more information on configuring a custom domain, please see Domain Management: Configuring custom domains. More information about the DNS record configuration requirements for custom domains can be found in Domain Management: DNS record configuration requirements.
The Secondary Domains tab
The Secondary Domains tab contains information about various third-level domains associated with your platform. Each entry can be configured to use its own custom SSL certificate or have its encryption managed by the platform. For more information see Domain Management: Configuring secondary domains article.
The Email Sender Domains tab
The Email Sender Domains tab contains information about various domains able to send emails. These domains can be configured as built-in, using Docebo's SMTP service or custom, using external SMTP servers. This section also contains the configuration options for SPF, DKIM and MX records. For more information please see Domain Management: Configuring email domains.
The SSL Certificates tab
The SSL Certificates tab contains information about uploaded and assigned SSL certificates. For more information about self-supplied SSL certificates, please see Domain Management: Managing self-supplied SSL Certificates.
Frequently asked questions
For information about frequently asked questions, please see the article Domain Management: Questions and Answers.