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.
Creare un'identità del dispositivo per connetterlo all'hub IoT di Azure. Questo articolo presenta le attività principali per la gestione di un'identità del dispositivo, inclusa la registrazione del dispositivo, la raccolta delle informazioni di connessione e l'eliminazione o la disabilitazione di un dispositivo alla fine del ciclo di vita.
Prerequisiti
Un hub IoT nella sottoscrizione di Azure. Se non si ha ancora un hub, è possibile seguire la procedura descritta in Creare un hub IoT.
A seconda dello strumento usato, è possibile accedere al portale di Azure o installare l'interfaccia della riga di comando di Azure.
Se l'hub IoT viene gestito con il controllo degli accessi in base al ruolo, sono necessarie autorizzazioni di lettura/scrittura/eliminazione di dispositivi/moduli per i passaggi descritti in questo articolo. Tali autorizzazioni sono incluse nel ruolo Collaboratore del Registro di sistema dell'hub IoT .
Prepara i certificati
I dispositivi usano due tipi diversi di certificati per connettersi a hub IoT. Quando si prepara il dispositivo, assicurarsi di avere tutti i certificati appropriati creati e aggiunti al dispositivo prima della connessione.
- Certificati radice pubblici: tutti i dispositivi necessitano di una copia dei certificati radice pubblici che hub IoT, IoT Central e il servizio Device Provisioning usano per autorizzare le connessioni.
- Certificati di autenticazione: i certificati X.509 sono il metodo consigliato per l'autenticazione di un'identità del dispositivo.
Certificati radice pubblici necessari
I dispositivi Azure IoT usano il protocollo TLS per verificare l'autenticità dell'hub IoT o dell'endpoint DPS a cui si connettono. Ogni dispositivo richiede una copia del certificato radice utilizzato da hub IoT e DPS. Raccomandiamo che tutti i dispositivi includano le seguenti CA radice nel proprio archivio dei certificati attendibili:
- DigiCert Global G2 root CA
- Microsoft RSA root CA 2017
Per altre informazioni sulle procedure consigliate per i certificati dell'hub IoT, vedere Supporto di Transport Layer Security (TLS) nell'hub IoT.
Certificati di autenticazione
Se si usa l'autenticazione del certificato X.509 per i dispositivi, assicurarsi che i certificati siano pronti prima di registrare un dispositivo:
Per i certificati firmati dalla CA, l'esercitazione Creare e caricare certificati per i test offre una buona introduzione sulla modalità di creazione di certificati firmati dalla CA e sul loro caricamento nell'hub IoT. Dopo aver completato il tutorial, sarai pronto per registrare un dispositivo con l'autenticazione tramite certificato X.509 firmato da un'autorità di certificazione.
Per i certificati autofirmati, sono necessari due certificati del dispositivo (un certificato primario e uno secondario) nel dispositivo e le identificazioni personali per entrambi per caricarli nell'hub IoT. Un modo per recuperare l'impronta digitale da un certificato è usare il seguente comando OpenSSL:
openssl x509 -in <certificate filename>.pem -text -fingerprint
Registrazione di un dispositivo
In questa sezione si creerà un'identità del dispositivo nel registro delle identità dell'hub IoT. Un dispositivo non può connettersi a un hub a meno che non abbia un'identità del dispositivo.
Il registro di identità dell'hub IoT archivia solo le identità del dispositivo per abilitare l'accesso sicuro all'hub. Archivia gli ID dispositivo e le chiavi da usare come credenziali di sicurezza e un flag di attivazione/disattivazione che consente di disabilitare l'accesso per un singolo dispositivo.
Quando si registra un dispositivo, si sceglie il metodo di autenticazione. L'hub IoT supporta tre metodi per l'autenticazione del dispositivo:
Chiave simmetrica - Questa opzione è più semplice per gli scenari di avvio rapido.
Quando si registra un dispositivo, è possibile fornire chiavi o l'hub IoT genera automaticamente le chiavi. Sia il dispositivo che l'hub IoT hanno una copia della chiave simmetrica che può essere confrontata quando il dispositivo si connette.
X.509 autofirmato
Se il dispositivo ha un certificato X.509 autofirmato, è necessario assegnare all'hub IoT una versione del certificato per l'autenticazione. Quando si registra un dispositivo, si carica l'impronta digitale del certificato, ovvero un hash del certificato X.509 del dispositivo. Quando il dispositivo si connette, presenta il certificato e l'hub IoT può convalidarlo rispetto all'hash noto. Per altre informazioni, vedere Autenticare le identità con certificati X.509.
X.509 firmato da una CA - Questa opzione è consigliata per gli ambienti di produzione.
Se il dispositivo dispone di un certificato X.509 firmato da una CA, devi caricare in hub IoT un certificato radice o intermedio della CA nella catena di certificazione prima di registrare il dispositivo. Il dispositivo dispone di un certificato X.509 con la CA X.509 verificata nella sua catena di attendibilità dei certificati. Quando il dispositivo si connette, presenta la catena di certificati completa e l'hub IoT può convalidarlo perché conosce la CA X.509. Più dispositivi possono eseguire l'autenticazione con la stessa CA X.509 verificata. Per altre informazioni, vedere Autenticare le identità con certificati X.509.
Aggiungere un dispositivo
Creare un'identità del dispositivo nell'hub IoT.
Nel portale di Azure passare all'hub IoT.
Selezionare Gestione dispositivi>Dispositivi.
Selezionare Aggiungi dispositivo per aggiungere un dispositivo nell'hub IoT.
In Creare un dispositivospecificare le informazioni per la nuova identità del dispositivo:
Parametro Parametro dipendente Valore ID dispositivo Specificare un nome per il nuovo dispositivo. Tipo di autenticazione Selezionare chiave simmetrica, X.509 autofirmato o X.509 firmato dall'autorità di certificazione. Generare chiavi automaticamente Per l'autenticazione con chiave simmetrica, selezionare questa casella per fare in modo che l'hub IoT generi le chiavi per il dispositivo. In alternativa, deselezionare questa casella e fornire chiavi primarie e secondarie per il dispositivo. Impronta digitale primaria e Impronta digitale secondaria Per l'autenticazione X.509 con certificato autofirmato, fornire l'hash dell'impronta digitale dei certificati primario e secondario del dispositivo. Importante
L'ID dispositivo può essere visibile nei log raccolti per il supporto tecnico e la risoluzione dei problemi, quindi evitare di includere informazioni sensibili nel nome assegnato.
Seleziona Salva. Dopo la creazione del dispositivo, si apre la sua pagina dettagli.
Per dispositivi a chiave simmetrica, puoi copiare le informazioni di connessione da questa pagina per un uso immediato in campioni e scenari di test. Conserva chiavi e stringhe di connessione in modo sicuro.
Note
L'elenco predefinito dei dispositivi mostra fino a 15 dispositivi, non l'inventario completo dei dispositivi. Per trovare un altro dispositivo, cerca per ID dispositivo, applica un filtro o usa Query sotto Gestione Dispositivi. I risultati di ricerca, filtro e query diventano infine coerenti, quindi un dispositivo appena creato potrebbe non apparire immediatamente. Un risultato mancante non significa necessariamente che la registrazione sia stata fallita.
Per verificare la registrazione di un ID dispositivo noto, usa Ottenere Identità. Le identità appena create possono anche richiedere alcuni secondi per diventare disponibili tramite una lettura diretta. Per maggiori informazioni, vedi Operazioni del registro dell'identità e limitazioni delle query Twin.
Recuperare la stringa di connessione del dispositivo
Per esempi e scenari di test, il metodo di connessione più comune consiste nell'usare l'autenticazione con chiave simmetrica e connettersi con una stringa di connessione del dispositivo. Una stringa di connessione del dispositivo contiene il nome dell'hub IoT, il nome del dispositivo e le informazioni di autenticazione del dispositivo.
Per informazioni su altri metodi per la connessione dei dispositivi, in particolare per l'autenticazione X.509, vedere SDK per dispositivi dell'hub IoT di Azure.
Usare la procedura seguente per recuperare una stringa di connessione del dispositivo.
Il portale di Azure fornisce stringhe di connessione del dispositivo solo per i dispositivi che usano l'autenticazione con chiave simmetrica.
Nel portale di Azure passare all'hub IoT.
Selezionare Gestione dispositivi>Dispositivi.
Trova il tuo dispositivo nel pannello Dispositivi e seleziona il suo ID dispositivo. Se non viene visualizzato, inserisci il suo ID dispositivo nella casella di ricerca.
La lista predefinita non corrisponde all'inventario completo e i risultati di ricerca possono essere in ritardo rispetto ai cambiamenti recenti. Per maggiori informazioni su come trovare dispositivi e visualizzare i loro gemelli, vedi Visualizza e aggiorna i gemelli dei dispositivi.
Copiare il valore della stringa di connessione primaria.
Per impostazione predefinita, le chiavi e le stringhe di connessione vengono mascherate perché sono informazioni riservate. Se si seleziona l'icona a forma di occhio, vengono rivelati. Non è necessario rivelarle per copiarle con il pulsante Copia.
I dispositivi con autenticazione con chiave simmetrica hanno una stringa di connessione del dispositivo con il modello seguente:
HostName=<IOT_HUB_NAME>;DeviceId=<DEVICE_NAME>;SharedAccessKey=<PRIMARY_OR_SECONDARY_KEY>
I dispositivi con autenticazione X.509, autofirmato o firmato dalla CA, in genere non usano stringhe di connessione del dispositivo per l'autenticazione. Quando ciò accade, le stringhe di connessione seguono lo schema seguente:
HostName=<IOT_HUB_NAME>;DeviceId=<DEVICE_NAME>;x509=true
Disabilitare o eliminare un dispositivo
Se si vuole mantenere un dispositivo nel registro delle identità dell'hub IoT, ma si vuole impedire la connessione, è possibile impostarne lo stato su disabilitato.
Nel portale di Azure passare all'hub IoT.
Selezionare Gestione dispositivi>Dispositivi.
Trova il tuo dispositivo nel pannello Dispositivi e seleziona il suo ID dispositivo. Se non viene visualizzato, inserisci il suo ID dispositivo nella casella di ricerca.
La lista predefinita non corrisponde all'inventario completo e i risultati di ricerca possono essere in ritardo rispetto ai cambiamenti recenti. Per maggiori informazioni su come trovare dispositivi e visualizzare i loro gemelli, vedi Visualizza e aggiorna i gemelli dei dispositivi.
Nella pagina dei dettagli del dispositivo è possibile disabilitare o eliminare la registrazione del dispositivo.
Per impedire la connessione di un dispositivo, impostare il parametro Abilita connessione all'hub IoT su Disabilita.
Per rimuovere completamente un dispositivo dal registro delle identità dell'hub IoT, selezionare Elimina.
Altri strumenti per la gestione delle identità dei dispositivi
È possibile usare altri strumenti o interfacce per gestire il registro delle identità dell'hub IoT, tra cui:
Comandi di PowerShell: fare riferimento al set di comandi Az.IotHub per informazioni su come gestire le identità dei dispositivi.
Visual Studio Code: l'estensione hub IoT di Azure per Visual Studio Code include funzionalità del registro delle identità.
API REST: fare riferimento alle API del servizio hub IoT per informazioni su come gestire le identità dei dispositivi.