Migrate to v5

Bosch Semantic Stack v5 is here! See also Release notes.

Breaking changes for Digital Twin Registry and Aspect Model Catalog
Since Bosch Semantic Stack v5:
API calls must use the new target client ID.
The web applications (UIs) have a new URL.

New target client ID for the APIs

Your existing API calls towards Digital Twin Registry and Aspect Model Catalog must now use the new target client ID.

About target client IDs

The target client ID is set as a part of API requests. This is necessary for accessing the REST APIs with authentication at the Access Management portal (aka MACMA).

For more details, refer to: Authentication

With v5, the target client ID has changed.

Update your API requests with the new target client ID

The new target client ID to define the scope for the required token (JWT) is:

i2zkcq1li0ps1pjh62gjj1892

For comparison, the old target client IDs were:

  • Digital Twin Registry: bqfin42m7vho1k7r2srjrge28

  • Aspect Model Catalog: q8f6z22otkd7137qlsykwckuc

The full new scope value—​including the new target client ID—​is:

aud:i2zkcq1li0ps1pjh62gjj1892 openid

Ensure that the new target client ID is used for your API requests:

  1. Review current implementations
    Identify all applications and services that utilize the current target client ID in their JWTs.

  2. Update your code
    Modify your code to accommodate the new target client ID. Ensure that any references to the old target ClientID are updated accordingly.

  3. Documentation
    Update any internal documentation to reflect the change in the target client ID and the date of the update.

  4. Monitor for issues
    After the change is implemented, monitor your applications for any unexpected behavior or issues.

New URL for the web apps (UIs)

New URL for the web applications (UIs) for Digital Twin Registry and Aspect Model Catalog:

https://workspace.bosch-semantic-stack.com/?tenant=<your-tenant-id>

Note that, in the URL, <your-tenant-id> must be replaced with your tenant ID. See also Your tenant’s workspace.

Consider to:

  • Update your bookmarks or saved links to reflect the new URLs

  • Inform your team: Share this information with your team members who may be using these applications.

The table below lists the new and old URLs for comparison:

Table 1. URLs for the web applications
Web application New URL (v5) Old URL (v4)

Digital Twin Registry

https://workspace.bosch-semantic-stack.com/?tenant=<your-tenant-id>

https://registry.bosch-semantic-stack.com/?tenant=<your-tenant-id>

Aspect Model Catalog

https://workspace.bosch-semantic-stack.com/?tenant=<your-tenant-id>

https://catalog.bosch-semantic-stack.com/?tenant=<your-tenant-id>

Support

If you have any questions or require assistance during this transition, please do not hesitate to reach out:
support.semantic-stack@bosch.com

We are here to help you ensure a smooth update process. Thank you for your attention to this important matter.