介绍

简介

百度智能云IoT物管理,提供用户在云端管理设备的能力。用户能够获取并控制设备状态、进行设备的批量操作以及设备诊断。一方面,设备主动向物管理中心更新状态信息;另一方面,控制端也可以通过和设备管理中心交互反控设备的行为,比如设备状态更新、OTA远程设备升级等。因此,设备管理中心既需要负责和设备端交互,又要负责和控制端交互。设备端的交互主要基于MQTT协议,而控制端通过HTTP通信。IoT Device Management API主要包括控制端的相关功能,以Restful API的形式提供。

V3版本引入模板的概念,用户可以通过模板和视图定义比较关注的设备属性,并将相关数据点写入百度天工时序数据库。此外,在V3版本中,我们分拆并丰富了设备主题,以帮助用户更好的处理设备数据上传以及反控等信息。

签名认证

物管理API会对每个访问的请求进行身份认证,以保障用户的安全。安全认证采用Access Key与请求签名机制。Access Key由Access Key ID和Secret Access Key组成,均为字符串,由百度智能云官方颁发给用户。其中Access Key ID用于标识用户身份,Access Key Secret 是用于加密签名字符串和服务器端验证签名字符串的密钥,必须严格保密。

对于每个HTTP请求,用户需要使用下文所描述的方式生成一个签名字符串,并将认证字符串放在HTTP请求的Authorization头域里。

签名字符串格式

bce-auth-v{version}/{accessKeyId}/{timestamp}/{expireTime}/{signedHeaders}/{signature}

其中:

  • version:正整数,目前取值为1。
  • timestamp:生成签名时的时间。时间格式符合通用约定
  • expireTime:签名有效期限,单位为秒,从timestamp所指定的时间开始计算。
  • signedHeaders:签名算法中涉及到的头域列表。头域名字之间用分号(;)分隔,如host;x-bce-date。列表按照字典序排列。当signedHeaders为空时表示取默认值。
  • signature:256位签名的十六进制表示,由64个小写字母组成,生成方式由如下签名生成算法给出。

签名生成算法

有关签名生成算法的具体介绍,请参看鉴权认证机制

服务域名

区域 域名 协议
华南-广州 iotdm.gz.baidubce.com http和https
华北-北京 iotdm.bj.baidubce.com http和https