What's New?¶
REST API URL changes in Xcelerator¶
The Insights Hub APIs are accessible using different URLs in Xcelerator.
The following table shows the key differences between Insights Hub and Xcelerator URL patterns for accessing various services:
| Segment | Insights Hub | Xcelerator |
|---|---|---|
| Domain | https://gateway.eu1.mindsphere.io | https://api.eu1.siemens.app |
| Base URL | /api/iottsaggregates/v4 | /api/iottsaggregates-1000001700/v4 |
Limitations¶
In Xcelerator, API requests that do not honor the following limits will be rejected and apply to both request and response.
| Type | Maximum Size | Requirement |
|---|---|---|
| File size | 10MB | Use multipart upload for larger files (see Insights Hub API documentation for details) |
| Header size | 10KB | Keep header content within this limit |
Identifier representation in APIs¶
Asset type, Aspect type, and Event type IDs have a prefix. Previously, the recommended prefix for these types was the tenant ID. The new recommendation is to use the tenant name instead. This change ensures that the identifier values of existing types remain unchanged.
In addition, the API to get tenant information has been enhanced to get both Tenant Id and Tenant name
| Area | Behavior |
|---|---|
typeId values | Continue to use the tenant name as the prefix |
| Tenant information | Expose tenant name and tenant ID as separate values where applicable |
| Example | Value |
|---|---|
Tenant name-based typeId | ihmgsi51.testType |
| Xcelerator tenant ID | 1000000351 |
This means the visible identifier format remains tenant name-based, while the tenant ID is available separately for identification purposes.
Identity and Access Management¶
Authorization Server¶
The Xcelerator OAuth endpoint is available at https://1000001700.eu1.sws.siemens.com/oauth.
Access Token structure¶
Following table highlights the key differences between IH and Xcelerator token claims:
| Field | IH Token (mindsphere.io) | Xcelerator Token (sws.siemens.com) |
|---|---|---|
| Tenant ID claim | ten | sws.samauth.ten |
| Tenant ID format | 8-char string, e.g. triadiot | 10-digit number, e.g. 1234567890 |
| Subtenant | subtenant claim in JWT | user_groups → mdspiam:subtenant:<id> |
| JWKS endpoint | core.piam.eu1.mindsphere.io/oauth/token_keys | eu1.sws.siemens.com/token_keys |
Tenant Representation¶
Both existing IH token and new Xcelerator structures contain tenant identifiers in different claims. In addition, identifiers representing the same consumer tenant differ across systems.
| Segment | Tenant ID | Tenant Name |
|---|---|---|
| IH | 8-character "triadiot" | 8-character "triadiot" |
| Xcelerator | 10-digit "1234567890" | 8-character "triadiot" |
Subtenancy¶
Information about the subtenant to which the user belongs is available under a different claim.
In the token generated by Insights Hub IAM, subtenant information is available in the subtenant claim:
"cat": "user-token:v1",
"subtenant": "subtenant12345"
In the token generated by Xcelerator IAM, subtenant information is embedded in the user_groups claim:
{
"user_groups": [
"companyAdmin",
"TestEngineer",
"mdspiam:subtenant:subtenant12345"
]
}
Except where otherwise noted, content on this site is licensed under the Development License Agreement.