This article describes the steps required to manage custom domains in Buttonwood Central.

When a Buttonwood tenancy is created, it is assigned a unique <organisation>.onbuttonwood.net logon domain. Administrators can add additional organisation-owned domains to the tenancy to provide a smoother sign-on experience to users.

Administrators can also configure Buttonwood Central to utilise third-party authentication providers for single sign-on and perform user synchronisation with external identity providers for the configured custom domains.

Prerequisites

• Administrative access to the Buttonwood Central
• Access to check an email mailbox within the domain being added

Viewing Custom Domains

This section describes the steps required to view customs domains which have been created in Buttonwood Central.

Procedure Steps

1. Login to Buttonwood Central
2. Navigate to Manage > Custom Domains
   
3. A list of existing custom domains is displayed
   
   

Adding Custom Domains

This section describes the steps required to add custom domains in Buttonwood Central.

Procedure Steps

1. Login to Buttonwood Central
2. Navigate to Manage > Custom Domains
   
3. Click Add
   
   
4. On the Add Custom Domain screen, enter the domain to be added
   
5. Click Add
6. On the Email Verification Code screen, enter and email address which is able to receive emails to the added domain - a verification email is sent to this address
   
7. Click Send
8. A verification email is sent to the email address specified

Verifying Custom Domains

This section describes the steps required to verify added custom domains in Buttonwood Central.

Custom domains are not active until they are verified. As part of the verification process, an email is sent to a selected email address at the domain. The email contains a code which is used to verify access to the domain.

Procedure Steps

1. Login to Buttonwood Central
2. Navigate to Manage > Custom Domains
   
3. If a verification email was not previously received, use the Email Verification Code option to resend the code
   
4. Click Verify
   
5. Use the verification code from the email to verify the domain
   
6. A message indicates the status of the request
   

Configuring Single Sign-On (SSO)

This section describes the steps required to configure single sign-on for custom domains in Buttonwood Central.

Single Sign-On enables organisations to perform identity management from a single source of truth and streamlines the management of password for users.

With single sign-on is configured, when users enter their username into the Buttonwood Central login screen, Central will recognise that their domain is configured for sign sign-on will redirect to the external identity provider to log in, instead of being authenticated directly by Buttonwood Central.

Note: With SSO configured, users are still prompted to set a local password when activating their account in Buttonwood Central. This password is used if organisation administrators turn off SSO for a domain.

The following articles detail the configuration steps required for each supported third-party identity provider:

• Configuring Single Sign-On (SSO) - Azure Active Directory (AAD)

Removing Custom Domains

This section describes the steps required to delete custom domains in Buttonwood Central.

Procedure Steps

1. Login to Buttonwood Central
2. Navigate to Govern > Cost Centres
   Note: Budgets can also be edited by navigating to Govern > Budgets
   
3. From the drop down menu, select Delete
   
4. On the Delete Custom Domain confirmation prompt, click Delete
   
5. A notification indicates the status of the request