Provision your ConnectCore device with Digi Remote Manager to enable cloud-based management, monitoring, and control. Registering your device is essential to access all ConnectCore Cloud Services features, including remote configuration, firmware updates, and real-time insights.

Use one of the following methods to provision your device:

ConnectCore Quick Setup mobile application

The Digi ConnectCore Quick Setup mobile application guides you through the provisioning process.

Step 1: Install the ConnectCore Quick Setup application

  1. Install the Digi ConnectCore Quick Setup app in your smartphone. You can find it in both the Apple and Google Play app stores:

Step 2: Launch provisioning

  1. Open the ConnectCore Quick Setup application.

  2. Tap Provision devices on the home page.

  3. Enter your Digi Remote Manager credentials when prompted.

Step 3: Add devices to provision

After logging in, an empty list of devices appears. Tap Add devices to choose how to add devices:

Scan QR code

  1. Open the QR code scanner.

  2. Adjust camera settings, such as zoom and torch light.

  3. Point the camera at the device’s QR code.

  4. Scan the QR code.

  5. Upon scanning:

    • The device vibrates and emits a sound.

    • A popup dialog confirms the scanned device.

    • The device is added to the list.

  6. Tap Add devices to move scanned devices to the provisioning list.

Enter device information manually

  1. Open the manual entry screen.

  2. Enter:

    • Device MAC Address

    • Install Code (Optional) - 12-digit device serial number.

  3. Tap Add device to add it to the list.

Load devices from file

  1. Select a CSV file from your device storage.

  2. Ensure the file follows this format:

    <DEVICE_ID_1>,<INSTALL_CODE_1>
<DEVICE_ID_2>,<INSTALL_CODE_2>
...
<DEVICE_ID_N>,<INSTALL_CODE_N>

  3. Load the file to populate the device list.

Step 4: Provision devices

  1. Tap Provision devices to register them in your Digi Remote Manager account.

  2. Optionally:

    • Save the list by tapping Save.

    • Clear the list by tapping Clear.

If provisioning fails, a popup displays failed devices and error messages. Successfully provisioned devices are removed from the list, while failed ones remain for further attempts.

Digi IoT Mobile SDK

Use the Digi IoT Mobile SDK to provision devices from a custom mobile application.

Key features

  • Seamless integration with Digi Remote Manager.

  • Secure device provisioning.

Get started

  1. Refer to the Digi IoT mobile SDK documentation for setup instructions.

  2. Review the Digi Mobile SDK API reference for provisioning API details.

  3. Implement the necessary API calls in your application.

Digi Remote Manager APIs

Follow these steps to provision devices programmatically using Digi Remote Manager REST APIs.

Step 1: Prepare the authentication header

Obtain an authentication token from Digi Remote Manager before making any requests. Use either Basic Authentication (username and password) or a Bearer token.

For Basic Authentication, include the Authorization header with your credentials encoded in Base64:

Authorization: Basic <base64-encoded-credentials>

For Bearer Authentication, retrieve a token from Digi Remote Manager and include it in the request:

Authorization: Bearer <your-access-token>

Step 2: Prepare the request body

Create a JSON object that lists the devices you want to provision. The request body must follow this format:

{
  "devices": [
    {
      "id": "00000000-00000000-00000000-XXXXXXXX",
      "installCode": "123456789012",
      "name": "Device_1",
      "group": "MyDevicesGroup"
    },
    {
      "id": "00000000-00000000-00000000-YYYYYYYY",
      "installCode": "123456789012",
      "name": "Device_2",
      "group": "MyDevicesGroup"
    }
  ]
}

Step 3: Send the provisioning request

Set up the request by configuring the authentication header and request body. Then, send an HTTP POST request to Digi Remote Manager using the following endpoint:

POST https://remotemanager.digi.com/ws/v1/devices

Step 4: Handle the response

Review the response to verify the provisioning results. The response contains a list of devices and their provisioning status following this format:

{
    "count": 2,
    "list": [
        {
            "error_status": 403,
            "error_message": "Invalid access to data - it is not owned by this customer.",
            "error_context": {
                "customer_id": 0001,
                "id": "00000000-00000000-00000000-XXXXXXXX",
                "name": "Device_1",
                "in_maintenance_window": "yes",
                "install_code": "123456789012",
                "authenticated_connection": false,
                "group": "MyDevicesGroup"
            }
        },
        {
            "channels_uri": "/ws/v1/devices/channels/00000000-00000000-00000000-YYYYYYYY",
            "metrics_uri": "/ws/v1/devices/metrics/00000000-00000000-00000000-YYYYYYYY",
            "name": "Device_2",
            "customer_id": 0001,
            "type": " ",
            "connection_status": "disconnected",
            "id": "00000000-00000000-00000000-YYYYYYYY",
            "restricted_status": "unrestricted",
            "maintenance_mode": "off",
            "firmware_status": "not_identified",
            "health_status": "unknown",
            "in_maintenance_window": "yes",
            "authenticated_connection": false,
            "group": "MyDevicesGroup",
            "management_uri": "/ws/v1/devices/management/00000000-00000000-00000000-YYYYYYYY"
        }
    ]
}
For more information, refer to Digi Remote Manager API Reference