Tenant management
Access the Tenant management screen by selecting Tenant management from the navigation panel on the left-hand side of the self service portal.
The Tenant management screen enables the following functionalities:
Create a new tenant
Once a tenant is created, its deployment model and environment cannot be updated. If you need help with determining what is the correct configuration for your tenant, please contact our sales and support team.
Perform the following instructions to create a new tenant:
Select the CREATE/SWITCH TENANT button on the top-right side of the screen.
The All tenants window is displayed, listing any existing tenants.
Select CREATE NEW TENANT.
The New tenant form is displayed.
Use the Deployment Model radio button to choose between Public or Private Cloud.
Use the Region dropdown list to select the region your tenant is hosted in.
Use the Tenant name text box to insert a meaningful name for your tenant.
Use the Tenant subdomain text box to insert your tenant's subdomain.
This subdomain is appended to your selected region to construct the URL that will be used to access your tenant.
Tenant subdomains can only include alphanumeric characters (a-z, 0-9) and hyphens.
Select the CREATE button to create the new tenant.
The new tenant is created and you are navigated back to the Tenant management screen.
Click the Clients tab.
Make note of the Client secret and record it somewhere safe.
Note: The client secret is required for making any request to the tenant, and is only available on this tab after the initial tenant creation.
You can also access the New tenant form by selecting Create new tenant from the tenant drop-down list on the top-left corner.
View tenant information
The Tenant management screen displays information regarding the currently selected tenant (refer to Switch the selected tenant to learn how to switch it). The information is displayed in two different tabs (click a tab title to display it):
General:
Tenant name: As defined when the tenant was created.
Tenant domain: This field is a combination of the tenant subdomain and region that were inserted when the tenant was created.
Each region has a corresponding URL that is appended to the subdomain to create the tenant domain.
You can copy the tenant domain to your clipboard by selecting the COPY button on the right hand side.
Deployment model: As selected when the tenant was created.
Region: As selected when the tenant was created.
Clients:
Client ID: Automatically generated unique identifier. The Client ID is sent alongside the Client secret to the Token URL to retrieve an access token that is used to authenticate with this tenant.
You can copy the Client ID to your clipboard by selecting the COPY button on the right hand side.
Client secret: Automatically generated client secret. The Client Secret is sent alongside the Client ID to the Token URL to retrieve an access token that is used to authenticate with this tenant.
The Client secret is only displayed on this tab after you initially create a tenant, so it is important to make note of it when completing the creation process.
Token URL: The Client ID and Client secret are sent to this URL to retrieve an access token that is used to authenticate with this tenant.
You can copy the Token URL to your clipboard by selecting the COPY button on the right hand side.
You can also access the tenant information screen by selecting Tenant information from the tenant drop-down list in the top-left corner.
Switch the selected tenant
The Tenant management screen displays information regarding the currently selected tenant. To switch the selected tenant:
Select the CREATE / SWITCH TENANT button.
The All tenants window is displayed, listing any existing tenants.
Select the SWITCH button next to the tenant you wish to switch to.
The selected tenant is indicated by a Current selection label and a blue tick.
You can also access the switch tenant window by selecting Switch tenants from the tenant drop-down list in the top-left corner.
Delete tenant
Tenant deletion is permanent and cannot be reversed.
Perform the following steps to delete an existing tenant:
Switch to the tenant you wish to delete (refer to Switch the selected tenant above).
The tenant information is displayed.
Select the DELETE button at the bottom of the screen.
The Delete tenant form is displayed, prompting you to type the tenant's subdomain before approving the deletion.
Type the tenant subdomain and select the YES, DELETE button to delete the tenant.