Jika Anda menggunakan SDK perangkat, SDK IoT Platform, atau SDK Protokol Antrian Pesan Lanjutan (AMQP), Anda harus menentukan titik akhir dari instans yang ingin disambungkan dengan perangkat Anda. Topik ini menjelaskan cara mendapatkan titik akhir dari suatu instans.
Prasyarat
Tipe instans dan wilayah tempat instans berada telah diperoleh.
Instance | Wilayah | Deskripsi | Metode |
Instans publik versi sebelumnya | Cina (Shanghai), Jepang (Tokyo), Singapura, Jerman (Frankfurt), AS (Silicon Valley), dan AS (Virginia) | Di tab Overview pada konsol IoT Platform, tidak ada ID instans yang ditampilkan. Oleh karena itu, Anda tidak dapat mengklik sebuah instans untuk pergi ke halaman Instance Details. Catatan Instans publik versi baru hanya tersedia di wilayah Cina (Shanghai). Instans publik di wilayah lain adalah versi sebelumnya. | Anda tidak dapat melihat development configurations dari instans di konsol IoT Platform. Topik ini menjelaskan semua informasi titik akhir yang diperlukan untuk menyambungkan perangkat Anda ke IoT Platform. Untuk informasi lebih lanjut, lihat Lihat titik akhir instans publik versi sebelumnya. |
Instans publik versi baru | Cina (Shanghai) | Di tab Overview pada konsol IoT Platform, ID instance ID ditampilkan. Klik ID instance untuk pergi ke halaman Instance Details. | Di sudut kanan atas halaman Detail Instans di konsol IoT Platform, klik Lihat Konfigurasi Pengembangan untuk membuka panel Development Configurations yang menampilkan informasi titik akhir. Untuk informasi lebih lanjut, lihat bagian "Lihat titik akhir instans publik versi baru atau instans Enterprise Edition" dari topik ini. |
Instans Enterprise Edition | Cina (Shanghai), Cina (Beijing), Cina (Shenzhen), Jepang (Tokyo), Singapura, Jerman (Frankfurt), AS (Silicon Valley), dan AS (Virginia) |
Untuk informasi lebih lanjut, lihat Ikhtisar Instans IoT Platform.
Informasi latar belakang
Untuk informasi tentang cara mengonfigurasi SDK, lihat Gunakan SDK Perangkat untuk Menyambungkan Perangkat ke IoT Platform, Unduh SDK IoT Platform, dan Sambungkan Klien AMQP ke IoT Platform.
Catatan penggunaan
Jika Anda menggunakan langganan server berbasis AMQP atau memanggil operasi API IoT Platform untuk menyambungkan perangkat ke instans IoT Platform melalui Internet menggunakan Message Queuing Telemetry Transport (MQTT), Constrained Application Protocol (CoAP), atau HTTP, Anda harus menentukan titik akhir publik saat mengonfigurasi perangkat.
Jika Anda menggunakan IoT Device ID untuk memverifikasi dan menyambungkan perangkat ke instans IoT Platform melalui Internet, Anda harus menentukan titik akhir publik sebagai nilai parameter ID².
PentingFormat nilai parameter ID² untuk instans publik dan instans Enterprise Edition sama. Untuk informasi lebih lanjut tentang format, lihat Lihat Titik Akhir Instans Publik Versi Sebelumnya.
Jika Anda menggunakan langganan server berbasis AMQP atau memanggil operasi API IoT Platform untuk menyambungkan perangkat ke instans IoT Platform melalui virtual private cloud (VPC) menggunakan MQTT, Anda harus menentukan titik akhir VPC saat mengonfigurasi perangkat.
Jika Anda ingin menyambungkan perangkat ke instans Enterprise Edition menggunakan MQTT, Anda dapat mengikat alamat IP tetap ke titik akhir instans.
Jika Anda menggunakan instans Exclusive Enterprise Edition, Anda harus membuat titik akhir MQTT terpisah. Kemudian, Anda dapat menentukan nomor port kustom dan sertifikat untuk titik akhir tersebut.
Lihat titik akhir instans publik versi sebelumnya
Tipe komunikasi | Format titik akhir | Nomor port |
MQTT |
| 1883 atau 443 Jika MQTT over WebSocket digunakan, atur parameter ini ke 443. |
CoAP |
|
|
HTTP | Verifikasi satu-sertifikat-per-perangkat: | 443 |
Verifikasi pra-pendaftaran satu-sertifikat-per-produk: Penting Metode verifikasi pra-pendaftaran satu-sertifikat-per-produk berbasis HTTPS didukung hanya jika Anda menyambungkan perangkat ke instans yang berada di wilayah Cina (Shanghai). | ||
AMQP |
|
|
Permintaan API IoT Platform | Permintaan API dalam format | Tidak tersedia |
ID² |
Parameter ini hanya tersedia di wilayah Jepang (Tokyo). | 1883 |
Konfigurasikan parameter berdasarkan kebutuhan bisnis Anda. Tabel berikut menjelaskan parameter.
Parameter | Deskripsi |
| ProductKey dari produk yang dimiliki perangkat. Anda dapat masuk ke konsol IoT Platform dan mendapatkan ProductKey di halaman Detail Perangkat instans. |
| ID wilayah tempat perangkat Anda berada. Untuk informasi tentang format ID wilayah, lihat Wilayah yang Didukung. |
| ID akun Alibaba Cloud Anda. Anda dapat masuk ke IoT Platform console, dan arahkan kursor ke foto profil untuk melihat ID akun. |
Lihat titik akhir instans publik versi baru atau instans Enterprise Edition
Masuk ke Konsol IoT Platform. Di sudut kiri atas, pilih wilayah tempat instans IoT berada.
Pada tab Overview, klik nama atau ID instans yang ingin Anda kelola.
Di sudut kanan atas halaman Instance Details, klik View Development Configurations.
Pada panel Development Configurations, klik tab MQTT, CoAP, atau HTTP untuk melihat titik akhir yang digunakan oleh perangkat Anda berdasarkan protokol.
PentingJika Anda menggunakan instans Exclusive, Anda harus membuat titik akhir MQTT. Untuk informasi lebih lanjut, lihat Buat Titik Akhir MQTT Terpisah untuk Instans Exclusive.
Jika IoT Device ID diaktifkan untuk instans Enterprise Edition, parameter ID² tidak tersedia pada tab Manage ID² panel Development Configurations. Untuk informasi lebih lanjut tentang format parameter ID², lihat bagian "Lihat Titik Akhir Instans Publik Versi Sebelumnya" dalam topik ini.
Jika Anda menyambungkan perangkat ke IoT Platform melalui HTTPS, metode verifikasi satu-sertifikat-per-perangkat dan metode verifikasi pra-pendaftaran satu-sertifikat-per-produk didukung. Namun, titik akhir metode verifikasi tersebut berbeda.
Jika Anda menggunakan metode verifikasi satu-sertifikat-per-perangkat, titik akhir ditampilkan pada tab HTTP.
Jika Anda menggunakan metode verifikasi pra-pendaftaran satu-sertifikat-per-produk, instans IoT Platform yang ingin Anda sambungkan dengan perangkat harus berada di wilayah Cina (Shanghai) dan menggunakan titik akhir
iot-auth.cn-shanghai.aliyuncs.com.
Pada setiap tab, lakukan operasi berikut:
Klik Copy untuk menyalin titik akhir instans.
Arahkan kursor ke ikon
di sebelah kanan titik akhir untuk melihat nomor port.
CatatanUntuk informasi tentang port, lihat bagian "Lihat Titik Akhir Instans Publik Versi Sebelumnya" dari topik ini.
Mengikat alamat IP tetap ke titik akhir
Alamat IP tetap mencegah catatan Sistem Nama Domain (DNS) Anda diperbarui saat IoT Platform memperluas daftar alamat IP. Jika Anda menggunakan kartu IoT dan operator Anda tidak mendukung titik akhir, Anda dapat menambahkan alamat IP tetap Anda ke daftar alamat IP arah operator.
Alamat IP dapat berubah karena berbagai alasan, seperti pemindahan pusat data operator Anda. Jika perangkat Anda mengakses alamat IP tetap, Anda harus mengirim perintah dari IoT Platform atau melakukan pembaruan over-the-air (OTA) untuk menyinkronkan alamat IP ke perangkat Anda. Jika tidak, perangkat Anda tidak dapat terhubung ke IoT Platform.
Kami merekomendasikan agar Anda menggunakan titik akhir untuk menyambungkan perangkat Anda ke IoT Platform. Dengan cara ini, Anda akan diberi tahu sebelum alamat IP berubah.
Untuk mengikat alamat IP tetap ke titik akhir yang ingin Anda sambungkan dengan perangkat melalui Internet menggunakan MQTT, lakukan langkah-langkah berikut:
Jika Anda menggunakan instans Enterprise Edition non-Eksklusif, Anda dapat mengikat dua alamat IP tetap ke titik akhir.
Di sudut kanan atas halaman Instance Details instans Enterprise Edition non-Eksklusif, klik View Developer Configurations.
Pada tab MQTT panel Development Configurations, klik Configure di sebelah kanan Fixed IP.
Dalam kotak dialog yang muncul, klik OK untuk mendapatkan dua alamat IP tetap.
Jika perangkat MQTT tidak lagi memerlukan alamat IP tetap, klik Unbind.
Setelah Anda membuat titik akhir MQTT publik untuk instans Eksklusif, sistem secara otomatis mengaitkan alamat IP tetap dengan instans. Anda tidak perlu melakukan operasi tambahan. Anda tidak dapat melepaskan alamat IP tetap dari instans.
Buat titik akhir MQTT terpisah untuk instans Eksklusif
Untuk membuat titik akhir MQTT untuk instans Eksklusif, lakukan langkah-langkah berikut:
Di sudut kanan atas halaman Instance Details instans Eksklusif, klik View Development Configurations.
Pada tab MQTT panel Development Configurations, klik Create.
Dalam kotak dialog Create Endpoint, konfigurasikan parameter. Tabel berikut menjelaskan parameter.
Parameter
Deskripsi
Nomor Port Kustom
Nomor port titik akhir MQTT. Nilai default: 1883.
Aktifkan VPC
Ya: Aktifkan VPC. Jika Anda memilih Ya, Anda harus menentukan VPC, zona, vSwitch, dan grup keamanan.
Sistem secara otomatis membuat titik akhir MQTT publik dan titik akhir MQTT VPC.
PentingJika Anda ingin mengaktifkan VPC untuk titik akhir MQTT, Anda harus mengaktifkan PrivateLink untuk VPC. Jika PrivateLink belum diaktifkan untuk akun Alibaba Cloud Anda, Anda harus pergi ke konsol VPC untuk mengaktifkan PrivateLink.
Tidak (default): Nonaktifkan VPC.
Sistem secara otomatis membuat titik akhir MQTT publik.
PentingJika Anda memilih No, Anda tidak dapat mengaktifkan VPC.
Otorisasi
Jika Anda ingin mengaktifkan VPC, Anda harus menyelesaikan otorisasi.
Klik Authorize. Sistem secara otomatis membuat peran dan kebijakan yang memberikan perangkat izin pada VPC tempat Anda ingin menyambungkan perangkat ke IoT Platform. Untuk informasi lebih lanjut, lihat Peran terkait layanan.
VPC
Setelah Anda mengaktifkan VPC dan menyelesaikan otorisasi, Anda harus mengonfigurasi parameter ini.
Pilih VPC dan vSwitch yang ada di akun Alibaba Cloud saat ini.
Anda dapat mengklik CreateVPC dan CreateVSwitch untuk membuat VPC dan vSwitch. Untuk informasi lebih lanjut, lihat Buat VPC dan Buat vSwitch.
Zona vSwitch
vSwitch
Grup Keamanan
Setelah Anda mengaktifkan VPC dan menyelesaikan otorisasi, Anda harus mengonfigurasi parameter ini.
Pilih grup keamanan yang ada di akun Alibaba Cloud saat ini.
Anda dapat mengklik Create Security Group untuk membuat grup keamanan. Untuk informasi lebih lanjut, lihat Buat grup keamanan.
Dalam pesan yang muncul, klik OK.
Setelah Anda membuat titik akhir, titik akhir akan ditampilkan di bagian Connect to MQTT Devices.
Buat sertifikat kustom untuk titik akhir MQTT instans Eksklusif
Untuk membuat sertifikat kustom dan nama domain untuk titik akhir MQTT, lakukan langkah-langkah berikut:
Titik akhir publik dan titik akhir VPC menggunakan sertifikat kustom yang sama.
Di sudut kanan atas halaman Instance Details instans Eksklusif, klik View Development Configurations.
Pada panel Development Configurations, klik MQTT. Pada tab MQTT, klik Configure di bagian Custom Certificate.
Dalam kotak dialog Custom Certificate, atur parameter Customize Configurations ke Enable.
CatatanJika parameter Customize Configurations sudah diatur ke Aktifkan, lewati langkah ini.
Tentukan konten dan kunci dalam format PEM dari sertifikat yang diperoleh dari otoritas sertifikat (CA) dan klik OK.
PeringatanJika Anda ingin memperbarui informasi sertifikat setelah menentukan konten dan kunci sertifikat, verifikasi sertifikat mungkin gagal. Dalam hal ini, perangkat mungkin gagal terhubung ke IoT Platform atau bisnis Anda mungkin terganggu. Lanjutkan dengan hati-hati.
Panel Konfigurasi Pengembangan menampilkan nama domain kustom yang diurai dari sertifikat kustom. Anda dapat menggunakan titik akhir kustom untuk menyambungkan perangkat ke IoT Platform melalui MQTT.
PentingAnda harus mengonfigurasi catatan CNAME di penyedia nama domain untuk menyelesaikan nama domain kustom ke titik akhir MQTT default instans.