SDK Microsoft untuk IoT Hub Device Provisioning Service

SDK Microsoft untuk IoT Hub Device Provisioning Service (DPS) membantu Anda membangun aplikasi perangkat dan backend yang menyediakan perangkat IoT ke satu atau beberapa hub IoT. SDK menangani protokol transportasi dan keamanan yang mendasar antara perangkat atau aplikasi backend dan DPS, membebaskan Anda untuk fokus pada pengembangan aplikasi. Dengan menggunakan SDK, Anda mendapatkan dukungan untuk pembaruan DPS di masa mendatang, termasuk pembaruan keamanan. Artikel ini menjelaskan tiga kategori SDK, mencantumkan SDK DPS yang diterbitkan dalam bahasa populer, dan menyediakan tautan ke referensi, sampel, dan mulai cepat SDK.

Penting

Manajemen sertifikat dalam IoT Hub berada dalam preview dan hanya didukung di SDK Perangkat DPS berikut: Embedded C (Bare metal, Free RTOS), C, dan Python. IoT Hub SDK tidak mendukungnya. Untuk informasi selengkapnya, lihat Apa itu Manajemen Sertifikat?

Kategori SDK

Tiga kategori kit pengembangan perangkat lunak (SDK) berfungsi dengan DPS:

  • SDK perangkat DPS menyediakan operasi sarana data untuk perangkat. Gunakan SDK perangkat untuk memprovisikan perangkat melalui DPS.

  • SDK layanan DPS menyediakan operasi sarana data untuk aplikasi backend. Gunakan SDK layanan untuk membuat dan mengelola pendaftaran individu dan grup pendaftaran, dan untuk mengkueri dan mengelola rekaman pendaftaran perangkat.

  • SDK manajemen DPS menyediakan operasi sarana kontrol untuk aplikasi backend. Gunakan SDK manajemen untuk membuat dan mengelola instans dan metadata DPS. Misalnya, gunakan untuk membuat dan mengelola instans DPS dalam langganan Anda, untuk mengunggah dan memverifikasi sertifikat dengan instans DPS, atau untuk membuat dan mengelola kebijakan otorisasi atau kebijakan alokasi dalam instans DPS.

SDK DPS membantu memprovisikan perangkat ke hub IoT Anda. Microsoft juga menyediakan sekumpulan SDK untuk membantu Anda membuat aplikasi perangkat dan aplikasi backend yang berkomunikasi langsung dengan Azure IoT Hub. Misalnya, untuk membantu perangkat yang disediakan mengirim telemetri ke hub IoT Anda, dan, secara opsional, untuk menerima pesan dan pekerjaan, metode, atau pembaruan kembar dari hub IoT Anda. Untuk mempelajari lebih lanjut, lihat SDK Azure IoT Hub.

SDK Perangkat

SDK perangkat DPS memungkinkan perangkat Anda untuk mendaftar dengan DPS dan menerima penetapan hub IoT mereka. Gunakan SDK perangkat untuk menerapkan provisi sisi perangkat dengan kunci konten, sertifikat X.509, atau pengesahan TPM. SDK perangkat platform tersedia untuk perangkat yang menjalankan sistem operasi penuh, dan SDK perangkat yang disematkan tersedia untuk perangkat yang dibatasi sumber daya dan berbasis mikrokontroler.

SDK perangkat platform

SDK perangkat DPS menyediakan implementasi Register API dan lainnya yang dipanggil perangkat untuk provisi melalui DPS. SDK perangkat dapat berjalan pada perangkat komputasi berbasis MPU umum seperti PC, tablet, smartphone, atau Raspberry Pi. SDK mendukung pengembangan dalam C dan dalam bahasa terkelola modern termasuk dalam C#, Node.js, Python, dan Java.

Tabel berikut mencantumkan SDK perangkat yang tersedia untuk setiap bahasa yang didukung.

Platform Paket Repositori kode Sampel Mulai Cepat Referensi
.NET NuGet GitHub Sampel Mulai Cepat Referensi
C apt-get, MBED, Arduino IDE atau iOS GitHub Sampel Mulai Cepat Referensi
Java Maven GitHub Sampel Mulai Cepat Referensi
Node.js npm GitHub Sampel Mulai Cepat Referensi
Python pip GitHub Sampel Mulai Cepat Referensi

Peringatan

SDK C yang tercantum di atas tidak cocok dengan aplikasi tersematkan karena manajemen memori dan model pengalurannya (threading). Untuk perangkat tersematkan, lihat SDK perangkat terisematkan.

SDK perangkat manajemen sertifikat (pratinjau)

Tabel berikut mencantumkan SDK platform yang saat ini mendukung manajemen sertifikat X.509 yang didukung Microsoft dalam pratinjau.

Bahasa Paket Sumber/Cabang Sampel
.NET NuGet Azure/azure-iot-sdk-csharp pada feature/iot-csr-preview CertificateSigningRequestSample
Python pip Azure/azure-iot-sdk-python pada feature/iot-csr-preview sampel cert-mgmt
Node.js npm Tidak tersedia Tidak tersedia
Java Maven Azure/azure-iot-sdk-java di feature/csr certificate-signing-sample
C paket Azure/azure-iot-sdk-c di feature/dps-csr-preview iothub_ll_client_sample_certificate_signing_request

SDK perangkat tersematkan

SDK ini telah dirancang dan dibuat untuk berjalan pada perangkat dengan sumber daya komputasi dan memori yang terbatas dan diimplementasikan dengan menggunakan bahasa C.

RTOS SDK Sumber Sampel Referensi
Benang GerhanaX Azure RTOS Middleware GitHub Mulai Cepat Referensi
FreeRTOS Middleware FreeRTOS GitHub Sampel Referensi
Logam Telanjang Azure SDK untuk Embedded C GitHub Sampel Referensi

Pelajari selengkapnya tentang perangkat dan SDK perangkat yang disematkan di SDK IoT.

SDK perangkat yang disematkan manajemen sertifikat (pratinjau)

Tabel berikut mencantumkan SDK tersemat yang saat ini mendukung manajemen sertifikat X.509 yang didukung Microsoft dalam pratinjau.

RTOS SDK Sumber Sampel
FreeRTOS Middleware FreeRTOS Azure/azure-iot-middleware-freertos di feature/dps-csr-preview Tidak tersedia
Logam Telanjang Azure SDK untuk Embedded C Azure/azure-sdk-for-c di feature/dps-csr-preview paho_iot_hub_csr_sample.c

SDKs Layanan

SDK layanan DPS membantu Anda membangun aplikasi backend untuk mengelola pendaftaran dan rekaman pendaftaran dalam instans DPS.

Platform Paket Repositori kode Sampel Mulai Cepat Referensi
.NET NuGet GitHub Sampel Mulai Cepat Referensi
Java Maven GitHub Sampel Mulai Cepat Referensi
Node.js npm GitHub Sampel Mulai Cepat Referensi

SDK Manajemen

SDK manajemen DPS membantu Anda membangun aplikasi backend yang mengelola instans DPS dan metadatanya dalam langganan Azure Anda.

Platform Paket Repositori kode Referensi
.NET NuGet GitHub Referensi
Java Maven GitHub Referensi
Node.js npm GitHub Referensi
Python pip GitHub Referensi

Langkah berikutnya

Dokumentasi Device Provisioning Service menyediakan tutorial dan sampel tambahan yang dapat Anda gunakan untuk mencoba SDK dan pustaka.