Bosch IoT Device Management

Things to Insights connection

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

Bosch IoT Insights

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

Example:

images/confluence/download/attachments/1634788186/bosch-iot-insights-booking.png

Copy the credentials highlighted in the screenshot to your clipboard, as you will need them to create the connection.

Bosch IoT Things

The connection from the digital twin layer to Bosch IoT Insights will be established on the Connections UI.

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

  1. Open the Connections UI
    Your instance is pre-configured with two connections, to allow all messages to be routed and processed at various service layers.

  2. Add a new connection.

    images/confluence/download/attachments/1634788186/add-connection.png
  3. For the Connection category, select Bosch IoT Insights.

    1. Use the drop down and choose Bosch IoT Insights, then set a name for your connection.

      images/confluence/download/attachments/1634788186/insights-connection-02.png
    2. Set the credentials you have received at booking Bosch IoT Insights .

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

      In case you have not copied them locally, look them up at your subscriptions list
      images/confluence/download/attachments/1634788186/bosch-iot-insights-booking.png

    3. Define the Authorization subject. This is already pre-filled and only needs an additional string.

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

      Tip: This subject needs to be set in the policy later on.

    4. Continue.

    5. A summary will be shown as in the example below.
      Click Test connection to make sure your settings are ok.

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

      By default, in section Payload mapping the checkbox Enable normalization of outgoing event payload as thing JSON including contextual data is enabled.

    6. Click Create to approve and close the dialog.

This connection is uni-directional. Thus from the Things perspective, you will only see Targets but not sources.
This means, we will send data TO the Bosch IoT Insights data recorder, but there is no way back.

Details on Target section

In section Targets, you will find

  • The endpoint of your Insights' project
    POST /data-recorder-service/v2/zzXXXX

  • Topics to publish on address:
    Twin events

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

  • Header mappings:

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

    • content-type ⇾ application/json

Copy your authorization subject to your clipboard.

You will additionally need to add the authorization subject integration:{{your-things-service-solution-ID}}:insights
into the policy of the thing which should forward the data recorded towards the Bosch IoT Insights service persistence.