All Products
Search
Document Center

IoT Platform:Create a product and a device

Last Updated:Oct 31, 2023

To connect a device to IoT Platform, you must create a product, add a device to the product, and then obtain the device certificate in the IoT Platform console. The certificate information includes the ProductKey, DeviceName, and DeviceSecret.

Background information

  • A product is a collection of devices with the same features. You can manage the devices of a product at the same time. For more information, see Define TSL models and Custom topics.

  • Each physical device must correspond to an IoT Platform device. You must burn a device certificate that is issued by IoT Platform to a device. The device certificate includes a ProductKey, a DeviceName, and a DeviceSecret. When you connect the device to IoT Platform, you can use the certificate to verify the device. For more information, see Obtain device certificates.

This topic describes how to create a product, add a device, and obtain a device certificate in the IoT Platform console if you want to connect a street lamp device to IoT Platform.

Procedure

  1. Log on to the IoT Platform console.

  2. In the upper-left corner of the IoT Platform console, select the region where the IoT Platform instance resides.

  3. On the Overview tab, click Public Instance.

    Important

    If IoT Platform is activated in the China (Shanghai), Singapore, Japan (Tokyo), or US (Virginia) region, perform this step. If IoT Platform is activated in other regions, skip this step.

  4. In the left-side navigation pane, choose Devices > Products. On the page that appears, click Create Product.

  5. On the Create Product page, configure the parameters and click OK.

    In this example, the Product Name parameter is set to streetLight, and the default values are used for other parameters, as shown in the following figure.新建产品(国际)

  6. On the Create Product page, click Add.

  7. On the Device List tab, click Add Device. Set the DeviceName and Alias parameters to device1, and then click OK.

    For more information, see Create a device.

    创建设备

    In the The devices have been added dialog box, click Copy Device Certificate to obtain the device certificate.

    You can also click Learn More. On the Device Details page, click View next to DeviceSecret to obtain the device certificate.

    A device certificate includes a ProductKey, a DeviceName, and a DeviceSecret. A device certificate is the credential that a device uses to communicate with IoT Platform.

    Important

    We recommend that you copy information about your device certificate and keep the information in a secure location. The device certificate is required when you connect the device to IoT Platform.

    Parameter

    Description

    ProductKey

    The ProductKey of the product to which the device belongs. The ProductKey is the GUID that is issued by IoT Platform to the product.

    DeviceName

    The DeviceName of the device, which is the unique identifier of the device within the product. A combination of the DeviceName and ProductKey is used as the device identifier. IoT Platform authenticates the device and communicates with the device based on the device identifier.

    DeviceSecret

    The DeviceSecret of the device, which is issued by IoT Platform for device authentication and encryption. The DeviceSecret must be used in combination with the DeviceName.

What to do next

Define a TSL model for a product.