Removing Tenants

To completely remove a tenant, you must consider all the Stellar Cyber objects they own, such as charts, reports, dashboards, connectors, and so on, need removal at the same time. Certain items must be manually disabled or cleared before you can remove the tenant. Use the procedure in this topic as a guide.

  1. Unauthorize tenant sensors.
  2. Clear the tenant database.
  3. Remove tenant users.
  4. Delete the tenant from tenant groups.
  5. Remove associated tenant objects.
  6. Delete the tenant.

Unauthorizing Tenant Sensors

You must unauthorize any sensors sending data to the DP for the tenant:

  1. Select System | DATA SOURCE MANAGEMENT | Sensors | Sensors.

    The Sensors list appears.

  2. To narrow down the list to only sensors assigned to a single tenant, select the Tenant drop-down list at the top-right of the page and select the tenant.

  3. Select the Manage drop-down menu.

  4. Select Authorization.

    The AUTHORIZE SENSORS panel appears.

  5. Select Unauthorize.

    The screen changes to display the authorized sensors you can unauthorize.

  6. Select the sensors you want to unauthorize and then click or tap the Add arrow.

    The selected sensors are added to the Selected Sensors list.

  7. Select Submit.

    The sensors are unauthorized, but data might still be ingested as the queue is emptied.

  8. Refresh the Sensors list until the icon appears in the Authorization column.

Clearing the Tenant Database

After the sensors stop sending data and the icon appears next to the sensors, you can clear the tenant database:

  1. Select System | DATA MANAGEMENT | Data Management and then select the Advanced tab.

  2. In the Clear Database Indices section, select the tenant from the Select a Tenant drop-down list.

  3. Select both Records and Assets.

  4. Select Clear Database.

    All data for that tenant is immediately deleted.

Removing Tenant Users

Before you can delete the tenant, you must remove all tenant users:

  1. Select System | ORGANIZATION MANAGEMENT | Users.

    The Users table appears.

  2. Select the Tenant Name column heading.

    The table is now sorted by tenant, so you can easily find the users for the same tenant. You can either delete the users or assign them to different tenants.

  3. To delete the users:

    1. Select the button to delete the corresponding user.

      The user is immediately deleted.

    2. Repeat until you delete all the users for this tenant.

  4. To assign the users to different tenants:

    1. Select the button to edit the user.

      The EDIT EXISTING USER screen appears.

    2. Choose a different tenant from the Tenant drop-down list and then select Submit.

    3. Repeat until you reassign all the users for this tenant to another tenant.

Deleting Tenants from Tenant Groups

If the tenant was a member of a tenant group, you must remove it from that group:

  1. Select System | ORGANIZATION MANAGEMENT | Tenant Groups.

    The table of tenant groups appears.

  2. Select the button for the tenant group to which the tenant you want to delete belongs.

  3. Select next to the tenant in the Added Members list and then select Submit to delete it from the group.

Removing Associated Tenant Objects

Before you delete a tenant, make sure you remove any of the objects belonging to the tenant in the procedure below. This way, Stellar Cyber won't generate an error message regarding custom objects remaining when you delete the tenant in the next section:

  1. Navigate to Dashboards | CREATION | Dashboards and delete any dashboards belonging to the tenant to be deleted.

    If you want to keep the settings of a tenant-assigned dashboard, you can open the dashboard and use the Export | Export as Configuration feature to save the dashboard settings with a tenant assignment of All Tenants before deleting the tenant's version.

  2. Navigate to System | Saved Objects | Charts and delete any charts belonging to the tenant to be deleted.

    You can sort the list by Tenant name to make it easy to see all charts belonging to the same tenant.

  3. Each of the following entries in the System menu can include custom objects belonging to the tenant to be deleted. Go to each of the following pages, sort the resulting table by Tenant name, and delete all listed objects belonging to the tenant:

    • System | Saved Objects | Queries and Filers

    • System | Recipients

    • System | Saved Objects | Saved Scripts

    • System | Tags

    • System | Saved Objects | Lookups

Deleting Tenants

After all sensors are unauthorized, users and custom objects are removed, and the tenant is deleted from tenant groups, you can delete the tenant:

  1. Select System | ORGANIZATION MANAGEMENT | Tenants.

    The table of tenants appears.

  2. Select to delete the tenant.

    The tenant is immediately deleted.