设备通过您自研的MQTT接入工具连接物联网平台时,需输入MQTT的签名认证参数username、passwd和mqttClientId。本文介绍获取MQTT连接签名参数值的方法。

概述

您可根据实际业务需要,选择如下方法获取MQTT签名参数值。

方法说明
直接在物联网平台获取支持签名算法为hmacsha256。

设备的ClientId默认为${ProductKey} + '.' + ${DeviceName}组成的字符串,不可修改。

使用网页工具计算支持签名算法为hmacmd5和hmacsha1。
使用Node.js语言脚本计算支持签名算法为hmacsha256。

设备的ClientId默认为${ProductKey} + '.' + ${DeviceName}组成的字符串,可修改。

直接在物联网平台获取

  1. 登录物联网平台控制台
  2. 实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。
    重要 目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述
    实例概览
  3. 在左侧导航栏,选择设备管理 > 设备,进入设备页面。
  4. 在设备列表中,单击目标设备对应的查看按钮,进入设备详情页面。
  5. 设备信息页签下,单击MQTT连接参数右侧的查看,获取MQTT签名参数信息。
    重要 其中clientId是mqttClientId值,请勿与设备的clientId混淆。MQTT连接参数的详细说明,请参见MQTT-TCP连接通信
    MQTT连接参数

使用网页工具计算

  1. 单击下载MQTT_Password工具包,然后解压。
  2. 在文件夹MQTT_Password下,使用浏览器打开sign.html文件。
    网页工具
  3. 在MQTT签名计算页面,根据页面提示,输入对应信息,如下图所示。
    网页
    参数说明
    productKey您添加设备后,保存的设备证书信息,请参见设备证书信息

    您可在控制台中设备的设备详情页面查看。

    deviceName
    deviceSecret
    timestamp 时间戳。当前时间毫秒值,自动填充。每刷新一次页面,更新一次。
    clientId设备的Client ID信息,可自定义,长度在64个字符以内。建议使用您设备的MAC地址或SN码,方便您识别区分不同的设备。
    method签名算法类型,支持hmacmd5hmacsha1
  4. 单击Generate计算结果显示签名参数值。
    计算结果

使用Node.js语言脚本计算

  1. 下载签名工具包signTool.zip,解压缩后,在文件mqttSignTool.js中修改以下参数,并保存。
    参数示例说明
    productKeya1Ee***您添加设备后,保存的设备证书信息,请参见设备证书信息

    您可在控制台中设备的设备详情页面查看。

    deviceName8Co5***
    deviceSecretbcabcf***
    timestamp 2524608000000时间戳。当前时间毫秒值。
    briefId12345设备的Client ID信息。可选参数。

    本工具包默认设置为${ProductKey} + '.' + ${DeviceName}组成的字符串,您可根据需要修改,例如var briefId = '12345'

    重要 该值可自定义,长度在64个字符以内。建议使用您设备的MAC地址或SN码,方便您识别区分不同的设备。
  2. 在Windows系统或Linux系统下,下载并安装Node.js。本文以Ubuntu 16.04 64位Linux系统为例,下载已编译的包node-v16.5.0-linux-x64.tar.gz
    1. 登录Linux虚拟机。
    2. 执行以下命令,下载对应版本包,然后解压。
      wget https://nodejs.org/dist/v16.5.0/node-v16.5.0-linux-x64.tar.gz
      tar xf node-v16.5.0-linux-x64.tar.gz
      cd node-v16.5.0-linux-x64
      ./bin/node -v
      显示如下版本号,表示解压安装成功。
      v16.5.0
    3. node-v16.5.0-linux-x64/bin文件目录下包含了node、npm等命令,执行以下命令配置全局环境变量。
      ln -s /root/node-v16.5.0-linux-x64/bin/npm   /usr/local/bin/
      ln -s /root/node-v16.5.0-linux-x64/bin/node   /usr/local/bin/
  3. 执行以下命令,先退出node-v16.5.0-linux-x64文件目录,然后创建项目文件signTool,来存放JavaScript文件和签名库文件。
    cd..
    mkdir signTool
    cd signTool/
  4. 将步骤1中已修改完成的mqttSignTool.js文件,上传至Linux虚拟机开发环境的signTool目录下。
  5. signTool文件下,执行以下命令,下载并查看签名库文件。
    npm install crypto-js
    ls
    下载后的库文件如下图所示。文件
  6. 执行以下命令,运行签名文件mqttSignTool.js
    node mqttSignTool.js
    返回如下信息,即为通过MQTT接入物联网平台的签名认证参数信息。
    重要 其中clientId是mqttClientId值,请勿与设备的clientId混淆。MQTT连接参数的详细说明,请参见MQTT-TCP连接通信
    结果