Features
Integrations

Integration with HxDR

HxDR platform offers cloud native smart and autonomous digital twins capabilities integration with its powerful API.

HxDR can be used by external partners on these endpoints:

UAT is the first integration where partners has the possibility to connect and try their integration without being exposed in a live environment. PROD is our public available endpoint.

Connect to HxDR

In order to be able to communicate with HxDR it is necessary to be able to generated Bearer tokens for the users. In order to generate these token an external partner need to require the Client credentials.

These credential allow the client of the external partner to be able to speak with our IDP. This credential must be requested using the group list:

hxdr_integrations@Hexmet.onmicrosoft.com

In the request must be clearly state the name of the client/project that is needed. The HxDR team will take care to answer in a timely manner with the following information:

  • Client Id to use for the authentication process.
  • O-auth2 endpoint

Communicate with HxDR

Once the Bearer token has been obtained with the previously illustrated mechanism and protocol, every http GET or POST must contain the Bearer token in the Headers of the requests.

If no token is found the system threats the request as anonymous with all the limitation of the case

{
  "authorization": "Bearer eyJz9sdfsdfsdfsd..............."
}

To successfully execute a request on HxDR GraphQL playground, See following :

Use the Application

In order to try something on HxDR it is necessary to register to the platform. The registration on UAT is firewalled and a mail to the hxdr_integration group has to be sent and the team will register a mail.

On the request is necessary to indicate the mail that is wanted and the name.

The team will answer with the pair username/password that than can be used.

Summary

  • Ask for a HxDR account.
  • Request for your App ClientID.
  • Choose Authentication workflow.
  • Authenticate using selected auth flow and obtain bearer token.
  • Use HxDR graphql api with the bearer token as authorization header for every graphql request.
  • Access all cpabilties of HxDR platform using the API.

How to use HxDR GraphQL API ?

JS-SDK reference

  • Core

    Internal shared SDK helpers and utilities

  • Config

    Global application configuration container and validation

  • Connect

    Idiomatic approach to interfacing with the HxDR GraphQL API