Zelfstudie: Uw omgeving instellen voor de IoT-Plug en Play quickstarts en zelfstudies
Voordat u een van de quickstarts en zelfstudies voor IoT Plug en Play kunt voltooien, moet u een IoT-hub en de Device Provisioning Service (DPS) configureren in uw Azure-abonnement. U hebt ook lokale kopieën nodig van de modelbestanden die worden gebruikt door de voorbeeldtoepassingen en het hulpprogramma Azure IoT Explorer.
Belangrijk
Dit artikel bevat stappen voor het maken van verbinding met een service met behulp van een handtekening voor gedeelde toegang. Deze verificatiemethode is handig voor testen en evalueren, maar verificatie bij een service met Microsoft Entra ID of beheerde identiteiten is een veiligere benadering. Zie Best practices > voor beveiliging voor cloudbeveiliging voor meer informatie.
Vereisten
Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.
De omgeving voorbereiden op de Azure CLI
Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
De resources maken
Maak een Azure-resourcegroep voor de resources:
az group create --name my-pnp-resourcegroup --location centralus
Maak een IoT-hub. De volgende opdracht gebruikt de naam my-pnp-hub als voorbeeld voor de naam van de IoT-hub die moet worden gemaakt. Kies een unieke naam voor uw IoT-hub die u wilt gebruiken in plaats van my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Maak een DPS-exemplaar. De volgende opdracht gebruikt de naam my-pnp-dps als voorbeeld voor de naam van het DPS-exemplaar om te maken. Kies een unieke naam voor uw DPS-exemplaar dat u wilt gebruiken in plaats van my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Gebruik de volgende opdrachten om het DPS-exemplaar aan uw IoT-hub te koppelen. Vervang en my-pnp-hub door my-pnp-dps de unieke namen die u eerder hebt gekozen:
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
De instellingen ophalen
Sommige quickstarts en zelfstudies gebruiken de verbindingsreeks voor uw IoT-hub. U hebt ook het verbindingsreeks nodig wanneer u het hulpprogramma Azure IoT Explorer instelt. Haal de verbindingsreeks op en noteer deze nu. Vervang door my-pnp-hub de unieke naam die u hebt gekozen voor uw IoT-hub:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
De meeste quickstarts en zelfstudies gebruiken het id-bereik van uw DPS-configuratie. Haal het id-bereik op en noteer het nu. Vervang door my-pnp-dps de unieke naam die u hebt gekozen voor uw DPS-exemplaar:
az iot dps show --name my-pnp-dps --query properties.idScope
Alle quickstarts en zelfstudies maken gebruik van een DPS-apparaatinschrijving. Gebruik de volgende opdracht om een my-pnp-device afzonderlijke apparaatinschrijving te maken in uw DPS-exemplaar. Vervang door my-pnp-dps de unieke naam die u hebt gekozen voor uw DPS-exemplaar. Noteer de registratie-id en de primaire-sleutelwaarden die u in de quickstarts en zelfstudies wilt gebruiken:
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}'
Omgevingsvariabelen maken
Maak vijf omgevingsvariabelen om de voorbeelden in de quickstarts en zelfstudies te configureren voor het gebruik van Device Provisioning Service (DPS) om verbinding te maken met uw IoT-hub:
- IOTHUB_DEVICE_SECURITY_TYPE: de waarde
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: het DPS-id-bereik dat u eerder hebt genoteerd.
- IOTHUB_DEVICE_DPS_DEVICE_ID: de waarde
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: de primaire inschrijvingssleutel die u eerder hebt genoteerd.
- IOTHUB_DEVICE_DPS_ENDPOINT: de waarde
global.azure-devices-provisioning.net
De servicevoorbeelden hebben de volgende omgevingsvariabelen nodig om de hub en het apparaat te identificeren waarmee verbinding moet worden gemaakt:
- IOTHUB_CONNECTION_STRING: de verbindingsreeks voor de IoT-hub die u eerder hebt genoteerd.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Bijvoorbeeld in een 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"
Bijvoorbeeld op de Windows-opdrachtregel:
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
De modelbestanden downloaden
In de quickstarts en zelfstudies worden voorbeeldmodelbestanden gebruikt voor de temperatuurcontroller- en thermostaatapparaten. De voorbeeldmodelbestanden downloaden:
Maak een map models op uw lokale computer.
Klik met de rechtermuisknop op TemperatureController.json en sla het JSON-bestand op in de map models.
Klik met de rechtermuisknop op Thermostat.json en sla het JSON-bestand op in de map models.
Azure IoT Explorer installeren
In de quickstarts en zelfstudies wordt het hulpprogramma Azure IoT Explorer gebruikt. Ga naar Azure IoT Explorer-releases en vouw de lijst met assets uit voor de meest recente release. Download en installeer de meest recente versie van de toepassing voor uw besturingssysteem.
De eerste keer dat u het hulpprogramma uitvoert, wordt u gevraagd om de IoT-hub verbindingsreeks. Gebruik de verbindingsreeks die u eerder hebt genoteerd.
Configureer het hulpprogramma voor het gebruik van de modelbestanden die u eerder hebt gedownload. Selecteer op de startpagina van het hulpprogramma IoT Plug en Play Settings en vervolgens + Lokale map toevoegen>. Selecteer de map modellen die u eerder hebt gemaakt. Selecteer Vervolgens Opslaan om de instellingen op te slaan.
Zie Azure IoT Explorer installeren en gebruiken voor meer informatie.
Resources opschonen
U kunt het IoT-hub- en DPS-exemplaar gebruiken voor alle quickstarts en zelfstudies voor IoT Plug en Play, dus u hoeft de stappen in dit artikel slechts één keer uit te voeren. Wanneer u klaar bent, kunt u deze verwijderen uit uw abonnement met de volgende opdracht:
az group delete --name my-pnp-resourcegroup
Volgende stappen
Nu u uw omgeving hebt ingesteld, kunt u een van de quickstarts of zelfstudies proberen, zoals: