# 设备身份注册

设备上线之前您需要对设备进行身份注册,标识您的设备。

# 概述

接入物联网平台的设备身份注册有两种方式:

  • 一机一密:首先,在物联网平台注册设备,获取设备证书信息(ProductKey、DeviceName、DeviceSecret)作为设备唯一标识。然后,将设备证书信息预烧录到设备固件,设备在完成上线建连后,即可向物联网平台上报数据。
  • 一型一密:同一产品下设备烧录相同产品证书(ProductKey和ProductSecret)。设备所属产品需开通动态注册功能。

image image

# 直连设备的HTTP动态注册

  • URL模板:http://auth.${YourRegionId}.fenydata.com/fenydata-java-auth/auth/register/device
  • HTTP方法:POST

请求数据格式

POST /fenydata-java-auth/auth/register/device  HTTP/1.1
Host: auth.huadong2.fenydata.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 123
productKey=a1234******&deviceName=deviceName1234&random=567345&sign=adfv123hdfdh&signMethod=HmacMD5

响应数据格式

{
  "code": 200,
  "data": {
    "productKey": "a1234******",
    "deviceName": "deviceName1234",
    "deviceSecret": "adsfw******"
  },
  "message": "success"
}

参数说明如下表

参数 类型 说明
Method String 请求方法,只支持POST。
Host String HTTP动态注册的设备接入地址,格式为auth.${YourRegionId}.fenydata.com。
${YourRegionId}:请替换为您的物联网平台设备所在地域的Region ID。
1:支持HTTP动态注册的地域:除华东1以外的所有地域。
2:Region ID表达方法,请参见支持的地域。
Content-Type String 设备发送给物联网平台的上行数据的编码格式。
productKey String 产品唯一标识。
deviceName String 设备名称。
random String 随机数。
sign String 签名。
加签方法:
1. 将所有提交给服务器的参数(sign、signMethod除外)按照字母顺序排序,然后将参数和值依次拼接(无拼接符号)。
2. 通过signMethod指定的加签算法,使用产品的ProductSecret,对加签内容进行加签。
加签计算示例如下:
hmac_sha1(productSecret, deviceNamedeviceName1234productKeya1234******random123)
signMethod String 签名方法,目前支持hmacmd5、hmacsha1、hmacsha256。
code Integer 结果信息。
deviceSecret String 设备密钥。