Skip to content

Using Subtenancy

Subtenants are managed using the "Settings" UI. For details about this user interface, refer to the Settings documentation.

Example Scenario

Consider a machine builder who sells machines to various customers. The machine builder supports the customers with setting up the machine and doing performance optimizations. These services are typically handled by support personnel on-site, but most of them can be digitized by using Industrial IoT services:
The machine builder can offer digital services like online support, predictive maintenance and remote performance optimization to customers (subtenants). This enables the machine builder to view data collected from the machines at the customer's plant and thus to offer custom applications for visualizations, simple analytics or fleet management.

User Interface Customization

The custom environment links allow you to insert your own legal information (a collection of links) in multiple languages for users of your environment. This ensures that legal requirements of app operators and consumer environment can be met. The legal information is displayed in the OS Bar which is available from all apps and can be accessed by clicking on the tenant logo on the left.

Languages

Custom environment links can be defined in multiple languages. For each language, a set of name-value pairs must be defined. They can be of type www, Phone number or E-Mail.

Regions

On operator environment, regions can be defined and country codes can be added to them. Each country can only be assigned to one region. Developer environment only support the global region with English as default language.

The OS Bar automatically displays the legal links defined for the environment's country. If links are available in multiple languages, the links to be displayed are selected based on the language settings of the user's web browser.

For more information, refer to Customize Launchpad and OS Bar.

Subtenant User Management

Prerequisites

  • You are tenant admin.
  • You have created the User Interface Customization information.

Creating a New Subtenant

  1. Open "Settings" from the Launchpad and click "Subtenants".
  2. Click "Create Subtenant" and fill in the required details.
  3. Click "Create".

Info

For details about the "Subtenants", refer to the section Using subtenants.

Creating a New Subtenant User

  1. Switch to the "Users" tab.
  2. Click "Create User" and fill in the required details.
  3. Select the user type "Subtenant user" and the subtenant.
  4. Click "Create user".

The subtenant user does not have any user permissions yet. These permissions are assigned via user roles as described in the next section.

Info

For details about "Users", refer to User Management.

Assigning the Subtenant Role to a Subtenant User

  1. Switch to the "Roles" tab.
  2. Select the mdsp:core:SubTenantUser role.
  3. Click "Edit assignments".
  4. Select the subtenant user and complete the dialogue.

Info

For details about "Roles", refer to User roles.

Assigning an Asset to the Subtenant

When a subtenant user logs into their environment, they can only see the assets assigned to them. Thus, the "Asset Manager" is empty at first for subtenant users of a new subtenant:

Empty Asset Manager for Subtenant

Tenant admins can assign assets to subtenants as follows:

  1. Open "Asset Manager" from the Launchpad.
  2. Option A: Assign an existing asset to the subtenant.
    • Click on the asset.
    • Click on the asset menu and click "Move asset".
    • Select the root asset for the subtenant and click "Accept". This asset is of type core.basicsubtenant.
  3. Option B: Create a new asset for the subtenant.
    • Click on the root asset for the subtenant.
    • Click "Create asset".
    • Select the asset type, enter all required information and click on "Save".

After assigning the asset to the subtenant, they can inspect it using "Asset Manager":

Asset Manager -- Asset Assigned to Subtenant MyCustomer

Changing the Subtenant Assignment of a Subtenant User

  1. Click "Subtenants" tab.
  2. Select the subtenant.
  3. Click "Assign users".
  4. Select or deselect the subtenant user and complete the dialogue.

Deleting a Subtenant

Attention

If you delete a subtenant, all assigned users are deleted automatically to prevent inconsistent states for users. If you want to keep specific users, assign them to your environment or another subtenant before deleting the subtenant.

  1. Click on the "Subtenants" tab.
  2. Select the subtenant.
  3. Click "Delete subtenant" and confirm.

Be aware that after deleting a subtenant, the associated subtenant root asset (core.basicsubtenant) still exists. This is intentional to avoid confusion with unintended behavior regarding subtenant assets when the subtenant root asset is deleted. The tenant administrator has to either move the assets to another location or delete them before the subtenant root asset can be deleted.

Last update: March 14, 2025

Except where otherwise noted, content on this site is licensed under the Development License Agreement.