Tenants

A Tenant is a silo that contains Identities, App configurations, Account Provider configurations, Role definitions... .
Tenants do not share information. For example, an Identity that exists in Tenant A does not exist in Tenant B. When a user authenticates to two different Tenants, two different Identities are created.

The Identity Hub is multi-tenant out-of-the-box. One installation of The Identity Hub can have as many Tenants as needed.

Note

In the SAAS environment (https://www.theidentityhub.com) everyone can register for a single Tenant. If you need an extra Tenant you need to register again.
In the On-premise and private Azure Cloud scenarios an administrator can create as many Tenants as needed.

Use Cases

Development, Test, Production Tenant

With The Identity Hub there is no need to install three separate instances to support a Development, Test and Production environment (however you can if you want to). Since The Identity Hub is multi-tenant out-of-the-box you can quickly setup three separate Tenants. You create Apps, Account Providers and give permissions, roles... to users in each of the Tenants as you see fit, based on the purpose of the Tenant.

Tenant per Organisation Unit

With The Identity Hub there is no need to install separate instances or go through lengthy procedures to separate the units in you organisation. Since The Identity Hub is multi-tenant out-of-the-box you can quickly setup separate Tenants for each of the units of you organisation. You create Apps, Account Providers and give permissions, roles... to users in each of the Tenants as you see fit, based on the purpose of the Tenant.

Tenant for Internal and External users

With The Identity Hub there is no need to install separate instances to separate the external and internal users. Since The Identity Hub is multi-tenant out-of-the-box you can quickly setup two separate Tenants. You create Apps, Account Providers and give permissions, roles... to users in each of the Tenants as you see fit, based on the purpose of the Tenant.

Registering a Tenant

Everyone can register a Tenant on the SAAS environment (https://www.theidentityhub.com).

  1. Navigate to https://www.theidentityhub.com
  2. Click on Pricing and TRY FOR FREE. You can also immediately navigate here
  3. Fill in your organization name in Organization.
  4. When you tab the URL segment will be filled automatically. You can change it if you want.
    Letters, numbers, - and . are allowed. Start with a letter or a number. A minimum length of 2 characters is required.
  5. Specify your Given Name, Surname and Email address.
  6. Specify a unique Username and a Password and Confirm password.
Note

Password must be at least 12 characters long.
Password must contain one character that is not a letter or a digit.
Password must contain at least one digit.
Password must contain at least one lower case letter.
Password must contain at least one upper case letter.

  1. Complete the ReCaptcha and click Register.
  2. Your Tenant will be created and you will be redirected to the admin site.
  3. You will receive an email with a link to activate your Tenant. If you did not receive the email you can click Send a new activation mail.
  4. Continue on the Getting Started page.

Creating a Tenant

Note

Applies to: On-premise and private Azure Cloud scenarios (not for SAAS www.theidentityhub.com)

As a Hub Admin you can create as many Tenants as needed.

  1. Navigate to the URL of your The Identity Hub installation and sign in as Hub Admin.
  2. In the left navigation click Tenants.
  3. Click on New in the top navigation.
  4. Provide the following information
Parameter Description
Name The name of the Tenant
URL segment The unique URL segment of the Tenant. Letters, numbers, - and . are allowed. Start with a letter or a number. A minimum length of 2 characters is required.
Email address The email address of the Tenant.
Administrator Email address The email address of the administrator of the Tenant.
Telephone number
Address
Welcome Text The text to show on the view where the user selects the Account Provider to authenticate with for this Tenant. For more info see WelcomeText
Plan Type On-premise and private Azure Cloud scenarios choose Enterprise
Email is unique across users
  1. Click Save

Blocking a Tenant

As a Hub Admin you can block a Tenant. Blocked Tenants cannot be used to authenticate. A Tenant can be unblocked at any time.

  1. Navigate to the URL of your The Identity Hub installation and sign in as Hub Admin.
  2. In the left navigation click Tenants.
  3. In the list click on the Tenant you want to block.
  4. Click Block in the top navigation. Click Block again to block the Tenant.

Activating a Tenant

  1. Navigate to the URL of your The Identity Hub installation and sign in as Hub Admin.
  2. In the left navigation click Tenants.
  3. In the list click on the lock icon of the Tenant you want to activate again.

Deleting a Tenant

To completely remove the Tenant you need to first block the Tenant and then delete the Tenant. This cannot be undone and will remove all data within this Tenant.

  1. Navigate to the URL of your The Identity Hub installation and sign in as Hub Admin.
  2. In the left navigation click Tenants.
  3. In the list click on the waste bin icon of the Tenant you want to delete. If the waste bin icon is not visible you need to block the Tenant first.
  4. Confirm that you want to delete the Tenant by clicking Ok.