Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Gli SDK Microsoft per il servizio Device Provisioning in hub IoT 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 nell'hub IoT è in anteprima ed è supportata solo negli SDK per dispositivi DPS seguenti: Embedded C (Bare metal, Free RTOS), C e Python. Gli SDK degli IoT Hub 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 offre 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, tra cui 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 | Esempi | Guida introduttiva | Riferimento |
| A | apt-get, MBED, IDE Arduino o iOS | GitHub | Esempi | Guida introduttiva | Riferimento |
| Java | Maven | GitHub | Esempi | Guida introduttiva | Riferimento |
| Node.js | npm | GitHub | Esempi | Guida introduttiva | Riferimento |
| Python | pip | GitHub | Esempi | 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)
Per gli SDK che supportano la gestione dei certificati X.509 supportata da Microsoft in anteprima, usare le istruzioni e gli esempi seguenti.
| Piattaforma | Disposizioni | Sample |
|---|---|---|
| A | Istruzioni | Esempio |
| Python | Istruzioni | Esempio |
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 | Azure RTOS Middleware | GitHub | Avvio rapido | Riferimento |
| FreeRTOS | FreeRTOS Middleware | GitHub | Esempi | Riferimento |
| Metallo nudo | Azure SDK per Embedded C | GitHub | Esempi | Riferimento |
Altre informazioni sugli SDK per dispositivi e dispositivi incorporati negli SDK IoT.
SDK per dispositivi incorporati per la gestione dei certificati (anteprima)
Per gli SDK incorporati che supportano la gestione dei certificati X.509 supportata da Microsoft in anteprima, usare le istruzioni e gli esempi seguenti:
| RTOS | SDK | Disposizioni | Sample |
|---|---|---|---|
| FreeRTOS | FreeRTOS Middleware | Istruzioni | Esempio |
| Metallo nudo | Azure SDK per Embedded C | Istruzioni | Esempio |
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 | Esempi | Guida introduttiva | Riferimento |
| Java | Maven | GitHub | Esempi | Guida introduttiva | Riferimento |
| Node.js | npm | GitHub | Esempi | 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 di 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.