Tutoriel : Configurer votre environnement pour les tutoriels et les démarrages rapides IoT Plug-and-Play
Avant de pouvoir suivre des tutoriels et guides de démarrage rapide IoT Plug-and-Play, vous devez configurer un hub IoT et le service Device Provisioning (DPS) dans votre abonnement Azure. Vous aurez également besoin de copies locales des fichiers de modèle utilisés par les exemples d’applications et l’outil Explorateur Azure IoT.
Important
Cet article comprend les étapes à suivre pour se connecter à un service à l’aide d’une signature d’accès partagé. Cette méthode d’authentification est pratique pour les tests et les évaluations, mais l’authentification à un service avec Microsoft Entra ID ou des identités managées est une approche plus sécurisée. Pour plus d’informations, consultez Meilleures pratiques de sécurité > Sécurité du cloud.
Prérequis
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Préparation de votre environnement pour Azure CLI
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
Créer les ressources
Créez un groupe de ressources Azure pour les ressources :
az group create --name my-pnp-resourcegroup --location centralus
Créez un hub IoT. La commande suivante utilise le nom my-pnp-hub comme exemple de nom du hub IoT à créer. Remplacez my-pnp-hub par un nom unique de votre choix pour votre hub IoT :
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Créez une instance du service Device Provisioning (DPS). La commande suivante utilise le nom my-pnp-dps comme exemple de nom de l’instance DPS à créer. Remplacez my-pnp-dps par un nom unique de votre choix pour votre instance DPS :
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Pour lier l’instance DPS à votre hub IoT, utilisez les commandes suivantes. Remplacez my-pnp-dps et my-pnp-hub par les noms uniques choisis précédemment :
hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString
Récupérer les paramètres
Certains guides de démarrage rapide et tutoriels utilisent la chaîne de connexion pour votre hub IoT. Vous avez également besoin de la chaîne de connexion pour configurer l’outil Explorateur Azure IoT. Récupérez la chaîne de connexion et notez-la. Remplacez my-pnp-hub par le nom unique choisi pour votre hub IoT :
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
La plupart des guides de démarrage rapide et des tutoriels utilisent l’Étendue de l’ID configurée pour le service Device Provisioning. Récupérez la valeur de l’étendue de l’ID et notez-la. Remplacez my-pnp-dps par le nom unique choisi pour votre instance DPS :
az iot dps show --name my-pnp-dps --query properties.idScope
Tous les guides de démarrage rapide et les tutoriels utilisent une inscription d’appareil DPS. Utilisez la commande suivante pour créer une inscription d’appareil individuel my-pnp-device dans votre instance DPS. Remplacez my-pnp-dps par le nom unique choisi pour votre instance DPS. Notez l’ID de l’inscription et la valeur de clé primaire à utiliser dans les tutoriels et les guides de démarrage rapide :
az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'
Créer des variables d’environnement
Créez cinq variables d’environnement pour configurer les exemples dans les tutoriels et les guides de démarrage rapide afin qu’ils utilisent le service Device Provisioning (DPS) pour se connecter à votre hub IoT :
- IOTHUB_DEVICE_SECURITY_TYPE : la valeur
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE : l’étendue de l’ID du service DPS que vous avez notée précédemment.
- IOTHUB_DEVICE_DPS_DEVICE_ID : la valeur
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY : la clé primaire d’inscription que vous avez notée précédemment.
- IOTHUB_DEVICE_DPS_ENDPOINT : la valeur
global.azure-devices-provisioning.net
Les exemples du service nécessitent les variables d’environnement suivantes pour identifier le hub et l’appareil auxquels se connecter :
- IOTHUB_CONNECTION_STRING : la chaîne de connexion de hub IoT que vous avez notée précédemment.
- IOTHUB_DEVICE_ID :
my-pnp-device.
Par exemple, dans un interpréteur de commandes Bash Linux :
export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"
Par exemple, sur la ligne de commande Windows :
set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device
Télécharger les fichiers de modèle
Les guides de démarrage rapide et les tutoriels utilisent des exemples de fichiers de modèle pour les appareils à thermostat ou de contrôle de température. Pour télécharger les exemples de fichiers de modèle :
Créez un dossier nommé models sur votre ordinateur local.
Cliquez avec le bouton droit sur TemperatureController.json et enregistrez le fichier JSON dans le dossier models.
Cliquez avec le bouton droit sur Thermostat.json et enregistrez le fichier JSON dans le dossier models.
Installer l’explorateur Azure IoT
Les guides de démarrage rapide et les tutoriels utilisent l’outil Explorateur Azure IoT. Accédez aux versions de l’explorateur Azure IOT et développez la liste des ressources pour la version la plus récente. Téléchargez et installez la version la plus récente de l’application pour votre système d’exploitation.
La première fois que vous exécutez l’outil, vous êtes invité à entrer la chaîne de connexion du hub IoT. Utilisez la chaîne de connexion que vous avez notée précédemment.
Configurez l’outil pour utiliser les fichiers de modèle précédemment téléchargés. Dans la page d’accueil de l’outil, sélectionnez Paramètres IoT Plug-and-Play, puis + Ajouter > Dossier local. Sélectionnez le dossier de modèles que vous avez créé précédemment. Sélectionnez ensuite Enregistrer pour enregistrer les paramètres.
Pour plus d’informations, consultez Installer et utiliser l’explorateur Azure IoT.
Nettoyer les ressources
Vous pouvez utiliser le hub IoT et l’instance DPS pour l’ensemble des tutoriels et des guides de démarrage rapide IoT Plug-and-Play. Ainsi, il vous suffit d’effectuer les étapes de cet article une seule fois. Quand vous avez terminé, vous pouvez supprimer les ressources de votre abonnement à l’aide de la commande suivante :
az group delete --name my-pnp-resourcegroup
Étapes suivantes
Maintenant que vous avez configuré votre environnement, vous pouvez essayer l’un des guides de démarrage rapide ou tutoriels, comme celui-ci :