Configuring a custom Bosch IoT Things service instance

If you have a project with a large amount of devices, it is recommended to configure your own Bosch IoT Things service instance within Bosch IoT Insights.

Proceed as follows

1. Activate the Custom Bosch IoT Things service instance checkbox to configure your Bosch IoT Things service instance within Bosch IoT Insights.
   

   

2. In the Things Service Instance pane, add the following information of your Bosch IoT Suite subscription.

   1. In the Bosch IoT Things Location drop-down list, select the location of your Bosch IoT Things service instance.

   2. If you selected AWS Frankfurt (EU-1) in the Bosch IoT Things Location drop-down list, the checkbox Enable Device Provisioning for creating and deleting devices is displayed.

      If you activate the Enable Device Provisioning for creating and deleting devices checkbox, the Device Provisioning API of the Device Management Package will be called when a device is created or deleted. That means that the data is sent to the Device Management Package endpoint.

      Changing the Bosch IoT Things Location may delete all your existing devices. Contact the Bosch IoT Insights' support team if you want to proceed with this change.

   3. In the Solution ID field, enter the Solution ID.

3. In the OAuth2 Client pane, add the following information of your OAuth2 client.

   The OAuth2 Client needs the scope of the Bosch IoT Things service instance you just created to access the service instance.

   1. In the OAuth2 client name field, enter the client name of your OAuth2 Client.

   2. In the OAuth2 client ID field, enter the Client ID.

   3. In the OAuth2 client secret field, enter the client secret.

   4. In the OAuth2 client scope for Bosch IoT Suite Services field, enter the client scope of your Bosch IoT Things service instance which starts with service:iot-things.

   5. In the OAuth2 client scope for Bosch IoT Insights field, enter the client scope of your Bosch IoT Insights service instance.

   6. Click the Assign to OAuth2 client button to update the Bosch IoT Insights' scope.
      → The OAuth2 client update page in the Bosch IoT Suite Portal is displayed in a new tab.

   7. Click Update to save the Bosch IoT Insights' scope for your OAuth2 client.

   8. Close the tab.

4. In the Namespace pane, add the following information of the Bosch IoT Things subscription.

   When you book a Bosch IoT Things service instance, you receive a solution. Within this solution, you can create namespaces. This has to be done on the IoT Things Dashboard or via the corresponding API. A namespace is required to use Bosch IoT Things with Bosch IoT Insights. Your Things will reside within this namespace. Example: com.example.myns.

   Find the detailed concept in the Namespace chapter of the Bosch IoT Things documentation.

   1. In the Namespace field, enter the namespace which you created in your Bosch IoT Things service instance.

   2. In the Default Policy ID field, enter the Default Policy ID, the namespace, and add :default as Policy ID, e.g. dev.test:default.

5. Click the Switch to Custom or Save button.
   → The custom Bosch IoT Things service instance has been configured.

6. Wait approximately 5 minutes before reloading the browser and testing the creation of new devices in your namespace using Bosch IoT Insights.

Check the project configuration

Make sure you have set the valid credentials for your Bosch IoT Things instance booked with the Bosch IoT Device Management.

Check the Suite OAuth Client

The OAuth Client should now hold additionally the Insights entry.