Bosch IoT Device Management

Create a managed 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/insights-booking.png


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


Connections UI

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 HTTP: Template for Bosch IoT Insights, then set a name for your connection, e.g. Bosch IoT Insights.

      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, e.g. insights.

      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 digital twin 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

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

  2. Topics to publish on address:
    Twin events

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

  4. Header mappings:

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

    • content-type ⇾ application/json

Copy your authorization subject (3) 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.


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