Manage Credentials

Login to Suite API Docs

A device in the Bosch IoT hub can have multiple credentials associated with it. They act as a proof of identity with the IoT Hub during the connection establishment.

We recommend to open the Suite API Docs for the Device Registry in a new browser window:

Suite API Docs: Device Registry

First login into the Suite API Docs by clicking the Authorize button. Please enter the credentials you have retrieved from the IoT Suite Portal. Please use the device-registry credentials. The username will be of the format device-registry@YOUR_TENANT.

Add Device Credentials

Credentials are required to authenticate your device with the IoT Hub. Credentials can also be managed with the Device Registry. Adding device credentials is done by performing a HTTP POST request which contains the credentials information.

Note: For security reasons credentials are stored in IoT Hub in hashed format, as defined with the type field (“type”: “hashed-password”, see examples below).

  1. Navigate to the credentials section and select the POST operation.
  2. Press the Try it out button.
  3. Enter your tenant-id in the tenant-id field.
  4. Adapt the device-id field of the request to match the device created in the previous step.
  5. For password credentials, the auth-id property will be the username that will be used to authenticate for device connectivity.
  6. To create a password secret, which will be used by a device to authenticate itself with the Bosch IoT Hub, please create a strong password (e.g. at least 8 characters combining letters, numbers and special characters). Please note that you will need the password you have created later on, for example for authenticating your device in order to send messages to IoT Hub. For the security reasons the IoT Hub only stores passwords in a hashed format internally. Provide the plaintext password string in the password field. Bosch IoT Hub will add salt and hash it. An example is provided in the Suite API documentation.
  7. Verify that the request was successful (Code 201).