Tous les produits
Search
Centre de documentation

IoT Platform:Connexions MQTT basées sur IPv6

Dernière mise à jour :Aug 09, 2026

Vous pouvez connecter des appareils à IoT Platform via MQTT. Cette rubrique explique comment établir des connexions MQTT basées sur IPv6 entre les appareils et IoT Platform.

Limites

Seule la région Chine (Shanghai) prend en charge les connexions MQTT basées sur IPv6.

Connecter un appareil à IoT Platform

  1. Téléchargez le certificat racine utilisé pour le chiffrement TLS. Pour plus d'informations sur l'utilisation du certificat racine, consultez la documentation relative aux certificats d'autorité de certification.

  2. Développez votre appareil pour configurer une connexion MQTT.

    Nous vous recommandons d'utiliser les SDK d'appareil fournis par Alibaba Cloud pour vous connecter à IoT Platform. Si vous utilisez des SDK d'appareil personnalisés, vous devez configurer un mécanisme de signature. Pour plus d'informations, consultez les exemples de création de signatures pour les connexions MQTT.

    Le tableau suivant décrit les paramètres.

    ParamètreDescription
    Nom de domaine et portLe nom de domaine est ipv6.itls.cn-shanghai.aliyuncs.com et le numéro de port est 1883.
    En-tête variable : Keep AliveLe message CONNECT doit inclure une période de maintien de la connexion (keep-alive). Les valeurs valides pour cette période sont comprises entre 30 et 1 200 secondes. Si la valeur du paramètre Keep Alive ne se situe pas dans cette plage, IoT Platform rejette la connexion. Nous vous recommandons de définir une valeur supérieure à 300 secondes. Si la connexion réseau est instable, il est conseillé de définir une période de maintien de la connexion élevée.
    Paramètres dans un message MQTT CONNECT
    mqttClientId: clientId+"|securemode=2,signmethod=hmacsha1,timestamp=132323232|"
    mqttUsername: deviceName+"&"+productKey
    mqttPassword: sign_hmac(deviceSecret,content)

    mqttPassword : le mot de passe. Méthode de calcul : triez les paramètres soumis au serveur par ordre alphabétique et chiffrez-les selon l'algorithme de signature spécifié.

    content : chaîne concaténée des paramètres soumis au serveur. Ces paramètres incluent productKey, deviceName, timestamp et clientId. Les paramètres sont triés par ordre alphabétique et concaténés sans délimiteur.

    • clientId : l'ID du client. Nous vous recommandons d'utiliser l'adresse MAC ou le numéro de série (SN) de l'appareil comme ID client. L'ID client ne doit pas dépasser 64 caractères.
    • timestamp : l'heure actuelle, en millisecondes. Ce paramètre est facultatif.
    • mqttClientId : les paramètres étendus sont placés entre des barres verticales (|).
    • signmethod : l'algorithme de signature. Valeurs valides : hmacmd5, hmacsha1, hmacsha256 et sha256. Valeur par défaut : hmacmd5.
    • securemode : le mode de sécurité. Définissez la valeur sur 2 (connexion TLS directe).

    Exemple :

    Supposons que les valeurs suivantes soient spécifiées : clientId=12345, deviceName=device, productKey=pk, timestamp=789, signmethod=hmacsha1, deviceSecret=secret. Le code suivant montre les paramètres d'un message MQTT CONNECT envoyé via TCP :

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

    Le mot de passe chiffré est une chaîne hexadécimale convertie à partir d'une chaîne binaire. Le code suivant montre le résultat :

    FAFD82A3D602B37FB0FA8B7892F24A477F85****

Références

Connexion via MQTT-TLS