Bosch IoT Device Management - will be discontinued by mid 2024

Create a managed connection to Bosch IoT Insights

This section describes how to create a new connection from your Bosch IoT Device Management instance to your Bosch IoT Insights instance.

Prepare your Bosch IoT Insights service instance

If you do not have one yet, book a Bosch IoT Insights service instance via the Bosch IoT Suite UI>Subscriptions.

A free plan is sufficient for this example.

As a result, you will receive credentials for access to the service.

  • To see the credentials, select the respective Insights subscription on the list of subscriptions and open the Binding credentials blade.

  • Copy the project, username and password values to your clipboard, as you will need them when creating the connection.

images/confluence/download/attachments/1634788186/insights-credentials.png


Create a new connection

To create a connection from the digital twin layer of Bosch IoT Device Management to Bosch IoT Insights, open Connections from the left navigation.

If it is not visible on the left navigation, search for it in Services and features and use the star icon to pin it to the main menu.

images/confluence/download/attachments/1634788186/connections-ui.png


Your service instance has two pre-configured connections, which allow all messages to be routed and processed at various service layers.

You can see them on the list of connections on the left.

  • Click Add to create a new one.

images/confluence/download/attachments/1634788186/add-connection.png

On the first dialog of the wizard:

  • Open the Connection category dropdown and select HTTP: Template for Bosch IoT Insights.

  • Enter a Connection name, e.g. Bosch IoT Insights.

  • Click Continue.

    images/confluence/download/attachments/1634788186/insights-connection-wizard-1.png

On the next dialog of the wizard:

  • Enter the credentials - project ID, username and password - of your Bosch IoT Insights instance, which you copied earlier.

  • Click Continue
    images/confluence/download/attachments/1634788186/insights-connection-wizard-2.png


On the next dialog of the wizard:

  • Define the Authorization subject.
    This is already pre-filled and only needs an additional string, e.g. insights.

  • Click Continue
    images/confluence/download/attachments/1634788186/insights-connection-wizard-3.png


You will see a preview of your connection details in four expandable categories:

  • General

  • Coordinates

  • Targets
    Find more details below.

  • Payload mapping
    In this section, the checkbox for Enable normalization of outgoing event payload as thing JSON including contextual data is enabled by default.

Your connection is not saved yet.

  • Click Test connection to make sure your settings are properly entered.

  • Click Create to approve and close the dialog.

You can check and edit the connection details at any time.

images/confluence/download/attachments/1634788186/test-connection.png

Targets

This connection is uni-directional, which means that you can only send data to the Bosch IoT Insights data recorder, but will not receive data from it.

Thus from the digital twin perspective, you will only see Targets but not sources.

In the Targets section, you will find:

  1. The endpoint of your Insights project
    POST /data-recorder-service/v2/zzXXXX

  2. Topics to publish on address:
    Thing twin events

  3. The Authorization subject
    integration:{{your-things-service-solution-ID}}:insights

    Copy this authorization subject or remember to find it here later on. You will have to add it to the policy of the device which should forward the recorded data to the Bosch IoT Insights service instance.

  4. Header mappings:

    • X-Metadata ⇾ thingId={{ thing:id }}

    • content-type ⇾ application/json

images/confluence/download/attachments/1634788186/insights-connection.png