mindsphere / mindsphere-auth-helper

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

Insights Hub and Industrial IoT Authorization Helper Chrome Extension

MindSphere has evolved into Insights Hub.

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

Installation

Go to chrome web store and click on add to chrome.

Once the extension is installed: log in to your Insights Hub and Indutrial IoT 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)

#!/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

Using the cookies with Insights Hub and Indutrial IoT CLI

The extension works really well with the Insights Hub and Indutrial 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 Insights Hub and Indutrial IoT CLI.

Use the extension to copy the cookies to the clipboard, paste them to the command line and start using the Insights Hub and Indutrial IoT CLI right away.

Using the cookies with Insights Hub and Indutrial IoT Development Proxy

You can also use the extension to simplify the start of Insights Hub and Indutrial IoT 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 Insights Hub and Indutrial IoT authentication and authorization also in the local environment.

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

mindsphere-auth-helper's Issues

Currently, the Extension window is too narrow, no information is displayed

The window is too narrow.

Not sure when this started. Another user and I confirmed the issue.
Chrome:
117.0.5938.152
118.0.5993.71

add delete of auth0 cookies to the auth-helper

Fix the helper so that it can deal with configurable session persistency.

What's new?

Within this release, we have introduced configurable session persistency.

From 1st of September onwards, all the tenants will be created with enabled session persistency. This means that there is no need to re-authenticate when accessing your tenant for up to 36 hours after closing and re-opening your browser. If you wish to change the session persistency behavior of your new tenant, e.g., due to increased security requirements or in settings, where multiple users share a browser, please reach out to our support team with the subject “Session Persistency Configuration Change”. We will then deactivate session persistency for your tenant. This means that you will have to authenticate every time you access your tenant, e.g., after closing and re-opening the browser.

In case you want to change session persistency of your existing tenant, please also reach out to our support. For more information, refer "Session Persistency" in "Settings" documentation.