> For the complete documentation index, see [llms.txt](https://docs.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.collibra.com/data-quality-self-hosted/admin-configuration/more-admin-settings/multi-tenancy-and-tenant-manager/using-tenant-manager.md).

# Using Tenant Manager

Tenant Manager is a separate DQ application that enables you to manage [multiple tenants](/data-quality-self-hosted/admin-configuration/more-admin-settings/multi-tenancy-and-tenant-manager/enabling-multi-tenancy.md). You can also configure single sign-on (SSO) and Active Directory security for Tenant Manager.

## Logging in to Tenant Manager

Tenant Manager is available only after [enabling multi-tenancy](/data-quality-self-hosted/admin-configuration/more-admin-settings/multi-tenancy-and-tenant-manager/enabling-multi-tenancy.md), and it requires a separate login.

### Steps

{% stepper %}
{% step %}
Sign into Collibra DQ.
{% endstep %}

{% step %}
Click **Sign in as Tenant Manager**, which appears below the **Forgot your password?** link.

![](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-dff2079b6ed79e4052a2e80b4968cfe7ddb8a449%2Fdq-multi-tenant-login-tenant-manager.png?alt=media)
{% endstep %}

{% step %}
On the Tenant Manager login page, enter the username and password provided during your service engagement.

{% hint style="info" %}
You can change the password after logging in to Tenant Manager. Click the user profile icon in the upper right corner and select **Change Password**.
{% endhint %}

![](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-e01231f21885ec1d0529834dec0ec4b333aed74a%2Fdq-tenant-manager-login.png?alt=media)
{% endstep %}

{% step %}
Click **Log in**.\ <i class="fa-chevrons-right">:chevrons-right:</i> The Tenant Management page opens, where you can add, edit, and delete your tenants.

![](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-a4cb46cfa15a0ebc44f5098526206c80a2d7635d%2Fdq-multi-tenant-mgt.png?alt=media)
{% endstep %}
{% endstepper %}

## Adding a tenant

You can add a tenant from the Tenant Management page.

### Steps

{% stepper %}
{% step %}
Click the **+ Add Tenant** button in the top-right corner of the Tenant Management window.\ <i class="fa-chevrons-right">:chevrons-right:</i> The Add a New Tenant modal appears.

![](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-9ab0a3b12e04221fb2e35b49c7d74167fdaad302%2Fdq-multi-tenant-add.png?alt=media)
{% endstep %}

{% step %}
Enter the following information:

* **Tenant Name**: Name for the tenant.
* **Tenant Display Name**: Tenant name that displays in the Tenant Management page.
* **Description**: Description for the tenant.
* **Username**: Username you use when you login to the tenant. This is not required if the tenant is SAML-enabled.
* **Password**: Password you use when you login to the tenant. This is not required if the tenant is SAML-enabled.
  {% endstep %}

{% step %}
To enable the tenant, select the **Enable** box.
{% endstep %}

{% step %}
Click **Save**.\ <i class="fa-chevrons-right">:chevrons-right:</i> The new tenant displays on the Tenant Management page.
{% endstep %}
{% endstepper %}

## Editing a tenant

You can edit a tenant from the Tenant Management page.

### Steps

{% stepper %}
{% step %}
Select the tenant from the Tenant Management page and click the <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-0f75422a3a040d8a7dd29ba4d5490f139ae2d39b%2FAutocompleteVerticalIcon.svg?alt=media" alt="More icon" data-size="line"> icon next to the **Login** button.
{% endstep %}

{% step %}
Select **Edit** from the drop-down.\ <i class="fa-chevrons-right">:chevrons-right:</i> The Edit Tenant modal appears.

![](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-d909df10d588b0198fea079aedb85eb4446bce7e%2Fdq-multi-tenant-edit.png?alt=media)
{% endstep %}

{% step %}
Make the desired changes and click **Save**.
{% endstep %}
{% endstepper %}

## Deleting a tenant

You can delete a tenant from the Tenant Management page.

### Steps

To delete a tenant, on the Tenant Management page, click the <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-0f75422a3a040d8a7dd29ba4d5490f139ae2d39b%2FAutocompleteVerticalIcon.svg?alt=media" alt="More icon" data-size="line"> icon and select **Delete**.

## Configuring SAML security settings

You can add, edit, or delete a tenant's SAML security settings from the Tenant Management page.

### Steps

To configure a tenant's SAML security settings, on the Tenant Management page, click the <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-0f75422a3a040d8a7dd29ba4d5490f139ae2d39b%2FAutocompleteVerticalIcon.svg?alt=media" alt="More icon" data-size="line"> icon and select **SAML Config**. See [SAML Security Settings Overview](/data-quality-self-hosted/security-configuration/saml-authentication/saml-security-settings-overview.md) for more information on configuring the settings.

Once the tenant administrator configures the security settings for the SAML page and updates the configuration with SAML\_TENANT\_MANAGER\_ENABLED=true, credentials are no longer required to add a new tenant.

## Mapping roles to tenants

You can map roles to tenants from the Tenant Management page.

### Steps

To map roles to tenants, on the Tenant Management page, click the <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-0f75422a3a040d8a7dd29ba4d5490f139ae2d39b%2FAutocompleteVerticalIcon.svg?alt=media" alt="More icon" data-size="line"> icon and select **Role Mapping**. See AD Group to Role Mapping for more information on mapping roles.

## Signing into a tenant

You can select a tenant from a drop-down list on the main Collibra DQ login page.

### Steps

{% stepper %}
{% step %}
Sign into Collibra DQ.
{% endstep %}

{% step %}
Enter your username and password credentials.
{% endstep %}

{% step %}
Select your tenant from the Select Tenant drop-down list, which lists the tenants in alphabetical order.

![](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-9ad5f6f4e9c1d63b8f15b93bf8aeb3bf7058cfb2%2Fdq-multi-tenant-login.png?alt=media)

{% hint style="info" %}
All enabled tenants will display in the Select Tenant drop down list. Access to tenants are handled by the administrator(s) within each tenant individually.
{% endhint %}
{% endstep %}

{% step %}
Click **Sign in**.

{% hint style="info" %}
If you haven't registered as a Collibra DQ user, click the **Register** link, which displays under the **Sign in as Tenant Manager** link and complete the registration form.
{% endhint %}
{% endstep %}
{% endstepper %}

## Configuring security settings

Tenant Manager supports the following security options:

* Single-sign-on (SSO). For more information, go to [Configuring SSO for Tenant Manager](/data-quality-self-hosted/admin-configuration/more-admin-settings/multi-tenancy-and-tenant-manager/configuring-sso-for-tenant-manager.md)
* Active Directory. The Active Directory configuration options for Tenant Manager are identical to the settings provided for the DQ Application. For more information, go to [AD and LDAP Security Settings Overview](/data-quality-self-hosted/admin-configuration/admin-console/user-management/ad-security/ad-and-ldap-security-settings-overview.md).
