Manage Tenant Configuration

Login to Suite API Docs

In this step you will learn how to receive your tenant information in the IoT Hub.

  1. Open the Suite API Docs: Bosch IoT Hub - Management API in a new browser window.

  2. Login into the Suite API Docs by clicking the Authorize button.

  3. Enter the credentials you have retrieved from the IoT Suite Portal. Please use the Management API credentials. The username will be of the format:

    • manager@YOUR_TENANT or,
    • device-registry@YOUR_TENANT if the service was booked until August 2020.

Get Tenant Configuration

The Tenant configuration has to be managed with the Management API. Receiving the tenant configuration is done by performing a HTTP GET request which contains the tenant information.

  1. In the Management API navigate to the tenant section and select the GET operation.

  2. Press the Try it out button.

  3. Enter your tenant-id in the tenant-id field.

  4. Verify that the request was successful (Code 200).

The output on a successful request should look like this:

{
  "enabled": true,
  "ext": {
    "service-plan": "starter"
  },
  "adapters": [
    {
      "type": "http",
      "enabled": true,
      "device-authentication-required": true,
      "ext": {
        "uri": "https://http.bosch-iot-hub.com",
        "host": "http.bosch-iot-hub.com",
        "port": "443"
      }
    },
    {
      "type": "mqtt",
      "enabled": true,
      "device-authentication-required": true,
      "ext": {
        "uri": "mqtts://mqtt.bosch-iot-hub.com",
        "host": "mqtt.bosch-iot-hub.com",
        "port": "8883"
      }
    }
  ],
  "minimum-message-size": 0,
  "resource-limits": {
    "max-connections": 0,
    "max-ttl": 0,
    "data-volume": {
      "effective-since": "2020-07-06T06:05:32.693Z",
      "max-bytes": 0,
      "period": {
        "mode": "string",
        "no-of-days": 0
      }
    },
    "connection-duration": {
      "effective-since": "2020-07-06T06:05:32.693Z",
      "max-minutes": 0,
      "period": {
        "mode": "string",
        "no-of-days": 0
      }
    }
  },
  "trusted-ca": [
    {
      "subject-dn": "CN=devices,OU=iot,O=ACME",
      "public-key": "Tk9UIEEgUFVCTElDIEtFWQ==",
      "algorithm": "EC",
      "auto-provisioning-enabled": false,
      "not-before": "2019-10-03T13:45:16+02:00",
      "not-after": "2021-10-03T00:00:00Z"
    }
  ]
}