How to Manage the Multidomain App

Rebrand your platform to show customized branding elements.

Last Updated

February 14th, 2018

Reading Time

8 min

Version

,

User Level

Docebo’s Multidomain App is a useful tool that allows you to rebrand your platform to show customized branding elements for each organizational chart node. This app is only available for Enterprise solutions. To activate this app, please contact your Sales account.

Configuring Global Multidomain Settings

Start your configuration by managing the global settings of the app. Log into your platform as the Superadmin, then select the gear icon from the top right corner of the page to access the Admin Menu. Find the Multidomain section, then press the Settings subitem. 

On the Settings page, you can flag the option to enable login restrictions for all of your multidomain clients that you create. Flagging this option restricts user login to only the Multidomain client to which they belong. This option can only be flagged globally (for all Multidomain clients).

multidomain settings

Please note that when this option is NOT flagged, if a user attempts to access a multidomain platform to which they are not assigned, there is a multidomain selection page that allows the learner to select a platform to which they have access. The page displays a list of all platforms that the user has permission to access. He or she simply need to click in the platform’s name and log into that platform.

Please remember that this page only appears when the Enable multidomain login restrictions option is NOT flagged on the Settings page for the Multidomain app. When this option is enable, if a user attempts to access a multidomain platform to which they are not assigned, he or she will simply receive an error message and will not be allowed to login.

Please note that as a Superadmin, you are always allowed to access any multidomain platform, so this page will not appear when logging into the platform as a Superadmin.

Creating Multidomain Clients

You can create multidomain clients by accessing the main Multidomain Management page. Reach the Admin Menu, then press the Manage item in the Multidomain section. You will see a button in the action bar at the top of this page that allows you to create a new client, and a list of clients on the bottom half of the page.

Press the New Client button at the top of the page. In the pop up box, assign a name to the client, and choose if you want to assign a new domain, or use a subdomain from your platform. You can also choose to create a subfolder instead, if desired. Please note that your Docebo LMS only takes domains up to the third level. For reference:

  • Second level: docebo.com.
  • Third level:  example.docebo.com.

Any level beyond this will not work. Keep in mind that any subdomain you want to use must be registered with an Internet Service Provider (ISP).

multidomain create new

Users of this branch will have their own URL to access the platform. When you create your Docebo installation, you will first choose a default domain name for your new platform (e.g. elearningbox.com), but the intention with this app is that by using custom URLs, you can assign additional domain names to the same Docebo installation.

Then, in the dropdown menu, select a theme for this client’s platform. Learn more about Docebo themes here. Press Next to proceed. Now assign a branch of your organizational chart to this customer, then press Next. Please note that you can only assign one multidomain client to a user branch in your LMS. Multiple multidomain clients cannot be added to a single branch. If you try to add a multidomain client to a branch that already has an assigned client, you will receive an error message. Now, users will be able to see a different color scheme, URL, logo, homepage image, and course player based on their organizational chart node.

Managing Client Preferences & Themes

To manage client settings and preferences, find the client in the list of clients on the bottom half of the main Multidomain page, then press the Settings icon (gears icon) in the client’s row. On the client’s Settings page, there are various tabs on the left side of the page that organize how you can manage this client. At the top of the page, press the Configure Theme button to change which theme is applied for this client, or press the pen and paper icon to edit any details that you inserted when you first created the client.

multidomain configure

Docebo White Label Tab

For those using Docebo’s White Label, you can apply white label settings to specific multidomain clients, or adjust various parts of the theme in this tab. Please note that the options in this tab change depending on which theme you’ve selected for the client, so you should refer to the corresponding articles linked in this section for more information about the options in this area.

multidomain white label

HTTPS Tab

If you have activated the Custom Domain Https app, you can upload and install your SSL certificate for each domain configured via this app. Refer to this article to learn more. When finished, press Save.

Courses Catalog Tab

In this tab, you can apply specific settings related to internal or external course catalogs. In order to enable the customization of this area, select the option Enable custom settings for this client, otherwise users assigned to this folder will see the standard course catalog settings.

multidomain course catalog

Then, you can flag whether you want to use a catagory tree for the catalog, as well as show the catalog to non-authenticated users. You can also choose whether to show all available public courses or learning plans, or choose to display a specific catalog. Press Save when finished.

E-Commerce Tab

This tab allows you to apply specific E-Commerce settings (assign the currency, account, and payment gateway) for this client. In order to enable the customization of this area, select the option Enable custom settings for this client. Now, you can insert a specific currency symbol to display to the end users of this client and select a currency from the dropdown menu.

multidomain ecomm

Press Save Changes when finished.

Self Registration Tab

In this tab, you can apply a specific registration type to users in this domain. Begin by flagging the option to enable custom settings for the client. Then, flag whether you want to allow quick registration for these learners when the register into the platform.

