Esercizio - Creare un'applicazione IoT Central e generare un token API

Creare un'applicazione IoT Central a cui si possono connettere i dispositivi e da cui è possibile gestirli.

Si vuole creare un'applicazione IoT Central per testare l'integrazione con l'applicazione di gestione dei negozi.

In questa unità si userà l'interfaccia della riga di comando di Azure per creare un'applicazione IoT Central dal modello Anteprima applicazione. Questo modello di applicazione abilita l'API REST di anteprima. I comandi dell'interfaccia della riga di comando verranno eseguiti nella sandbox di Azure attivata per questo modulo e poi si passerà all'interfaccia utente Web dell'applicazione. Nell'interfaccia utente Web verrà completata la configurazione generando un token API per autorizzare le chiamate all'API REST.

Installare l'estensione per l'interfaccia della riga di comando di Azure IoT

L'estensione per l'interfaccia della riga di comando azure-iot rende disponibili i comandi per gestire le risorse IoT, come le applicazioni IoT Central. Eseguire il comando seguente in Cloud Shell per installare l'estensione:

az extension add --name azure-iot

Creare e configurare l'applicazione IoT Central

La procedura seguente crea un'applicazione IoT Central e genera un token API da usare più avanti in questo modulo.

  1. Eseguire i comandi seguenti in Cloud Shell per generare un nome univoco per l'applicazione IoT Central e salvarlo in una variabile di ambiente da usare in un secondo momento:

    APP_NAME="store-manager-$RANDOM"
    echo "Your application name is: $APP_NAME"
    
    

    Prendere nota del nome dell'applicazione nel caso si verifichi il timeout della shell con conseguente perdita della variabile di ambiente.

  2. Eseguire il comando seguente in Cloud Shell per creare un'applicazione IoT Central nella sandbox:

    az iot central app create \
    --resource-group <rgn>[sandbox resource group name]</rgn> \
    --name $APP_NAME --sku ST2 --location centralus \
    --subdomain $APP_NAME --template iotc-pnp-preview@1.0.0 \
    --display-name 'Store Management'
    echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/admin/tokens"
    
    

    L'esecuzione del comando può richiedere un minuto o due.

  3. In un'altra scheda o finestra del browser passare all'URL visualizzato nell'output dell'ultimo comando. Questa pagina dell'interfaccia utente Web è la posizione in cui vengono generati i token API:

    Pagina Token API nell'interfaccia utente di IoT Central senza token visualizzati

  4. Selezionare + Genera token. Immettere admin come Nome token e assicurarsi che sia selezionato Amministratore di applicazioni come Ruolo. Selezionare quindi Genera:

    Generare un token API con il ruolo Amministratore di applicazioni nell'interfaccia utente di IoT Central

  5. Copiare il token API generato e salvarlo localmente in un file di testo. Se si perde il token, sarà necessario rigenerarlo:

    Copiare un token API generato dall'interfaccia utente di IoT Central

  6. Sostituire ADD YOUR TOKEN HERE nel comando seguente ed eseguirlo in Cloud Shell. Questo comando salva il token API in una variabile di ambiente da usare in un secondo momento nel modulo. Assicurarsi di racchiudere il token tra virgolette doppie, "...":

    API_TOKEN="ADD YOUR TOKEN HERE"
    
    
  7. Eseguire il comando seguente in Cloud Shell per visualizzare l'elenco dei ruoli definiti nell'applicazione IoT Central. Il comando aggiunge un'intestazione Authorization con il token API alla richiesta GET:

    az rest -m get -u https://$APP_NAME.azureiotcentral.com/api/preview/roles \
    --headers Authorization="$API_TOKEN"
    
    

    L'output del comando precedente mostra i ruoli definiti nell'applicazione IoT Central nell'ambiente sandbox. Viene creata un'applicazione IoT Central con tre ruoli: Operator, Administrator e Builder. Se il comando precedente restituisce un errore, verificare di aver impostato correttamente la variabile di ambiente API_TOKEN.