如何计算MQTT签名参数-物联网平台（文档停止维护）(IoT)-阿里云帮助中心

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

概述

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

方法	说明
直接在物联网平台获取	支持签名算法为hmacsha256。设备的ClientId默认为`${ProductKey} + '.' + ${DeviceName}`组成的字符串，不可修改。
使用网页工具计算	支持签名算法为hmacmd5和hmacsha1。
使用Node.js语言脚本计算	支持签名算法为hmacsha256。设备的ClientId默认为`${ProductKey} + '.' + ${DeviceName}`组成的字符串，可修改。

直接在物联网平台获取

登录物联网平台控制台。
在实例概览页签的全部环境下，找到对应的实例，单击实例卡片。
在左侧导航栏，选择设备管理 > 设备，进入设备页面。
在设备列表中，单击目标设备对应的查看按钮，进入设备详情页面。
在设备信息页签下，单击MQTT连接参数右侧的查看，获取MQTT签名参数信息。

重要
其中clientId是mqttClientId值，请勿与设备的clientId混淆。MQTT连接参数的详细说明，请参见MQTT-TLS连接通信。

弹出MQTT 连接参数对话框，显示 clientId、username、passwd、mqttHostUrl 和 port 五个参数及其值，单击一键复制可复制全部参数信息。

使用网页工具计算

单击下载MQTT_Password工具包，然后解压。
在文件夹MQTT_Password下，使用浏览器打开sign.html文件。

在MQTT签名计算页面，根据页面提示，输入对应信息。

参数	说明
productKey	您添加设备后，保存的设备证书信息，请参见设备证书信息。您可在控制台中设备的设备详情页面查看。
deviceName
deviceSecret
timestamp	时间戳。当前时间毫秒值，自动填充。每刷新一次页面，更新一次。
clientId	设备的Client ID信息，可自定义，长度在64个字符以内。建议使用您设备的MAC地址或SN码，方便您识别区分不同的设备。
method	签名算法类型，支持hmacmd5和hmacsha1。

单击Generate，计算结果显示签名参数值。

签名参数包括 mqttClientId（格式为 ${clientId}|securemode=2,signmethod=${method},timestamp=${timestamp}，可直接用于 MQTT.fx 的 Client ID 字段）、username 和 password。

使用Node.js语言脚本计算

下载签名工具包signTool.zip，解压缩后，在文件mqttSignTool.js中修改以下参数，并保存。

参数	示例	说明
productKey	a1Ee***	您添加设备后，保存的设备证书信息，请参见设备证书信息。您可在控制台中设备的设备详情页面查看。
deviceName	8Co5***
deviceSecret	bcabcf***
timestamp	2524608000000	时间戳。当前时间毫秒值。
briefId	12345	设备的Client ID信息。可选参数。本工具包默认设置为`${ProductKey} + '.' + ${DeviceName}`组成的字符串，您可根据需要修改，例如`var briefId = '12345'`。重要该值可自定义，长度在64个字符以内。建议使用您设备的MAC地址或SN码，方便您识别区分不同的设备。

在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/
```
执行以下命令，先退出node-v16.5.0-linux-x64文件目录，然后创建项目文件signTool，来存放JavaScript文件和签名库文件。
```
cd..
mkdir signTool
cd signTool/
```
将步骤1中已修改完成的mqttSignTool.js文件，上传至Linux虚拟机开发环境的signTool目录下。
在signTool文件下，执行以下命令，下载并查看签名库文件。
```
npm install crypto-js
ls
```
下载后的库文件如下所示。
```
mqttSignTool.js  node_modules  package.json  package-lock.json
```
执行以下命令，运行签名文件mqttSignTool.js。
```
node mqttSignTool.js
```
返回如下信息，即为通过MQTT接入物联网平台的签名认证参数信息。

重要
其中clientId是mqttClientId值，请勿与设备的clientId混淆。MQTT连接参数的详细说明，请参见MQTT-TLS连接通信。
```
username:
xxx
clientId:
xxx|securemode=2,signmethod=hmacsha256,timestamp=2524608000000|
passwd:
xxx
```