Next, select whether these users can have free self-registration, moderated self-registration, or only-by-administrator registration. Refer to this article to learn more about the different registration types.

multidomain self registration

You can also flag the option to not send the confirmation email to users upon self-registration if you’ve allowed free or moderated self-registration, but please not that flagging this option means that you will have to manually send users their credentials.

Next, you can restrict user registration into the platform to a specific email domain, so users registering themselves using an email with a different domain will be automatically rejected. Define the domains that are allowed by inserting the list of domains in the Restrict Domains field.

Please Note: This feature only works with the self-registration and the moderated registration policies.

Press Save Changes when finished.

Mobile App Settings

In this tab, you can customize the mobile app login page, color and logo for this client. Begin by flagging the option to enable custom settings for the client. Now, you can insert a hex code press the color square in the Login Page Background and Main App Color sections to change the colors of the corresponding areas.

multidomain mobile

You can also upload an app logo by pressing the Upload File button. When finished, press Save Changes.

Auth0 Settings

In this tab, you can activate Auth0 for this specific client. With this integration, you can allow users to log into their Docebo platforms using credentials from active session of other web platforms. This integration is available for everyone, and can be used in the 6.9 and 7.0 themes. Refer to this article for more information.

multidomain auth0

SAML 2.0 Settings Tab

SAML 2.0 allows users to use SAML to sign in between their active directory and the LMS for each multidomain client. Activating this app allows your users to log into their computer and, with an active session, also sign into the Docebo LMS, using the domain assigned to each one by the multidomain app.

To learn more about the settings in this tab, refer to this article. Press Save Changes when finished.

LDAP App Settings Tab

If you have activated the LDAP app, you can assign a specific LDAP configuration to each domain you have in your Multidomain platform. Users who access the platform from different URLs will be able to authenticate their credentials through different LDAP systems.

multidomain ldap

Please refer to this article to learn how to activate and set up LDAP. When finished, press Save Changes.

Language Settings Tab

You can also manage the active set of languages and assign a default language for multidomain clients. To edit the languages, flag the option to enable custom settings for this client. The language list below will no longer be greyed out.

multidomain language

In the last column for each row, you will see a checkmark to activate or deactivate a language. Simply click the checkmark to do so. A green checkmark means the language is active, and a grey checkmark means the language is not active.

In the Default column, you can click on a flag in a language’s row to make the flag green, thus setting it as the default language for that client.

Subscription Settings Tab

For those using the subscriptions module in Docebo, you can apply specific settings to a multidomain client, overriding any global settings that you configured for the module. Simply flag the option at the top of the tab to enable custom settings for the client, then flag any of the subscriptions options that you want to apply. To learn more about these options, refer to this article. When finished, press Save Changes.

multidomain subscriptions

User Options Tab

In this tab, you can flag various options to apply to this client when creating users or when they are logging into the platform. Begin by flagging the option to enable custom settings for the client.

Now, flag whether you want new users that you create to have auto-calculated passwords upon creation, and if you want to consider the email addresses of the new users as either usernames for the platform as well.

multidomain user options

Finally, flag whether you want to enable the Remember Me functionality on the login page for this client. By flagging this option, users won’t have to provide their login credentials again after the first login on a specific device. Press Save Changes when you’re finished.

Advanced Tab

In this tab, you can flag whether to activate the “send notification” option when Admins create new users. Upon creating the new user, the User has been created (by administrator) will be sent to the email address that you added for the user. Please note that this notification must already be configured and activated using the Notifications app if you want to use this feature. When finished, press Save Changes.

multidomain advanced

Subfolder Restrictions for Multidomain Clients

When creating subfolders for multidomain clients, you cannot create subfolders that start with or are labeled exactly as the following words:

  • hybridauth
  • doceboLms
  • addons
  • admin
  • api
  • authoring
  • common
  • gapps
  • lms
  • app7020
  • mobile
  • moxiemanager
  • plugins
  • custom_plugins
  • tcapi
  • themes
  • sso
  • oauth2
  • pens
  • webapp
  • cookiebaker
  • simplesaml
  • offline.php
  • check_*.php
  • legacy
  • learn/v1
  • demo/v1
  • manage/v1
  • notifications/v1
  • share/v1
  • skill/v1
  • docs/v1
  • debug
  • hydra-assets
  • learn
  • demo
  • manage
  • notifications
  • share
  • skill
  • docs
  • unauthorized
  • public
  • ecommerce/v1
  • setup/v1
  • salesforce/v1
  • setup
  • ecommerce
  • salesforce

Share on Facebook0Tweet about this on TwitterShare on Google+0Share on LinkedIn0Email this to someone