This documentation supports the 22.1 version of BMC Helix Single Sign-On, which is available only to BMC Helix customers (SaaS). 

To view an earlier version, select the version from the Product version menu.

Setting up tenants

As a SaaS administrator, to enable the single sign-on experience for a customer company, you must first create a tenant on the BMC Helix Single Sign-On server, and then proceed with the onboarding tasks for this tenant.

Default tenant

The SAAS TENANT is the default tenant, which is available on the BMC Helix SSO server. Only a SaaS administrator has access to this tenant. 

The SAAS TENANT has a predefined name and host, which you cannot modify. You cannot disable this tenant. You can only modify the default description.

To create a tenant

  1. Log in to the BMC Helix SSO server as a SaaS administrator. 
  2. On the navigation panel, click Tenant
  3. Click Add Tenant.
  4. To add a tenant, complete the following fields:
    • Name 
    • Hostname—Specify the hostname to access an individual tenant by using the following format:
    • (Optional) Description
    • (Optional) Self service configuration
      Note: The tenant name and tenant host name must be unique.  
  5. To enable the tenant, select the Enabled check box.
  6. Click Save.

To enable features for a tenant

Use feature flags to enable specific functionalities for a tenant.

  1. Edit or create a tenant for which you want to update the feature flags.
  2. Select the check boxes with the functionalities to be enabled for a tenant.

    The list of the features is as follows:

  3. Click Save.
    The changes are applied automatically for a tenant.

To switch to the Admin Console view of a tenant  

  1. On the List of Tenants page, select a tenant.
  2. Click the pin button.

    An information message is displayed above the navigation panel stating which tenant you have selected:

    The Tenant field on the navigation panel displays the name of the tenant you have switched to.   

Where to go from here

After you have created a tenant, create administrators for this tenant. For information about how to create a tenant administrator, see Setting up BMC Helix SSO administrator accounts.

Was this page helpful? Yes No Submitting... Thank you