How to Manage the Multidomain App

Rebrand your platform to show customized branding elements.

Last Updated

July 19th, 2017

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 platform versions 6.6 or higher and only for Enterprise solutions. To activate this app, please contact your Sales account.

Configuring Multidomain Settings

Log in as Superadmin and select the gears icon from the left sidebar to access the Admin menu, then find the Multidomain section, and press the Settings subitem. 

multidomain admin menu

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 be flagged both globally (for all Multidomain clients, on this page) or locally (on a client-to-client basis).

multidomain settings

Please note that if you flag this option, it will be disabled for individual clients if you flag the option to enable customized sign in settings for this option. We’ll take a look at that later on in the article.

Creating Multidomain Clients

Now, you can create multidomain clients by accessing the main Muiltidomain Management page (Admin Menu, 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. Let’s begin by pressing 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).

Users of this node 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. Select NEXT to proceed.

multidomain create client

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.

Assign a branch

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

Now you can set up the preferences. Find the new client in the list of clients on the bottom half of the page, then click on the Settings icon in the client’s row.

Settings

You will now be redirected to the client’s main Settings page, where you will see 11 tabs on the left side of the page that organize how you can manage this client. We’ll go through each tab, starting with the first one.

Logo and Colors Tab

In this tab, you can type in a page title, which is an E-Learning platform name that will appear on the browser’s tabs and top bar.

logo & colors

Now, upload a logo and favicon. You can also flag the option to include a header message. When you flag this option, a text box will appear, allow you to type and edit a message for your users as desired. Finally, select a color scheme from the drop down menu in the last section of this tab. When finished, press SAVE CHANGES and move on to the next tab: Sign in Page.

Sign In Page Tab

multidomain login

This tab allows you to customize the login page that users will access when they click on the specified URL that you configured when you created the client. Users who have yet not logged into the platform will see a different homepage, depending on the URL. In order to enable the customization of the login page, select the option Enable custom settings for this client, otherwise users assigned to this folder will see the standard login page.

Please Note: You cannot configure these settings when the public catalog is enabled in the Courses Catalog app settings page.

From this page, flag the option to enable login restriction. Flagging this option restricts user login to only the Multidomain client to which they belong. You can also flag this option on the main Multidomain Settings page if you want to apply it to all multidomain clients.

Remember: If you have flagged the option to enable login restrictions globally, for all multidomain clients, from the main Multidomain settings page, it will NOT apply to an individual multidomain client if you have not flagged the option locally in this tab. Local settings override global settings in this scenario.

You can also create a specific template by changing the position of the login boxes,  choosing and uploading a specific background image, and adding home page text and additional pages.

sign in page 2

Select SAVE CHANGES, then move to the next tab: Customize CSS.

Customize CSS Tab

With this tab, you can create specific CSS and apply it only for users associated with this specific client/branch.

customize css

Press SAVE CHANGES, then move on to the next tab: Course Player.

Course Player Tab

In this tab, you can apply specific settings related to the training material area for the users associated with this client. 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 training material settings.

course player

Then, choose if you want to apply the ‘player view’ (and the related background image) or the ‘list view’ to the courses, and whether you want to apply specific CSS to the HTML learning object. Click here  to learn more about the training material view. Select SAVE CHANGES, then move on to the next tab: Docebo White Label.

Docebo White Label Tab

If you have previously activated the White Label APP, you will also be able to change the footer and naming elements of the platform.

White label

This APP allows you to:

  • Hide or customize the “Powered by Docebo” statement at the bottom of the page for each branch.
  • Remove or customize the word DOCEBO on any page of your E-Learning platform.
  • Choose the recipient of the help desk requests. Please note that if you decide to change the email address contained in this field, all other platform Superadmins (except you) will send the help requests to this specified address, which means that the tickets they open will not be forwarded to the Docebo HD.
  • Hide or customize the www.docebo.com link for each branch.

Click SAVE CHANGES and move on to the next tab, Courses Catalog.

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.

courses 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. Click SAVE CHANGES and move on to the next tab, E-Commerce Settings.

E-Commerce Settings 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. Click here to learn more about E-Commerce settings.

ecomm

Click SAVE CHANGES to finalize the operation, then move on to the next tab: Self Registration.

Self Registration Tab

In this tab, you can apply a specific registration type to users in this domain:

  • Free self-registration
  • Moderated self-registration
  • Only-by-administrator registration

Furthermore, you can restrict user registration in the LMS to a specific email domain, so that if users register themselves using an email with a different domain, their subscription will be automatically rejected. Define the domains that are allowed by inserting the list of domains in the Restrict domains field.

Restrict domain

If a user tries to register in the LMS using a domain that is not on the allowed list, the system will automatically display the following message:

ken.smith

Remember: This feature only works with the self-registration and the moderated registration policies. Click SAVE CHANGES to finalize the operation, then move on to the next tab: HTTPS.

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 manual to learn more.

https

Click SAVE to finalize the operation, then move on to the next tab: SAML 2.0 Settings.

SAML 2.0 Settings Tab

SAML 2.0 is a Docebo app that allows users to use SAML for single sign-in between their active directory and the Docebo LMS for each different URL configured in the multi-domain area. 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.

The Docebo Multi ADFS app requires that the HTTPS certificate is correctly installed for each domain you want to use. This app is only available for Docebo version 6.6.1 or higher, and for the Enterprise Solutions with the following apps activated and correctly configured: SAML 2.0 APP and Custom Domain HTTPS.

SAML - ADFS Multidomain

Please check this manual to learn how to activate and set up this app. Click SAVE to finalize the operation, then move on to the next tab: LDAP App Settings.

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. People who access the platform from different URLs will be able to authenticate their credentials through different LDAP systems. This feature is only available for the platform version 6.7 or higher.

Ldap

Please check this manual to learn how to activate and set up the LDAP APP. Click SAVE to finalize the operation, then move on to the next tab: Language Settings.

Language Settings Tab

If you are using Docebo 6.8 or higher, Superadministrators can manage the active set of languages and assign a default language for multidomain clients.

md lang tab

To edit the languages, flag the option to Enable custom language settings for this client. The language list below will no longer be greyed out.

md lang flag

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.

md lang list
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. Once you have applied all of the settings for your client, you will find the users’ folder associated with this client colored in green inside the organizational chart. You can always access the settings applied in the organizational chart by clicking on the Edit branding template button.

Orgh chart

Subfolder Restrictions for Multidomain Clients

When creating subfolders for multidomain clients, you cannot create subfolders that start with 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