Portal branding

Portal branding lets you white-label AD Web and brand it per URL. You do this with the Themes and Brandings pages in the admin area. You can create any number of themes and brandings, and bind them to any number of URLs.

Themes#

AD Web comes with a few built-in themes with different layouts. You can create your own theme based on a built-in theme or on one of your custom themes.

Create a theme#

1. Go to Admin > Themes and select Add Theme.

   

2. Fill in the fields:

   Field	Description
   Theme Name	A name for your new theme.
   Select Theme	The existing theme to copy as a starting point.

3. Select Submit. AD Web creates the theme and opens the customiser.

   

4. Customise the theme and select Save.

Next, bind the theme to a URL on the Brandings page.

Customise beyond the admin panel#

Each theme is a folder in \Dart\ADWeb\wwwroot\themes\. For example, a theme named Fintech Orange is in \Dart\ADWeb\wwwroot\themes\Fintech Orange.

File	Use
style.css	Add your own CSS for changes the customiser doesn't cover.
footer.html	A custom footer for the theme, in HTML or plain text.

Brandings#

A branding binds a theme to a URL and controls which domains that URL shows. Use brandings when you host several customers, or separate departments, so that:

• Users reach AD Web on their own branded URL.
• Users see only the Active Directory domains they can access.
• The domain dropdown is hidden, to avoid confusion for OU Admins or regular admins.
• Customers can't see other customers' domains.

Add a branding#

1. Go to Admin > Brandings and select Add Branding.

   

2. Fill in the fields:

   Field	Description
   Name	A name for your reference.
   URL	The URL to bind the theme to. Enter the domain only, without http://, https:// or a port.
   Theme	The theme to use for this URL.
   Allowed Domains	The Active Directory domains this URL shows. For example, if your customer Fintech may use only one domain, select only that domain.

3. Optionally, turn off the domain dropdown. This is useful when a customer, department or group uses only one domain.

4. Optionally, show or hide Forgot Password and Remember Me for this URL.
5. Save the branding.

Restrict access to listed hosts#

Turn on Only these hosts can access for extra security. AD Web then accepts requests only on the URLs listed on the Brandings page and rejects all other origins.