| Error | Details |
|---|
| 401 | Unauthorized - The access token was not included in the API call. |
| 403 | Forbidden - The object is not accessible to the client Identity performing the request. This error is often seen when you are not using the correct endpoints. Please make sure you are using the correct endpoint listed in the grant flow. The most common version of this is using /token vs /oauth/token. |
| 404 | An object with the specified ID was not found. |
| 5XX | The server failed to fulfill a request. This is a system level issue. It may be intermittent and resolved after a retry. |
To ensure seamless access to Trimble Identity (TID), please ensure the following domains are unblocked in your firewall settings:
| Concept | Details |
|---|
| Data Residency | Data residency refers to the physical or geographic location of a user or organization’s data or information. With Trimble ID, users can select their data region where their Trimble ID information is stored, and applications can retrieve the users’ data storage region preference from the id and access tokens. |
| Grant Types | Grants are the means of retrieving an access token. OAuth2.0 defines different workflows to obtain an access token. |
| Federation | Federation is a type of secure log-in where a user’s single authentication ticket, or token, is trusted across multiple IT systems or even organizations. |
| Internationalization | End users can define personal language preference for rendering UI, email, or any other communications sent to them. |
| JWK | JSON Web Keys (JWK) sets are used to validate the signature and the authenticity of a token. This is provided by Trimble Identity. |
| JWT | JSON Web Token (JWT) is a standard for securely transmitting information between parties. For example, id_token is a JWT. |
| Multi-Factor Authentication | Multi-factor authentication (MFA) provides a method to verify a user’s Identity by requiring them to provide more than one piece of identifying information. This ensures that only valid users can access their accounts. |
| Social Account Login | Trimble Identity also allows users to sign in using their existing social account IDs like Google and Apple. |
| Supported Protocols | Trimble Identity currently supports OAuth2.0 & Open ID Connect. |