本文档主要介绍基于TCP的MQTT连接，连接方式为MQTT客户端直连。

背景信息

在进行MQTT CONNECT协议设置时，注意：

  • 如果同一个设备证书（ProductKey、DeviceName和DeviceSecret）同时用于多个物理设备连接，可能会导致客户端频繁上下线。因为新设备连接认证时，原使用该证书已连接的设备会被迫下线，而设备被下线后，又会自动尝试重新连接。
  • MQTT连接模式中，默认开源SDK下线后会自动重连。您可以通过日志服务查看设备行为。

MQTT客户端直连

  1. （可选）如果使用TLS加密，需要下载根证书。推荐使用TLS加密。
  2. 使用MQTT客户端连接服务器。连接方法，请参见开源MQTT客户端。
    如果需了解MQTT协议，请参见 http://mqtt.org 相关文档。
    说明 若使用第三方代码，阿里云不提供技术支持。
  3. MQTT 连接。

    建议您使用设备端SDK接入物联网平台。如果您自行开发接入，连接参数如下。签名计算示例，请参见MQTT连接签名示例。

    连接域名 ${YourProductKey}.iot-as-mqtt.${YourRegionId}.aliyuncs.com:1883

    ${YourProductKey}请替换为您的产品key。

    ${YourRegionId}请参见地域和可用区替换为您的Region ID。

    可变报头（variable header）：Keep Alive CONNECT指令中需包含Keep Alive（保活时间）。保活心跳时间取值范围为30至1200秒。如果心跳时间不在此区间内，物联网平台会拒绝连接。建议取值300秒以上。如果网络不稳定，将心跳时间设置高一些。
    MQTT的CONNECT报文参数 
    mqttClientId: clientId+"|securemode=3,signmethod=hmacsha1,timestamp=132323232|"
mqttUsername: deviceName+"&"+productKey
mqttPassword: sign_hmac(deviceSecret,content)

    mqttPassword：sign签名需把提交给服务器的参数按字典排序后，根据signmethod加签。

    content的值为提交给服务器的参数（ProductKey、DeviceName、timestamp和clientId），按照字母顺序排序， 然后将参数值依次拼接。

    • clientId：表示客户端ID，建议使用设备的MAC地址或SN码，64字符内。
    • timestamp：表示当前时间毫秒值，可以不传递。
    • mqttClientId：格式中||内为扩展参数。
    • signmethod：表示签名算法类型。支持hmacmd5，hmacsha1和hmacsha256，默认为hmacmd5。
    • securemode：表示目前安全模式，可选值有2 （TLS直连模式）和3（TCP直连模式）。

    示例：

    假设clientId = 12345，deviceName = device， productKey = pk， timestamp = 789，signmethod=hmacsha1，deviceSecret=secret，那么使用TCP方式提交给MQTT的参数如下： 

    mqttclientId=12345|securemode=3,signmethod=hmacsha1,timestamp=789|
mqttUsername=device&pk
mqttPassword=hmacsha1("secret","clientId12345deviceNamedeviceproductKeypktimestamp789").toHexString();

    加密后的Password为二进制转16制字符串，示例结果为：

    FAFD82A3D602B37FB0FA8B7892F24A477F85****

示例

使用开源MQTT客户端接入物联网平台的示例，请参见：

MQTT保活

设备端在保活时间间隔内，至少需要发送一次报文，包括ping请求。

如果物联网平台在保活时间内无法收到任何报文，物联网平台会断开连接，设备端需要进行重连。

连接保活时间的取值范围为30至1200秒。建议取值300秒以上。