All Products
Search
Document Center

IoT Platform:Hitung parameter signature MQTT

Last Updated:Apr 25, 2026

Saat menghubungkan perangkat ke IoT Platform menggunakan klien MQTT kustom, Anda harus menyediakan parameter otentikasi signature MQTT: username, passwd, dan mqttClientId. Topik ini menjelaskan cara memperoleh parameter tersebut.

Ikhtisar

Anda dapat memperoleh parameter signature MQTT menggunakan salah satu metode berikut sesuai kebutuhan bisnis Anda.

Metode

Deskripsi

Peroleh dari Konsol IoT Platform

Algoritma signature yang didukung adalah hmacsha256.

Client ID perangkat secara default adalah ${ProductKey} + '.' + ${DeviceName} dan tidak dapat diubah.

Hitung menggunakan skrip Node.js

Algoritma signature yang didukung adalah hmacsha256.

Client ID perangkat secara default adalah ${ProductKey} + '.' + ${DeviceName} dan dapat diubah.

Peroleh dari Konsol IoT Platform

  1. Masuk ke Konsol IoT Platform.

  2. Pada halaman Overview, temukan instans yang ingin Anda kelola, lalu klik ID instans atau nama instans tersebut.

  3. Di panel navigasi sebelah kiri, pilih Devices > Device untuk membuka halaman Device.

  4. Temukan perangkat Anda, lalu klik View untuk membuka halaman Device Details.

  5. Pada tab Device Information, klik View di samping MQTT Connection Parameters untuk melihat parameter signature MQTT.

    Penting

    Parameter clientId yang ditampilkan di sini sesuai dengan mqttClientId. Jangan tertukar dengan client ID perangkat. Untuk informasi lebih lanjut tentang parameter koneksi MQTT, lihat Komunikasi MQTT-TLS.

    Kotak dialog MQTT Connection Parameters muncul, menampilkan nilai-nilai untuk clientId, username, passwd, mqttHostUrl, dan port. Klik Copy All untuk menyalin semua parameter.

Hitung menggunakan skrip Node.js

  1. Unduh dan ekstrak paket signTool.zip, lalu ubah dan simpan parameter berikut dalam file mqttSignTool.js.

    Parameter

    Contoh

    Deskripsi

    productKey

    a1Ee***

    Sertifikat perangkat yang Anda simpan setelah menambahkan perangkat. Untuk informasi lebih lanjut, lihat Informasi sertifikat perangkat.

    Anda dapat melihat informasi tersebut pada halaman Device Details perangkat di konsol.

    deviceName

    8Co5***

    deviceSecret

    bcabcf***

    timestamp

    2524608000000

    Waktu saat ini dalam milidetik.

    briefId

    12345

    Client ID perangkat. Parameter ini opsional.

    Secara default, paket tool mengatur parameter ini menjadi ${ProductKey} + '.' + ${DeviceName}, tetapi Anda dapat mengubah nilainya sesuai kebutuhan. Contohnya, var briefId = '12345'.

    Penting

    Anda dapat menentukan nilai kustom hingga 64 karakter. Kami menyarankan menggunakan alamat MAC atau nomor seri (SN) perangkat agar mudah diidentifikasi.

  2. Pada sistem operasi Windows atau Linux Anda, unduh dan instal Node.js. Contoh berikut menggunakan sistem Linux Ubuntu 16.04 64-bit dan paket pre-compiled node-v16.5.0-linux-x64.tar.gz.

    1. Masuk ke Mesin virtual (VM) Linux.

    2. Jalankan perintah berikut untuk mengunduh dan mengekstrak paket.

      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

      Jika nomor versi berikut dikembalikan, Node.js berhasil diinstal.

      v16.5.0
    3. Direktori node-v16.5.0-linux-x64/bin berisi perintah node dan npm. Jalankan perintah berikut untuk mengonfigurasinya sebagai variabel lingkungan global.

      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/
  3. Jalankan perintah berikut untuk keluar dari direktori node-v16.5.0-linux-x64, lalu buat folder proyek signTool untuk file JavaScript dan library signature.

    cd..
    mkdir signTool
    cd signTool/
  4. Unggah file mqttSignTool.js yang telah dimodifikasi dari langkah 1 ke direktori signTool pada VM Linux Anda.

  5. Di direktori signTool, jalankan perintah berikut untuk mengunduh library signature dan menampilkan isi direktori.

    npm install crypto-js
    ls

    File library yang diunduh adalah sebagai berikut.

    mqttSignTool.js  node_modules  package.json  package-lock.json
  6. Jalankan perintah berikut untuk mengeksekusi skrip mqttSignTool.js.

    node mqttSignTool.js

    Perintah tersebut mengembalikan parameter otentikasi signature yang diperlukan untuk terhubung ke IoT Platform melalui MQTT.

    Penting

    Parameter clientId yang ditampilkan di sini sesuai dengan mqttClientId. Jangan tertukar dengan client ID perangkat. Untuk informasi lebih lanjut tentang parameter koneksi MQTT, lihat Komunikasi MQTT-TLS.

    username:
    xxx
    clientId:
    xxx|securemode=2,signmethod=hmacsha256,timestamp=2524608000000|
    passwd:
    xxx