Authentication and authorization

Log in

  1. Using your tenant ID, open the Aspect Model Catalog:
    https://catalog.bosch-semantic-stack.com/?tenant=<your-tenant-id>

  2. If prompted, log in to SingleKey ID.
    For more information, see also SingleKey IDexternallink 20.

If you can access the page, you have successfully passed authentication, and should have at least read permission for the Aspect Model Catalog API.

catalog tenantok

The Aspect Model Catalog API follows the patterns you might already know from using the Digital Twin Registry API.

If you do not include your tenant ID in the URL, a dialog will appear and prompt you to choose a tenant. Read more: Tenants

Authentication

Authentication is required with a valid JSON Web Token (JWT) created by an OAuth2 provider.

Currently, the Aspect Model Catalog supports two OAuth2 identity providers:

  • Bosch AD

  • SingleKey ID

Authorization

Authorization is based on the roles a user has been assigned.

Find a detailed description of all roles at Concepts > Authorization.

Tenants

The Aspect Model Catalog enables you to have all your tenants listed, so that you can easily choose and switch between them. You can also add new ones. Additionally, if you do not include your tenant ID in the URL when opening the Aspect Model Catalog, the Select Tenant dialog will pop up, displaying all tenants, which you have accessed.

select tenant

Switch tenant

  1. Click your account information at the upper right corner of the screen.

  2. Select Tenants.

    tenants

  3. Click the tenant you want to use from the Select Tenant dialog.

You can also switch the tenant directly in the URL bar by just deleting the old and pasting the new tenant ID.

Add a new tenant

  1. Click your account information at the upper right corner of the screen.

  2. Select Tenants.

    tenants

  3. Click the Add Tenant button in the Select Tenant dialog.

  4. Fill in the Tenant Id and the Tenant Name and confirm with the Add Tenant button.

    add tenant