SDK di Microsoft per hub IoT servizio Device Provisioning

Gli SDK di Microsoft per hub IoT servizio Device Provisioning consentono di creare applicazioni back-end e dispositivi che eseguono il provisioning di dispositivi IoT in uno o più hub IoT. Gli SDK gestiscono i protocolli di trasporto e sicurezza sottostanti tra dispositivi o app back-end e DPS, consentendo di concentrarsi sullo sviluppo di applicazioni. Usando gli SDK, si ottiene il supporto per gli aggiornamenti futuri del servizio Device Provisioning, inclusi gli aggiornamenti della sicurezza. Questo articolo descrive le tre categorie di SDK, elenca gli SDK dps pubblicati nei linguaggi più diffusi e fornisce collegamenti a riferimenti, esempi e guide introduttive all'SDK.

Importante

La gestione dei certificati in hub IoT si trova in preview ed è supportata solo negli SDK per dispositivi DPS seguenti: Embedded C (Bare metal, Free RTOS), C e Python. hub IoT SDK non lo supportano. Per altre informazioni, vedere Che cos'è Gestione certificati?

Categorie SDK

Tre categorie di sdk (Software Development Kit) funzionano con DPS:

  • Gli SDK per dispositivi del servizio Device Provisioning forniscono operazioni del piano dati per i dispositivi. Usare l'SDK del dispositivo per effettuare il provisioning di un dispositivo tramite DPS.

  • Gli SDK del servizio Device Provisioning forniscono operazioni del piano dati per le app back-end. Usare gli SDK del servizio per creare e gestire registrazioni e gruppi di registrazione individuali e per eseguire query e gestire i record di registrazione dei dispositivi.

  • Gli SDK di gestione del servizio Device Provisioning forniscono operazioni del piano di controllo per le app back-end. Usare gli SDK di gestione per creare e gestire istanze e metadati del servizio Device Provisioning. Ad esempio, usarli per creare e gestire istanze dps nella sottoscrizione, per caricare e verificare i certificati con un'istanza del servizio Device Provisioning o per creare e gestire criteri di autorizzazione o criteri di allocazione in un'istanza del servizio Device Provisioning.

Gli SDK del servizio Device Provisioning consentono di effettuare il provisioning dei dispositivi negli hub IoT. Microsoft fornisce anche un set di SDK che consentono di creare app per dispositivi e app back-end che comunicano direttamente con hub IoT di Azure. Ad esempio, per consentire ai dispositivi di cui è stato effettuato il provisioning di inviare dati di telemetria all'hub IoT e, facoltativamente, per ricevere messaggi e processi, metodi o aggiornamenti gemelli dall'hub IoT. Per altre informazioni, vedere hub IoT di Azure SDK.

SDK del dispositivo

Gli SDK per dispositivi DPS consentono ai dispositivi di registrarsi con dps e ricevere l'assegnazione dell'hub IoT. Usare gli SDK per dispositivi per implementare il provisioning lato dispositivo con chiave simmetrica, certificato X.509 o attestazione TPM. Gli SDK per dispositivi della piattaforma sono disponibili per i dispositivi che eseguono un sistema operativo completo e gli SDK dei dispositivi incorporati sono disponibili per i dispositivi basati su microcontroller e vincolati alle risorse.

SDK per dispositivi della piattaforma

Gli SDK per dispositivi DPS forniscono implementazioni dell'API Register e di altri dispositivi che chiamano per effettuare il provisioning tramite DPS. Gli SDK per i dispositivi possono essere eseguiti su dispositivi di elaborazione basati su MPU generici, ad esempio PC, tablet, smartphone o Raspberry Pi. Gli SDK supportano lo sviluppo in C e nei linguaggi gestiti moderni, inclusi in C#, Node.js, Python e Java.

La tabella seguente elenca gli SDK per dispositivi disponibili per ogni lingua supportata.

Piattaforma Pacchetto Repository di codice Esempi Guida introduttiva Riferimento
.NET NuGet GitHub Samples Guida introduttiva Riferimento
A apt-get, MBED, IDE Arduino o iOS GitHub Samples Guida introduttiva Riferimento
Java Maven GitHub Samples Guida introduttiva Riferimento
Node.js npm GitHub Samples Guida introduttiva Riferimento
Python pip GitHub Samples Guida introduttiva Riferimento

Avviso

L'SDKC elencato in precedenza non è adatto per le applicazioni incorporate a causa della gestione della memoria e del modello di threading. Per i dispositivi incorporati, fare riferimento agli SDK per dispositivi incorporati.

SDK per dispositivi di gestione certificati (anteprima)

La tabella seguente elenca gli SDK della piattaforma che supportano attualmente la gestione dei certificati X.509 supportata Microsoft in anteprima.

Lingua Pacchetto Origine/Ramo Esempi
.NET NuGet Azure/azure-iot-sdk-csharp in feature/iot-csr-preview CertificateSigningRequestSample
Python pip Azure/azure-iot-sdk-python in feature/iot-csr-preview esempi di cert-mgmt
Node.js npm Non disponibile Non disponibile
Java Maven Azure/azure-iot-sdk-java in feature/csr certificate-signing-sample
A packages Azure/azure-iot-sdk-c in feature/dps-csr-preview iothub_ll_client_sample_certificate_signing_request

SDK per i dispositivi integrati

Questi SDK sono stati progettati e creati per l'esecuzione su dispositivi con risorse di calcolo e memoria limitate e vengono implementati usando il linguaggio C.

RTOS SDK Origine Esempi Riferimento
Eclipse ThreadX middleware Azure RTOS GitHub Avvio rapido Riferimento
FreeRTOS FreeRTOS Middleware GitHub Samples Riferimento
Metallo nudo Azure SDK per Embedded C GitHub Samples Riferimento

Altre informazioni sugli SDK per dispositivi e dispositivi incorporati negli SDK IoT.

SDK per dispositivi incorporati per la gestione dei certificati (anteprima)

Nella tabella seguente sono elencati gli SDK incorporati che supportano attualmente la gestione dei certificati X.509 Microsoft supportata in anteprima.

RTOS SDK Origine Esempi
FreeRTOS FreeRTOS Middleware Azure/azure-iot-middleware-freertos in feature/dps-csr-preview Non disponibile
Metallo nudo Azure SDK per Embedded C Azure/azure-sdk-for-c in feature/dps-csr-preview paho_iot_hub_csr_sample.c

SDK per servizi

Gli SDK del servizio Device Provisioning consentono di creare applicazioni back-end per gestire le registrazioni e i record di registrazione nelle istanze del servizio Device Provisioning.

Piattaforma Pacchetto Repository di codice Esempi Guida introduttiva Riferimento
.NET NuGet GitHub Samples Guida introduttiva Riferimento
Java Maven GitHub Samples Guida introduttiva Riferimento
Node.js npm GitHub Samples Guida introduttiva Riferimento

SDK di gestione

Gli SDK di gestione dps consentono di creare applicazioni back-end che gestiscono le istanze del servizio Device Provisioning e i relativi metadati nella sottoscrizione Azure.

Piattaforma Pacchetto Repository di codice Riferimento
.NET NuGet GitHub Riferimento
Java Maven GitHub Riferimento
Node.js npm GitHub Riferimento
Python pip GitHub Riferimento

Passaggi successivi

La documentazione del servizio Device Provisioning fornisce esercitazioni ed esempi aggiuntivi che è possibile usare per provare gli SDK e le librerie.