Bootstrap workflow for devices that belong to a physical device

Physical Devices created in Profiles will have the properties such as model, serial number and manufacturer. Devices created under a physical device will inherit the above properties. Such Devices can be activated in different groups in IoT.

To configure multiple devices that belong to a physical device in bootstrap

Prerequisites for Configuring Devices

1. Create Groups in profiles - GroupA, GroupB
2. Activate Groups(Azure Group Activation/AWS Group Activation) in IoT - GroupA, GroupB
3. Create Physical Device in profiles - PhysicalDevice1
4. Create Device DeviceA1 and associate with GroupA & PhysicalDevice1
5. Create Device DeviceB1 and associate with GroupA & PhysicalDevice1
6. Configure Public Key for DeviceA1 with GroupA & ConnectionContextA1
7. Configure Public Key for DeviceB1 with GroupB & ConnectionContextB1

Note

1. Associate Group with Device: Pass TRN of the group in the query param in the field in
2. Associate Device with Physical Device: Pass TRN of the physical device in the request payload

Device JWT Structure

Devices should create a JWT token with following parameters:

• Model
• Manufacturer
• Serial Number
• Expiry
• CSR (optional)
• ConnectionContext (Optional, but must for activating same device in different groups in IoT)

Note

• Devices which belong to a physical device cannot be activated under the same IoT Group.
• If the physical device contains only one device under it, then the connection context can be ignored.

Important Note to early adopters of Bootstrap Service

Note to early adopters of Bootstrap Service.

ConnectionContext is an optional feature. There will be no impact for early adopters of Bootstrap service, who use just Model, Manufacturer and Serial Number for unique identification of devices. In future, if connectionContext is adopted, ensure to fix(update) any old configurations made in Bootstrap Configurations API using just Model, Manufacturer and SerialNumer with a valid ConnectionContext. Failure to do so, will result in the following error message i.e. “Multiple Devices with given model,mfg and serial number found. Please provide connectionContext”.