Tutorial: Einrichten Ihrer Umgebung für die IoT Plug & Play-Schnellstarts und -Tutorials
Bevor Sie einen der Schnellstarts und eines der Tutorials zu IoT Plug & Play durcharbeiten können, müssen Sie einen IoT Hub und den Device Provisioning Service (DPS) in Ihrem Azure-Abonnement konfigurieren. Sie benötigen auch lokale Kopien der Modelldateien, die von den Beispielanwendungen und dem Tool „Azure IoT-Explorer“ verwendet werden.
Wichtig
Dieser Artikel enthält Schritte zum Herstellen einer Verbindung mit einem Dienst mithilfe einer Shared Access Signature. Diese Authentifizierungsmethode eignet sich für Tests und Auswertungen, aber die Authentifizierung bei einem Dienst mit Microsoft Entra ID oder verwalteten Identitäten ist ein sichererer Ansatz. Weitere Informationen finden Sie unter Bewährte Methoden für die Sicherheit von IoT-Lösungen > Cloudsicherheit.
Voraussetzungen
Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
Vorbereiten der Umgebung für die Azure CLI
Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
Erstellen der Ressourcen
So erstellen Sie eine Azure-Ressourcengruppe für die Ressourcen:
az group create --name my-pnp-resourcegroup --location centralus
Erstellen Sie einen IoT Hub. Im folgenden Befehl wird der Name my-pnp-hub als Beispiel für den Namen des zu erstellenden IoT Hubs verwendet. Wählen Sie einen eindeutigen Namen für Ihren IoT Hub aus, der statt my-pnp-hub verwendet werden soll:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Erstellen Sie eine DPS-Instanz. Im folgenden Befehl wird der Name my-pnp-dps als Beispiel für den Namen der zu erstellenden DPS-Instanz verwendet. Wählen Sie einen eindeutigen Namen für Ihre DPS-Instanz aus, der statt my-pnp-dps verwendet werden soll:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Verwenden Sie die folgenden Befehle zum Verknüpfen der DPS-Instanz mit Ihrem IoT Hub. Ersetzen Sie my-pnp-dps und my-pnp-hub durch die eindeutigen Namen, die Sie zuvor gewählt haben:
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
Abrufen der Einstellungen
In einigen Schnellstarts und Tutorials wird die Verbindungszeichenfolge für Ihren IoT Hub verwendet. Sie benötigen die Verbindungszeichenfolge auch beim Einrichten des Tools „Azure IoT-Explorer“. Rufen Sie die Verbindungszeichenfolge ab, und notieren Sie sie sich. Ersetzen Sie my-pnp-hub durch den eindeutigen Namen, den Sie für Ihre IoT Hub-Instanz gewählt haben:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
In den meisten Schnellstarts und Tutorials wird der ID-Bereich Ihrer DPS-Konfiguration verwendet. Rufen Sie den ID-Bereich ab, und notieren Sie ihn sich. Ersetzen Sie my-pnp-dps durch den eindeutigen Namen, den Sie für Ihre DPS-Instanz gewählt haben:
az iot dps show --name my-pnp-dps --query properties.idScope
In allen Schnellstarts und Tutorials wird eine DPS-Geräteregistrierung verwendet. Verwenden Sie den folgenden Befehl zum Erstellen einer my-pnp-device einzelnen Geräteregistrierung in Ihrer DPS-Instanz. Ersetzen Sie my-pnp-dps durch den eindeutigen Namen, den Sie für Ihre DPS-Instanz gewählt haben. Notieren Sie sich die Registrierungs-ID und Primärschlüsselwerte, die in den Schnellstarts und Tutorials verwendet werden sollen:
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}'
Erstellen von Umgebungsvariablen
Erstellen Sie fünf Umgebungsvariablen, um die Beispiele in den Schnellstarts und Tutorials so zu konfigurieren, dass der Device Provisioning Service (DPS) zum Herstellen einer Verbindung mit Ihrem IoT Hub verwendet wird:
- IOTHUB_DEVICE_SECURITY_TYPE: der Wert
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: der DPS-ID-Bereich, den Sie sich zuvor notiert haben.
- IOTHUB_DEVICE_DPS_DEVICE_ID: der Wert
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: der Primärschlüssel für Registrierung, den Sie sich zuvor notiert haben.
- IOTHUB_DEVICE_DPS_ENDPOINT: der Wert
global.azure-devices-provisioning.net.
Die Dienstbeispiele benötigen die folgenden Umgebungsvariablen zum Identifizieren des Hubs und Geräts, mit denen eine Verbindung hergestellt werden soll:
- IOTHUB_CONNECTION_STRING: die IoT-Hub-Verbindungszeichenfolge, die Sie sich zuvor notiert haben.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Beispielsweise in einer Linux Bash-Shell:
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"
Beispielsweise in der Windows-Befehlszeile:
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
Herunterladen der Modelldateien
In den Schnellstarts und Tutorials werden Beispielmodelldateien für die Geräte Temperaturregler und Thermostat verwendet. So laden Sie die Beispielmodelldateien herunter:
Erstellen Sie auf Ihrem lokalen Computer einen Ordner mit dem Namen models.
Klicken Sie mit der rechten Maustaste auf TemperatureController.json, und speichern Sie die JSON-Datei im Ordner models.
Klicken Sie mit der rechten Maustaste auf Thermostat.json, und speichern Sie die JSON-Datei im Ordner models.
Installieren von Azure IoT-Explorer
In den Schnellstarts und Tutorials wird das Tool Azure IoT-Explorer verwendet. Navigieren Sie auf GitHub zu den Releases von Azure-IoT-Explorer, und erweitern Sie die Liste der Assets, um die neueste Version anzuzeigen. Laden Sie die neueste Version der Anwendung für Ihr Betriebssystem herunter, und installieren Sie sie.
Bei der ersten Ausführung des Tools werden Sie zur Eingabe der IoT Hub-Verbindungszeichenfolge aufgefordert. Verwenden Sie die Verbindungszeichenfolge, die Sie sich zuvor notiert haben.
Konfigurieren Sie das Tool zur Verwendung der zuvor heruntergeladenen Modelldateien. Wählen Sie auf der Startseite des Tools IoT Plug & Play-Einstellungen und dann + Hinzufügen > Lokaler Ordner aus. Wählen Sie den zuvor erstellten Ordner Modelle aus. Wählen Sie dann Speichern aus, um die Einstellungen zu speichern.
Weitere Informationen finden Sie unter Installieren und Verwenden des Azure IoT-Explorers.
Bereinigen von Ressourcen
Weil Sie den IoT Hub und die DPS-Instanz für alle IoT Plug & Play-Schnellstarts und -Tutorials verwenden können, müssen Sie die Schritte in diesem Artikel nur einmal ausführen. Wenn Sie damit fertig sind, können Sie die Ressourcen mit folgendem Befehl aus Ihrem Abonnement entfernen:
az group delete --name my-pnp-resourcegroup
Nächste Schritte
Nachdem Sie Ihre Umgebung eingerichtet haben, können Sie einen der Schnellstarts oder eines der Tutorials wie die folgenden ausprobieren: