Come collegare e gestire hub IoT

Nella portale di Azure è possibile collegare un hub IoT dal menu a sinistra dell'istanza del servizio Device Provisioning o dalla registrazione durante la creazione o l'aggiornamento di una registrazione. In entrambi i casi, l'hub IoT ha come ambito l'istanza del servizio Device Provisioning (non solo la registrazione).

Per collegare un hub IoT all'istanza del servizio Device Provisioning nella portale di Azure:

1. Nel menu a sinistra dell'istanza del servizio Device Provisioning selezionare Hub IoT collegati.

2. Nella parte superiore della pagina selezionare + Aggiungi.

3. Nella pagina Aggiungi collegamento all'hub IoT selezionare la sottoscrizione che contiene l'hub IoT e quindi scegliere il nome dell'hub IoT dall'elenco dell'hub IoT.

4. Dopo aver selezionato l'hub IoT, scegliere un criterio di accesso che dpS userà per connettersi all'hub IoT. Nell'elenco Criteri di accesso vengono visualizzati tutti i criteri di accesso condiviso definiti nei hub IoT selezionati con autorizzazioni RegistryWrite e ServiceConnect definite. Il valore predefinito è il criterio iothubowner . Selezionare i criteri da usare.

5. Seleziona Salva.

Usare il comando az iot dps linked-hub create dell'interfaccia della riga di comando di Azure per collegare un hub IoT all'istanza del servizio Device Provisioning.

Ad esempio, il comando seguente collega un hub IoT denominato MyExampleHub usando un stringa di connessione per i criteri di accesso condiviso iothubowner. Questo comando lascia le impostazioni predefinite di Peso allocazione e Applica criterio di allocazione , ma è possibile specificare i valori per queste impostazioni se si desidera.

az iot dps linked-hub create --dps-name MyExampleDps --resource-group MyResourceGroup --connection-string "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=XNBhoasdfhqRlgGnasdfhivtshcwh4bJwe7c0RIGuWsirW0=" --location westus

Nella portale di Azure è possibile aggiornare le impostazioni Peso allocazione e Applica criterio di allocazione.

Per aggiornare le impostazioni per un hub IoT collegato usando il portale di Azure:

1. Nel menu a sinistra dell'istanza del servizio Device Provisioning selezionare Hub IoT collegati e quindi selezionare l'hub IoT dall'elenco.

2. Nella pagina Dei dettagli dell'hub IoT collegato:

   

   • Usare il dispositivo di scorrimento Peso allocazione o la casella di testo per scegliere un peso compreso tra uno e 1000. Il valore predefinito è uno.

   • Impostare l'opzione Applica criteri di allocazione per specificare se l'hub IoT collegato deve essere incluso nell'allocazione.

3. Salva le impostazioni.

Con l'interfaccia della riga di comando di Azure è possibile aggiornare le impostazioni Peso allocazione, Applica criterio di allocazione e Stringa di connessione.

Usare il comando az iot dps linked-hub update per aggiornare il peso di allocazione o applicare le impostazioni dei criteri di allocazione. Ad esempio, il comando seguente imposta il peso di allocazione e applica i criteri di allocazione per un hub IoT collegato:

az iot dps linked-hub update --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub --allocation-weight 2 --apply-allocation-policy true

Usare il comando az iot dps update per aggiornare il stringa di connessione per un hub IoT collegato. È possibile usare il --set parametro insieme al stringa di connessione per i criteri di accesso condiviso dell'hub IoT da usare. Per informazioni dettagliate, vedere Aggiornare le chiavi per gli hub IoT collegati.

Per eliminare un hub IoT collegato dall'istanza del servizio Device Provisioning nella portale di Azure:

1. Nel menu a sinistra dell'istanza del servizio Device Provisioning selezionare Hub IoT collegati.

2. Nell'elenco degli hub IoT selezionare la casella di controllo accanto all'hub IoT o agli hub IoT da eliminare. Selezionare Quindi Elimina nella parte superiore della pagina e confermare la scelta quando richiesto.

Usare il comando az iot dps linked-hub delete per rimuovere un hub IoT collegato dall'istanza del servizio Device Provisioning. Ad esempio, il comando seguente rimuove l'hub IoT denominato MyExampleHub:

az iot dps linked-hub delete --dps-name MyExampleDps --resource-group MyResourceGroup --linked-hub MyExampleHub

