Insights Hub and Industrial IoT Authentication Helper Chrome Extension¶

This chrome extension can be used to simplify the development tasks for which you need to use the SESSION and XSRF-TOKEN to access Industrial IoT APIs. It provides an easy way to copy the Industrial IoT authentication cookies to the clipboard without having to go to chrome developer tools.

Installation¶

Go to Chrome Web Store chrome web store and click on add to chrome.

Once the extension is installed: log in to your Insights Hub tenant, navigate to your application and click on the extension icon to display the available application cookies. You can now click e.g. on session or XSRF button which will copy the corresponding cookie to your clipboard.

The cookies can be used with the tools like curl, postman etc. (Click on the links for more examples)

GET example¶

#!/bin/bash

curl -vv \
  -G \
  --cookie "SESSION=<session-copied-from=browser>;XSRF-TOKEN=<xsrf-copied-from-browser>" \
  -X GET \
  https://<tenantId>-<appId>-<tenantId>.<regionId>.mindsphere.io/api/assetmanagement/v3/assets

PUT example¶

#!/bin/bash

curl -v \
   -X PUT https://<tenantId>-<appId>-<tenantId>.<regionId>.mindsphere.io/api/<puturl> \
  --cookie "SESSION=<session-copied-from=browser>;XSRF-TOKEN=<xsrf-copied-from-browser>" \
  --header "x-xsrf-token: <xsrf-copied-from-browser>" \
  --header "Content-Type: application/json" \
  --data-bin @<your data>

Using the cookies with Insights Hub and Industrial IoT CLI¶

The extension works really well with the Industrial IoT CLI in the Session Cookie - XSRF-Token Configuration because the Bash, PS, and CMD buttons already copy the cookies in the required format for Industrial IoT CLI.

Use the extension to copy the cookies to the clipboard, paste them to the command line and start using the Command Line Interface (CLI) right away.

Using the cookies with Insights Hub and Industrial IoT Development Proxy¶

You can also use the extension to simplify the start of MindSphere Development Proxy in a similar fashion. Just copy/paste the cookies to the command line and start the development proxy.

This will start the development proxy with the credentials of the logged in users so that you can test the Industrial IoT authentication and authorization also in the local environment.

Important: Treat the authentication cookies like your credentials and use them only in secure environments.