IoT Platform:Registrasi identitas perangkat

Metode registrasi

IoT Platform mendukung dua metode registrasi perangkat:

• One Device, One Secret: Daftarkan perangkat di IoT Platform untuk memperoleh sertifikat perangkat (ProductKey, DeviceName, dan DeviceSecret) sebagai pengenal unik. Sertifikat tersebut harus ditanamkan ke dalam firmware perangkat. Setelah terhubung, perangkat dapat mengirimkan data ke IoT Platform. One Device, One Secret.

  Protokol registrasi yang didukung:

  Perangkat	Protokol yang didukung	Pengembangan registrasi di sisi perangkat	Referensi
  Perangkat terhubung langsung	MQTT	Registrasi dan autentikasi MQTT untuk perangkat	Koneksi dan komunikasi MQTT-TCP Koneksi dan komunikasi HTTPS
  	HTTPS	Registrasi dan autentikasi HTTPS untuk perangkat
  Perangkat sub gerbang	MQTT	Registrasi dan autentikasi untuk gerbang dan perangkat sub

• One Product, One Secret: Semua perangkat dalam satu produk berbagi satu sertifikat produk (ProductKey dan ProductSecret). Aktifkan registrasi dinamis untuk produk tersebut.

  Metode registrasi dinamis:

  • Pre-registration: Daftarkan perangkat di IoT Platform. Perangkat kemudian memperoleh DeviceSecret melalui registrasi dinamis.

  • Registration-free: Tidak perlu mendaftarkan perangkat di IoT Platform. Perangkat memperoleh kombinasi ClientID dan DeviceToken melalui registrasi dinamis.

    Catatan

    Protokol HTTPS tidak mendukung metode registration-free untuk autentikasi One Product, One Secret.

  Proses registrasi lengkap dijelaskan dalam One Product, One Secret. Perangkat sub gerbang hanya mendukung metode pre-registration. Gerbang dan perangkat sub.

  Protokol registrasi yang didukung:

  Perangkat	Protokol yang didukung	Pengembangan registrasi di sisi perangkat	Deskripsi format data
  Perangkat terhubung langsung	MQTT	Registrasi MQTT dinamis untuk perangkat	Registrasi MQTT dinamis
  	HTTPS	Registrasi HTTPS dinamis untuk perangkat	Registrasi HTTPS dinamis
  Perangkat sub gerbang	MQTT	Autentikasi perangkat sub di Link SDK	Registrasi MQTT dinamis untuk perangkat sub

Registrasi MQTT dinamis untuk perangkat sub

• Topik permintaan: /sys/${productKey}/${deviceName}/thing/sub/register

• Topik respons: /sys/${productKey}/${deviceName}/thing/sub/register_reply

Format data permintaan:

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

Format data respons:

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

Parameter:

Kode error:

Registrasi HTTPS dinamis untuk perangkat terhubung langsung

• Templat URL: https://iot-auth.${YourRegionId}.aliyuncs.com/auth/register/device

• Metode HTTP: POST

  Format data permintaan:

  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 respons:

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

  Parameter:

  Parameter	Tipe	Deskripsi
  Method	String	Metode permintaan. Hanya POST yang didukung.
  Host	String	Titik akhir registrasi HTTPS dinamis: iot-auth.${YourRegionId}.aliyuncs.com. ${YourRegionId}: ID wilayah instans IoT Platform Anda. Wilayah yang didukung: semua wilayah kecuali China (Beijing) dan China (Shenzhen). ID wilayah: Wilayah yang didukung.
  Content-Type	String	Format encoding untuk data dari perangkat ke cloud.
  productKey	String	Pengenal unik produk.
  deviceName	String	Nama perangkat.
  random	String	Bilangan acak.
  sign	String	Tanda tangan. Metode penandatanganan: Urutkan semua parameter kecuali sign dan signMethod secara alfabetis, lalu gabungkan nama dan nilai tanpa pembatas. Tandatangani string yang digabungkan dengan algoritma yang ditentukan oleh signMethod dan ProductSecret produk. Contoh signature: hmac_sha1(productSecret, deviceNamedeviceName1234productKeya1234******random123)
  signMethod	String	Algoritma penandatanganan. Nilai yang didukung: hmacmd5, hmacsha1, dan hmacsha256.
  code	Integer	Informasi hasil.
  deviceSecret	String	Rahasia perangkat.