Non è possibile aggiornare l'impostazione stringa di connessione per un hub IoT collegato quando si usa portale di Azure. È invece necessario eliminare l'hub IoT collegato dall'istanza del servizio Device Provisioning e quindi leggerlo.

Per aggiornare le chiavi simmetriche per un hub IoT collegato nel portale di Azure:

1. Nel menu a sinistra dell'istanza del servizio Device Provisioning nella portale di Azure selezionare l'hub IoT per cui si vogliono aggiornare una o più chiavi.

2. Nella pagina Dei dettagli dell'hub IoT collegato prendere nota dei valori per Peso allocazione e Applica criterio di allocazione. Questi valori sono necessari quando si ricollega l'hub IoT all'istanza del servizio Device Provisioning in un secondo momento. Selezionare quindi Gestisci risorsa per passare all'hub IoT.

3. Nel menu a sinistra dell'hub IoT, in Impostazioni di sicurezza selezionare Criteri di accesso condiviso.

4. In Criteri di accesso condiviso, in Gestisci criteri di accesso condiviso, selezionare i criteri usati dall'istanza del servizio Device Provisioning per connettersi all'hub IoT collegato.

5. Nella parte superiore della pagina selezionare Rigenera chiave primaria, Rigenera chiave secondaria o Scambia chiavi e confermare la scelta quando richiesto.

6. Tornare all'istanza del servizio Device Provisioning.

7. Seguire la procedura descritta nella sezione Eliminare un hub IoT collegato per eliminare l'hub IoT dall'istanza del servizio Device Provisioning.

8. Seguire la procedura descritta nella sezione Aggiungere un hub IoT collegato per ricollegare l'hub IoT all'istanza del servizio Device Provisioning con il nuovo stringa di connessione per i criteri.

9. Se è necessario ripristinare il peso di allocazione e applicare le impostazioni dei criteri di allocazione, seguire la procedura descritta nella sezione Aggiornare un hub IoT collegato usando i valori salvati nel passaggio 2.

Per aggiornare le chiavi simmetriche per un hub IoT collegato con Azure CLS:

1. Usare il comando az iot hub policy renew-key per scambiare o rigenerare le chiavi simmetriche per i criteri di accesso condiviso nell'hub IoT. Ad esempio, il comando seguente rinnova la chiave primaria per i criteri di accesso condiviso iothubowner in un hub IoT:

   az iot hub policy renew-key --hub-name MyExampleHub --name owner --rk primary
   

2. Usare il comando az iot hub connection-string show per ottenere il nuovo stringa di connessione per i criteri di accesso condiviso. Ad esempio, il comando seguente ottiene il stringa di connessione primario per i criteri di accesso condiviso iothubowner per cui la chiave primaria è stata rigenerata nel comando precedente:

   az iot hub connection-string show --hub-name MyExampleHub --policy-name owner --key-type primary
   

3. Usare il comando az iot dps linked-hub list per trovare la posizione dell'hub IoT nella raccolta di hub IoT collegati per l'istanza del servizio Device Provisioning. Ad esempio, il comando seguente ottiene il stringa di connessione primario per i criteri di accesso condiviso proprietari per cui la chiave primaria è stata rigenerata nel comando precedente:

   az iot dps linked-hub list --dos-name MyExampleDps
   

   L'output mostra la posizione dell'hub IoT collegato per cui si vuole aggiornare il stringa di connessione nella tabella degli hub IoT collegati gestiti dall'istanza del servizio Device Provisioning. In questo caso, è il primo hub IoT nell'elenco MyExampleHub.

   [
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "MyExampleHub.azure-devices.net"
   },
   {
       "allocationWeight": null,
       "applyAllocationPolicy": null,
       "connectionString": "HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=****",
       "location": "centralus",
       "name": "NyExampleHub-2.azure-devices.net"
   }
   ]
   

4. Usare il comando az iot dps update per aggiornare il stringa di connessione per l'hub IoT collegato. Usare il --set parametro e la posizione dell'hub IoT collegato nella properties.iotHubs[] tabella per specificare come destinazione l'hub IoT. Ad esempio, il comando seguente aggiorna il stringa di connessione per MyExampleHub restituito per primo nel comando precedente:

   az iot dps update --name MyExampleDps --set properties.iotHubs[0].connectionString="HostName=MyExampleHub-2.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=NewTokenValue"