：裝置認證

認證方式

• 一機一密：在裝置上燒寫裝置的ProductKey、DeviceName、DeviceSecret，然後適配相應的HAL並調用SDK提供的函數串連物聯網平台。這種方式要求對裝置的產線工具進行一定的修改，需要對每個裝置燒寫不同的DeviceName和DeviceSecret。

• 一型一密：裝置上燒寫裝置的ProductKey、ProductSecret，每個裝置需要具備自己的唯一標識並將該標識預先上傳到阿里雲物聯網平台，然後調用SDK提供的函數串連雲端。這種方式每個裝置上燒寫的資訊是固定的ProductKey和ProductSecret。

擷取Link SDK

不同版本的Link SDK下載，請參見SDK擷取。

一機一密編程

• 在Link SDK v3.0.1中，需要實現下文認證資訊的配置：
  • HAL_GetProductKey
  • HAL_GetDeviceName
  • HAL_GetDeviceSecret
• 在Link SDK v3.1.0/v3.2.0中，通過IOT_Ioctl設定認證資訊：
  • IOT_Ioctl(IOTX_IOCTL_SET_PRODUCT_KEY, g_product_key)
  • IOT_Ioctl(IOTX_IOCTL_SET_DEVICE_NAME, g_device_name)
  • IOT_Ioctl(IOTX_IOCTL_SET_DEVICE_SECRET, g_device_secret)

int main(int argc, char *argv[])
{
    void                   *pclient = NULL;
    int                     res = 0;
    int                     loop_cnt = 0;
    iotx_mqtt_param_t       mqtt_params;

    memset(&mqtt_params, 0x0, sizeof(mqtt_params));
    mqtt_params.handle_event.h_fp = example_event_handle;

    pclient = IOT_MQTT_Construct(&mqtt_params);
    if (NULL == pclient) {
        EXAMPLE_TRACE("MQTT construct failed");
        return -1;
    }
    ...

｝ 

一型一密編程

一型一密認證方法使用的流程示意圖：

實現流程簡述步驟中涉及的API如下：

• 第1步和第2步對應使用者介面：IOT_Dynamic_Register()。
• 第3步對應使用者介面：IOT_Sign_MQTT()。
• 第4步對應使用者介面：IOT_MQTT_Construct()。

案例說明

以Link SDK v3.0.1版本為例，一型一密功能的案常式序參考src/dynamic_register/examples/dynreg_example.c檔案。

下文對其進行逐段講解：

1. 使用一型一密功能，需要包含其標頭檔dynreg_api.h：

   #include <stdio.h>
   #include <string.h>
   #include "infra_types.h"
   #include "infra_defs.h"
   #include "dynreg_api.h"

2. 準備輸入參數region和出入參結構體meta：

   iotx_http_region_types_t region = IOTX_HTTP_REGION_SHANGHAI;
   HAL_Printf("dynreg example\n");
   
   memset(&meta,0,sizeof(iotx_dev_meta_info_t));
   HAL_GetProductKey(meta.product_key);
   HAL_GetProductSecret(meta.product_secret);
   HAL_GetDeviceName(meta.device_name);

   說明

   • 入參region = IOTX_CLOUD_REGION_SHANGHAI表示用華東2（上海）作為示範串連網站的情境，您可根據自身需要替換為您的使用網站，詳細資料，請參見地區和可用性區域。
   • 入參meta表示從本地擷取的ProductKey、ProductSecret和DeviceName。
3. 調用一型一密的IOT_Dynamic_Register()介面擷取DeviceSecret，此介面是一型一密功能點唯一提供的使用者介面，若執行成功，在參數meta中將填上從物聯網平台成功擷取到的DeviceSecret。

   res = IOT_Dynamic_Register(region, &meta);
   if (res < 0) {
       HAL_Printf("IOT_Dynamic_Register failed\n");
       return -1;
   }
   
   HAL_Printf("\nDevice Secret: %s\n\n", meta.device_secret);

功能API介面