IoT Platform:Enregistrement des appareils

Méthodes d'enregistrement

IoT Platform prend en charge deux méthodes d'enregistrement :

• One Device, One Secret : enregistrez l'appareil sur IoT Platform pour obtenir son certificat d'appareil (ProductKey, DeviceName et DeviceSecret). Intégrez ce certificat dans le micrologiciel de l'appareil. Une fois connecté, l'appareil peut transmettre des données à IoT Platform. One Device, One Secret.

  Protocoles d'enregistrement pris en charge :

  Appareil	Protocoles pris en charge	Développement de l'enregistrement côté appareil	Références
  Appareil connecté directement	MQTT	Enregistrement et authentification MQTT pour les appareils	Connexion et communication MQTT-TCP Connexion et communication HTTPS
  	HTTPS	Enregistrement et authentification HTTPS pour les appareils
  Sous-appareil de passerelle	MQTT	Enregistrement et authentification pour les passerelles et les sous-appareils

• One Product, One Secret : les appareils appartenant au même produit partagent un certificat de produit unique (ProductKey et ProductSecret). Activez l'enregistrement dynamique pour le produit.

  Méthodes d'enregistrement dynamique :

  • Pré-enregistrement : enregistrez d'abord l'appareil sur IoT Platform. L'appareil obtient un DeviceSecret via l'enregistrement dynamique.

  • Sans pré-enregistrement : ignorez l'étape d'enregistrement de l'appareil sur IoT Platform. L'appareil obtient un ClientID et un DeviceToken via l'enregistrement dynamique.

    Remarque

    HTTPS ne prend pas en charge la méthode sans pré-enregistrement.

  One Product, One Secret décrit le processus complet. Les sous-appareils de passerelle prennent uniquement en charge la méthode de pré-enregistrement. Passerelles et sous-appareils.

  Protocoles d'enregistrement pris en charge :

  Appareil	Protocoles pris en charge	Développement de l'enregistrement côté appareil	Description du format des données
  Appareil connecté directement	MQTT	Enregistrement MQTT dynamique pour les appareils	Enregistrement MQTT dynamique
  	HTTPS	Enregistrement HTTPS dynamique pour les appareils	Enregistrement HTTPS dynamique
  Sous-appareil de passerelle	MQTT	Authentification des sous-appareils dans Link SDK	Enregistrement MQTT dynamique pour les sous-appareils

Enregistrement MQTT dynamique pour les sous-appareils

• Topic de requête : /sys/${productKey}/${deviceName}/thing/sub/register

• Topic de réponse : /sys/${productKey}/${deviceName}/thing/sub/register_reply

Format des données de requête :

{
  "id": "123",
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": [
    {
      "deviceName": "deviceName1234",
      "productKey": "a1234******"
    }
  ],
  "method": "thing.sub.register"
}

Format des données de réponse :

{
  "id": "123",
  "code": 200,
  "data": [
    {
      "iotId": "12344",
      "productKey": "a1234******",
      "deviceName": "deviceName1234",
      "deviceSecret": "xxxxxx"
    }
  ]
}

Paramètres :

Codes d'erreur :

Enregistrement HTTPS dynamique pour les appareils connectés directement

• Modèle d'URL : https://iot-auth.${YourRegionId}.aliyuncs.com/auth/register/device

• Méthode HTTP : POST

  Format des données de requête :

  POST /auth/register/device  HTTP/1.1
  Host: iot-auth.cn-shanghai.aliyuncs.com
  Content-Type: application/x-www-form-urlencoded
  Content-Length: 123
  productKey=a1234******&deviceName=deviceName1234&random=567345&sign=adfv123hdfdh&signMethod=HmacMD5

  Format de réponse :

  {
    "code": 200,
    "data": {
      "productKey": "a1234******",
      "deviceName": "deviceName1234",
      "deviceSecret": "adsfw******"
    },
    "message": "success"
  }

  Paramètres :

  Paramètre	Type	Description
  Method	String	La méthode de requête. POST uniquement.
  Host	String	Le point de terminaison d'enregistrement HTTPS dynamique : iot-auth.${YourRegionId}.aliyuncs.com. ${YourRegionId} : l'ID de région de votre instance IoT Platform. Régions prises en charge : toutes les régions, à l'exception de Chine (Pékin) et Chine (Shenzhen). ID de région : Régions prises en charge.
  Content-Type	String	Le format d'encodage des données de l'appareil vers le cloud.
  productKey	String	L'identifiant du produit.
  deviceName	String	Le nom de l'appareil.
  random	String	Un nombre aléatoire.
  sign	String	La signature. Méthode de signature : Triez tous les paramètres, à l'exception de sign et signMethod, par ordre alphabétique, puis concaténez les noms et les valeurs sans délimiteur. Signez la chaîne concaténée à l'aide de signMethod et du ProductSecret du produit. Exemple de signature : hmac_sha1(productSecret, deviceNamedeviceName1234productKeya1234******random123)
  signMethod	String	L'algorithme de signature. Valeurs valides : hmacmd5, hmacsha1, hmacsha256.
  code	Integer	Le code de résultat.
  deviceSecret	String	Le secret de l'appareil.