Rychlý start: Zřízení simulovaného zařízení symetrického klíče

V tomto rychlém startu vytvoříte na počítači s Windows simulované zařízení. Simulované zařízení je nakonfigurované tak, aby pro ověřování používalo mechanismus ověření symetrického klíče. Jakmile nakonfigurujete zařízení, zřídíte ho pro centrum IoT pomocí služby Azure IoT Hub Device Provisioning.

Pokud neznáte proces zřizování, projděte si přehled zřizování .

Tento rychlý start ukazuje řešení pro pracovní stanici se systémem Windows. Můžete ale také provádět postupy v Linuxu. Příklad Linuxu najdete v tématu Kurz: Zřízení geografické latence.

Požadavky

• Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

• Dokončete kroky v rychlém startu: Nastavení služby IoT Hub Device Provisioning pomocí webu Azure Portal.

• Pokud používáte vývojové prostředí Windows, nainstalujte sadu Visual Studio 2019 nebo novější s povolenou úlohou Vývoj desktopů s C++ . Podporují se také sady Visual Studio 2015 a Visual Studio 2017. Informace o Linuxu nebo macOS najdete v příslušné části Přípravy vývojového prostředí v dokumentaci k sadě SDK.

• Nainstalujte na počítač se systémem Windows sadu .NET SDK 6.0 nebo novější. Ke kontrole verze můžete použít následující příkaz.

  dotnet --info
  

• Nainstalujte Node.js verze 4.0 nebo novější.

• Nainstalujte Python 3.7 nebo novější nainstalovaný na počítači s Windows. Verzi Pythonu můžete zkontrolovat spuštěním python --versionpříkazu .

• Nainstalujte na počítač sadu Java SE Development Kit 8 nebo novější.

• Stáhněte a nainstalujte Maven.

• Nainstalujte nejnovější verzi Git. Ujistěte se, že je Git přidaný do proměnných prostředí, které jsou přístupné pro příkazové okno. Nejnovější git Gitu společnosti Software Freedom Conservancy.

Příprava vývojového prostředí

V této části připravíte vývojové prostředí, které se používá k sestavení sady Azure IoT C SDK. Vzorový kód se pokusí zřídit zařízení během spouštěcí sekvence zařízení.

1. Stáhněte si nejnovější systém sestavení CMake.

   Důležité

   Před zahájením instalace ověřte, že jsou na vašem počítači nainstalované požadavky sady Visual Studio (Visual Studio a úloha Vývoj desktopových aplikací pomocí jazyka CMake C++). Jakmile jsou požadované součásti k dispozici a stažený soubor je ověřený, nainstalujte sestavovací systém CMake. Starší verze systému sestavení CMake také negenerují soubor řešení použitý v tomto článku. Ujistěte se, že používáte nejnovější verzi CMake.

2. Otevřete webový prohlížeč a přejděte na stránku vydání sady Azure IoT C SDK.

3. Vyberte kartu Značky v horní části stránky.

4. Zkopírujte název značky pro nejnovější verzi sady Azure IoT C SDK.

5. Otevřete prostředí příkazového řádku nebo Git Bash. Spuštěním následujících příkazů naklonujte nejnovější verzi sady Azure IoT Device SDK pro úložiště GitHub pro C . Nahraďte <release-tag> značkou, kterou jste zkopírovali v předchozím kroku, například: lts_03_2025.

   git clone -b <release-tag> https://github.com/Azure/azure-iot-sdk-c.git
   cd azure-iot-sdk-c
   git submodule update --init
   

   Dokončení této operace může trvat několik minut.

6. Po dokončení operace spusťte z azure-iot-sdk-c adresáře následující příkazy:

   mkdir cmake
   cd cmake
   

7. Ukázka kódu používá symetrický klíč k zajištění ověření identity. Spuštěním následujícího příkazu sestavte verzi sady SDK specifickou pro vaši vývojovou klientskou platformu, která zahrnuje klienta zřizování zařízení:

   cmake -Dhsm_type_symm_key:BOOL=ON -Duse_prov_client:BOOL=ON  ..
   

   Tip

   Pokud cmake kompilátor C++ nenajdete, může se při spuštění předchozího příkazu zobrazit chyby sestavení. Pokud k tomu dojde, zkuste příkaz spustit v příkazovém řádku sady Visual Studio.

8. Po úspěšném dokončení sestavení vypadá posledních několik výstupních řádků podobně jako následující výstup:

   $ cmake -Dhsm_type_symm_key:BOOL=ON -Duse_prov_client:BOOL=ON  ..
   -- Building for: Visual Studio 16 2019
   -- Selecting Windows SDK version 10.0.19041.0 to target Windows 10.0.19042.
   -- The C compiler identification is MSVC 19.29.30040.0
   -- The CXX compiler identification is MSVC 19.29.30040.0
   
   ...
   
   -- Configuring done
   -- Generating done
   -- Build files have been written to: E:/IoT Testing/azure-iot-sdk-c/cmake
   

1. Otevřete prostředí příkazového řádku Gitu nebo Git Bash.

2. Naklonujte úložiště Azure IoT SDK pro .NET Na GitHubu pomocí následujícího příkazu:

   git clone https://github.com/Azure/azure-iot-sdk-csharp.git
   

1. Otevřete prostředí příkazového řádku Gitu nebo Git Bash.

2. Naklonujte úložiště GitHub sady Azure IoT Node.js SDK pomocí následujícího příkazu:

   git clone https://github.com/Azure/azure-iot-sdk-node.git --recursive
   

1. Otevřete prostředí příkazového řádku Gitu nebo Git Bash.

2. Naklonujte Azure IoT Python SDK úložiště GitHub pomocí následujícího příkazu:

   git clone -b v2 https://github.com/Azure/azure-iot-sdk-python.git --recursive
   

   Poznámka:

   Ukázky použité v tomto kurzu jsou ve větvi v2 úložiště azure-iot-sdk-python. Větev sady Python SDK verze 3 je k dispozici pro použití v beta verzi.

1. Otevřete prostředí příkazového řádku Gitu nebo Git Bash.

2. Naklonujte úložiště Azure IoT SDK pro GitHub pro Javu pomocí následujícího příkazu:

   git clone https://github.com/Azure/azure-iot-sdk-java.git --recursive
   

3. Přejděte do kořenového azure-iot-sdk-java adresáře a sestavte projekt, aby se stáhly všechny potřebné balíčky. Dokončení tohoto kroku může trvat několik minut.

   cd azure-iot-sdk-java
   mvn install -DskipTests=true
   

Vytvoření registrace zařízení

Služba Azure IoT Device Provisioning podporuje dva typy registrací:

• Skupiny registrací: Slouží k registraci několika souvisejících zařízení.
• Jednotlivé registrace: Slouží k registraci jednoho zařízení.

Tento článek ukazuje individuální registraci jednoho zařízení, které se má zřídit v Centru IoT.

1. Přihlaste se k webu Azure Portal a přejděte k instanci služby Device Provisioning.

2. V části Nastavení navigační nabídky vyberte Spravovat registrace.

3. Vyberte kartu Jednotlivé registrace a pak vyberte Přidat jednotlivou registraci.

   

4. Na stránce Registrace a zřizovánína stránce Přidat registraci zadejte následující informace pro konfiguraci podrobností o registraci:

   Pole	Popis
   Atestace	Jako mechanismus ověření identity vyberte symetrický klíč.
   Nastavení symetrického klíče	Pokud chcete použít náhodně generované klíče, zaškrtněte políčko Generovat symetrické klíče automaticky. Pokud chcete zadat vlastní klíče, zrušte zaškrtnutí tohoto políčka.
   ID registrace	Zadejte jedinečné ID registrace zařízení.
   Stav zřizování	Zaškrtněte políčko Povolit tuto registraci, pokud chcete, aby byla tato registrace k dispozici pro zřízení jeho zařízení. Pokud chcete, aby byla registrace zakázaná, zrušte zaškrtnutí tohoto políčka. Toto nastavení můžete později změnit.
   Zásady opětovného zřízení	Zvolte zásadu opětovného zřízení, která odráží způsob, jakým má DPS zpracovávat zařízení, která požadují opětovné zřízení. Další informace najdete v tématu Zásady opětovného zřízení.

5. Vyberte Další: IoT Hubs.

6. Na kartě Centra IoT na stránce Přidat registraci zadejte následující informace, abyste zjistili, pro které centrum IoT může registrace zřídit zařízení:

   Pole	Popis
   Cílení center IoT	Vyberte jedno nebo více propojených center IoT nebo přidejte nový odkaz na centrum IoT. Další informace o propojení ioT Hubů s vaší instancí DPS najdete v tématu Propojení a správa ioT Hubů.
   Zásady přidělování	Pokud jste vybrali více propojených ioT Hubů, vyberte způsob přiřazení zařízení k různým rozbočovačům. Další informace ozásadách Pokud jste vybrali jenom jedno propojené centrum IoT, doporučujeme použít rovnoměrně vážené distribuční zásady.

7. Vybrat další: Nastavení zařízení

8. Na kartě Nastavení zařízení na stránce Přidat registraci zadejte následující informace, které definují, jak se nově zřízená zařízení konfigurují:

   Pole	Popis
   ID zařízení	Zadejte ID zařízení, které je přiřazeno zřízenému zařízení ve službě IoT Hub. Pokud nezadáte ID zařízení, použije se ID registrace.
   IoT Edge	Pokud zřízené zařízení spouští Azure IoT Edge, zkontrolujte povolení IoT Edge na zřízených zařízeních. Zrušte zaškrtnutí tohoto políčka, pokud je tato registrace pro zařízení, které není povoleno službou IoT Edge.
   Značky zařízení	Pomocí tohoto textového pole zadejte všechny značky, které chcete použít u dvojčete zařízení zřízeného zařízení.
   Požadované vlastnosti	Pomocí tohoto textového pole zadejte požadované vlastnosti, které chcete použít u dvojčete zařízení zřízeného zařízení.

   Další informace najdete v tématu Principy a použití dvojčat zařízení ve službě IoT Hub.

9. Vyberte Další: Zkontrolovat a vytvořit.

10. Na kartě Zkontrolovat a vytvořit ověřte všechny hodnoty a pak vyberte Vytvořit.

Po vytvoření jednotlivé registrace se vygeneruje primární klíč a sekundární klíč a přidá se do položky registrace. Primární klíč v ukázce zařízení použijete později v tomto rychlém startu.

1. Pokud chcete zobrazit simulovanou registraci zařízení symetrického klíče, vyberte kartu Jednotlivé registrace .

2. V seznamu jednotlivých registrací vyberte ID registrace vašeho zařízení.

3. Zkopírujte hodnotu vygenerovaného primárního klíče.

   

Příprava a spuštění kódu zřizování zařízení

V této části aktualizujete vzorový kód zařízení tak, aby se spouštěcí sekvence zařízení odeslala do instance služby Device Provisioning Service. Tato spouštěcí sekvence způsobí, že zařízení bude rozpoznáno, ověřeno a přiřazeno k centru IoT propojenému s instancí služby Device Provisioning.

Ukázkový kód zřizování provádí následující úlohy v pořadí:

1. Ověří zařízení pomocí prostředku Device Provisioning pomocí následujících tří parametrů:

   • Rozsah ID vaší instance služby Device Provisioning Service
   • ID registrace zařízení.
   • Primární symetrický klíč pro registraci zařízení.

2. Přiřadí zařízení k ioT Hubu, které je už propojené s vaší instancí služby Device Provisioning.

Pokud chcete aktualizovat a spustit ukázku zřizování s informacemi o zařízení:

1. V nabídce služby instance služby Device Provisioning vyberte Přehled.

2. Zkopírujte hodnotu oboru ID.

   

3. V sadě Visual Studio otevřete soubor řešení azure_iot_sdks.sln, který se vygeneroval spuštěním CMake. Soubor řešení by se měl nacházet v následujícím umístění:

   
   \azure-iot-sdk-c\cmake\azure_iot_sdks.sln
   
   

   Tip

   Pokud soubor nebyl vygenerován v adresáři cmake, ujistěte se, že jste použili nejnovější verzi systému sestavení CMake.

4. V okně Průzkumník řešení sady Visual Studio přejděte do složky Provision_Samples. Rozbalte ukázkový projekt s názvem prov_dev_client_sample. Rozbalte zdrojové soubory a otevřete prov_dev_client_sample.c.

5. Najděte konstantu id_scope a nahraďte ji hodnotou oboru ID, kterou jste zkopírovali v kroku 2.

   static const char* id_scope = "0ne00002193";
   

6. Ve stejném souboru vyhledejte definici funkce main(). Ujistěte se, hsm_type že je proměnná nastavená tak SECURE_DEVICE_TYPE_SYMMETRIC_KEY , jak je znázorněno v následujícím příkladu:

   SECURE_DEVICE_TYPE hsm_type;
   //hsm_type = SECURE_DEVICE_TYPE_TPM;
   //hsm_type = SECURE_DEVICE_TYPE_X509;
   hsm_type = SECURE_DEVICE_TYPE_SYMMETRIC_KEY;
   

7. Vyhledejte volání prov_dev_set_symmetric_key_info() v prov_dev_client_sample.c , který je okomentován.

   // Set the symmetric key if using they auth type
   //prov_dev_set_symmetric_key_info("<symm_registration_id>", "<symmetric_Key>");
   

   Odkomentujte volání funkce a nahraďte zástupné hodnoty (včetně úhlových závorek) ID registrace vašeho zařízení a hodnotu primárního klíče, kterou jste zkopírovali dříve.

   // Set the symmetric key if using they auth type
   prov_dev_set_symmetric_key_info("symm-key-device-007", "your primary key here");
   

8. Uložte soubor.

9. Klikněte pravým tlačítkem myši na prov_dev_client_sample projekt a vyberte Nastavit jako spouštěný projekt.

10. V nabídce sady Visual Studio vyberte Ladit>Spustit bez ladění a spusťte řešení. V výzvě k opětovnému sestavení projektu vyberte možnost Ano , aby se projekt před spuštěním znovu sestavil.

    Následující výstup je příkladem úspěšného připojení zařízení k instanci služby zřizování, která se má přiřadit k centru IoT:

    Provisioning API Version: 1.2.8
    
    Registering Device
    
    Provisioning Status: PROV_DEVICE_REG_STATUS_CONNECTED
    Provisioning Status: PROV_DEVICE_REG_STATUS_ASSIGNING
    
    Registration Information received from service:
    test-docs-hub.azure-devices.net, deviceId: device-007
    Press enter key to exit:
    

Ukázkový kód zřizování provádí následující úlohy:

1. Ověří zařízení pomocí prostředku Device Provisioning pomocí následujících tří parametrů:

   • Rozsah ID vaší instance služby Device Provisioning
   • ID registrace zařízení.
   • Primární symetrický klíč pro registraci zařízení.

2. Přiřadí zařízení k ioT Hubu, které je už propojené s vaší instancí služby Device Provisioning.

3. Odešle testovací zprávu do centra IoT.

Pokud chcete aktualizovat a spustit ukázku zřizování s informacemi o zařízení:

1. V nabídce služby instance služby Device Provisioning vyberte Přehled.

2. Zkopírujte hodnotu oboru ID.

   

3. Otevřete příkazový řádek a přejděte do symetrického klíčeSample v úložišti klonované sady SDK:

   cd '.\azure-iot-sdk-csharp\provisioning\device\samples\how to guides\SymmetricKeySample\'
   

4. Ve složce SymmetricKeySample otevřete Parameters.cs v textovém editoru. Tento soubor zobrazuje dostupné parametry pro ukázku. Při spuštění ukázky se v tomto článku používají pouze první tři požadované parametry. Zkontrolujte kód v tomto souboru. Nejsou potřeba žádné změny.

   Parametr	Požadováno	Popis
   --i nebo --IdScope	True	Rozsah ID instance DPS
   --r nebo --RegistrationId	True	ID registrace je řetězec nerozlišující velká a malá písmena (maximálně 128 znaků dlouhý) alfanumerických znaků a speciálních znaků: '-', '.', '_', ':'. Poslední znak musí být alfanumerický nebo pomlčka ('-').
   --p nebo --PrimaryKey	True	Primární klíč jednotlivé registrace nebo odvozeného klíče zařízení pro registraci skupiny. Informace o vygenerování odvozeného klíče najdete v tématu ComputeDerivedSymmetricKeySample .
   --g nebo --GlobalDeviceEndpoint	False	Globální koncový bod pro zařízení, ke kterému se mají připojit. Výchozí hodnota global.azure-devices-provisioning.net
   --t nebo --TransportType	False	Přenos, který se má použít ke komunikaci s instancí zřizování zařízení. Výchozí hodnota Mqttje . Možné hodnoty zahrnují Mqtt, , Mqtt_WebSocket_Only, Mqtt_Tcp_OnlyAmqp, Amqp_WebSocket_Only, Amqp_Tcp_only, a Http1.

5. Ve složce SymmetricKeySample otevřete ProvisioningDeviceClientSample.cs v textovém editoru. Tento soubor ukazuje, jak se třída SecurityProviderSymmetricKey používá spolu s provisioningDeviceClient třídy pro zřízení simulovaného symetrického klíče zařízení. Zkontrolujte kód v tomto souboru. Nejsou potřeba žádné změny.

6. Pomocí následujícího příkazu sestavte a spusťte ukázkový kód:

   • Nahraďte <id-scope> oborem ID, který jste zkopírovali v kroku 2.
   • Nahraďte <registration-id> ID registrace, které jste zadali pro registraci zařízení.
   • Nahraďte <primarykey> primárním klíčem , který jste zkopírovali z registrace zařízení.

   dotnet run --i <id-scope> --r <registration-id> --p <primarykey>
   

7. Teď byste měli vidět něco podobného jako v následujícím výstupu. Řetězec TestMessage se odešle do centra jako testovací zpráva.

   D:\azure-iot-sdk-csharp\provisioning\device\samples\how to guides\SymmetricKeySample>dotnet run --i 0ne00000A0A --r symm-key-csharp-device-01 --p sbDDeEzRuEuGKag+kQKV+T1QGakRtHpsERLP0yPjwR93TrpEgEh/Y07CXstfha6dhIPWvdD1nRxK5T0KGKA+nQ==
   
   Initializing the device provisioning client...
   Initialized for registration Id symm-key-csharp-device-01.
   Registering with the device provisioning service...
   Registration status: Assigned.
   Device csharp-device-01 registered to ExampleIoTHub.azure-devices.net.
   Creating symmetric key authentication for IoT Hub...
   Testing the provisioned device with IoT Hub...
   Sending a telemetry message...
   Finished.
   Enter any key to exit.
   

Ukázkový kód zřizování provádí následující úlohy v pořadí:

1. Ověří zařízení pomocí prostředku Device Provisioning pomocí následujících čtyř parametrů:

   • PROVISIONING_HOST
   • PROVISIONING_IDSCOPE
   • PROVISIONING_REGISTRATION_ID
   • PROVISIONING_SYMMETRIC_KEY

2. Přiřadí zařízení k ioT Hubu, které je už propojené s vaší instancí služby Device Provisioning.

3. Odešle testovací zprávu do centra IoT.

Pokud chcete aktualizovat a spustit ukázku zřizování s informacemi o zařízení:

1. V nabídce služby instance služby Device Provisioning vyberte Přehled.

2. Zkopírujte hodnoty oboru ID a globálního koncového bodu zařízení.

   

3. Otevřete příkazový řádek pro spouštění příkazů Node.js a přejděte do následujícího adresáře:

   cd azure-iot-sdk-node/provisioning/device/samples
   

4. Ve složce zřizování, zařízení/samples otevřete register_symkey.js a zkontrolujte kód. Všimněte si, že ukázkový kód nastaví vlastní datovou část:

   provisioningClient.setProvisioningPayload({a: 'b'});
   

   Tento kód datové části můžete okomentovat pro účely tohoto rychlého startu. Vlastní datová část by se vyžadovala, pokud chcete k přiřazení zařízení k centru IoT použít funkci vlastního přidělení. Další informace najdete v tématu Kurz: Použití vlastních zásad přidělování.

   Metoda provisioningClient.register() se pokusí o registraci zařízení.

   Nejsou potřeba žádné další změny.

5. Na příkazovém řádku spusťte následující příkazy pro nastavení proměnných prostředí používaných ukázkou:

   • Nahraďte <provisioning-global-endpoint> globální koncový bod zařízení, který jste zkopírovali v kroku 2.
   • Nahraďte <id-scope> oborem ID, který jste zkopírovali v kroku 2.
   • Nahraďte <registration-id> ID registrace, které jste zadali pro registraci zařízení.
   • Nahraďte <primarykey> primárním klíčem , který jste zkopírovali z registrace zařízení.

   set PROVISIONING_HOST=<provisioning-global-endpoint>
   

   set PROVISIONING_IDSCOPE=<id-scope>
   

   set PROVISIONING_REGISTRATION_ID=<registration-id>
   

   set PROVISIONING_SYMMETRIC_KEY=<primarykey>
   

6. Pomocí následujících příkazů sestavte a spusťte ukázkový kód:

    npm install
   

   node register_symkey.js
   

7. Teď byste měli vidět něco podobného jako v následujícím výstupu. Řetězec "Hello World" se odešle do centra jako testovací zpráva.

   D:\azure-iot-samples-csharp\provisioning\device\samples>node register_symkey.js
   registration succeeded
   assigned hub=ExampleIoTHub.azure-devices.net
   deviceId=nodejs-device-01
   payload=undefined
   Client connected
   send status: MessageEnqueued
   

Ukázkový kód zřizování provádí následující úlohy v pořadí:

1. Ověří zařízení pomocí prostředku Device Provisioning pomocí následujících čtyř parametrů:

   • PROVISIONING_HOST
   • PROVISIONING_IDSCOPE
   • PROVISIONING_REGISTRATION_ID
   • PROVISIONING_SYMMETRIC_KEY

2. Přiřadí zařízení k ioT Hubu, které je už propojené s vaší instancí služby Device Provisioning.

3. Odešle testovací zprávu do centra IoT.

Pokud chcete aktualizovat a spustit ukázku zřizování s informacemi o zařízení:

1. V nabídce služby instance služby Device Provisioning vyberte Přehled.

2. Zkopírujte hodnoty oboru ID a globálního koncového bodu zařízení.

   

3. Otevřete příkazový řádek a přejděte do adresáře, kde se nachází ukázkový soubor provision_symmetric_key.py.

   cd azure-iot-sdk-python\samples\async-hub-scenarios
   

4. Na příkazovém řádku spusťte následující příkazy pro nastavení proměnných prostředí používaných ukázkou:

   • Nahraďte <provisioning-global-endpoint> globální koncový bod zařízení, který jste zkopírovali v kroku 2.
   • Nahraďte <id-scope> oborem ID, který jste zkopírovali v kroku 2.
   • Nahraďte <registration-id> ID registrace, které jste zadali pro registraci zařízení.
   • Nahraďte <primarykey> primárním klíčem , který jste zkopírovali z registrace zařízení.

   set PROVISIONING_HOST=<provisioning-global-endpoint>
   

   set PROVISIONING_IDSCOPE=<id-scope>
   

   set PROVISIONING_REGISTRATION_ID=<registration-id>
   

   set PROVISIONING_SYMMETRIC_KEY=<primarykey>
   

5. Nainstalujte knihovnu azure-iot-device spuštěním následujícího příkazu.

   pip install azure-iot-device
   

6. Spusťte vzorový kód Pythonu v provision_symmetric_key.py.

   python provision_symmetric_key.py
   

7. Teď byste měli vidět něco podobného jako v následujícím výstupu. Některé ukázkové zprávy telemetrie rychlosti větru se také odesílají do centra jako test.

   D:\azure-iot-sdk-python\samples\async-hub-scenarios>python provision_symmetric_key.py
   RegistrationStage(RequestAndResponseOperation): Op will transition into polling after interval 2.  Setting timer.
   The complete registration result is
   python-device-008
   docs-test-iot-hub.azure-devices.net
   initialAssignment
   null
   Will send telemetry from the provisioned device
   sending message #8
   sending message #9
   sending message #3
   sending message #10
   sending message #4
   sending message #2
   sending message #6
   sending message #7
   sending message #1
   sending message #5
   done sending message #8
   done sending message #9
   done sending message #3
   done sending message #10
   done sending message #4
   done sending message #2
   done sending message #6
   done sending message #7
   done sending message #1
   done sending message #5
   

Ukázkový kód zřizování provádí následující úlohy v pořadí:

1. Ověří zařízení pomocí prostředku Device Provisioning pomocí následujících čtyř parametrů:

   • GLOBAL_ENDPOINT
   • SCOPE_ID
   • REGISTRATION_ID
   • SYMMETRIC_KEY

2. Přiřadí zařízení k ioT Hubu, které je už propojené s vaší instancí služby Device Provisioning.

3. Odešle testovací zprávu do centra IoT.

Pokud chcete aktualizovat a spustit ukázku zřizování s informacemi o zařízení:

1. V nabídce služby instance služby Device Provisioning vyberte Přehled.

2. Zkopírujte hodnoty oboru ID a globálního koncového bodu zařízení. Tyto hodnoty jsou vaše SCOPE_ID a GLOBAL_ENDPOINT parametry.

   

3. Otevřete vzorový kód zařízení v Javě pro úpravy. Úplná cesta k vzorovém kódu zařízení je:

   azure-iot-sdk-java/provisioning/provisioning-device-client-samples/provisioning-symmetrickey-individual-sample/src/main/java/samples/com/microsoft/azure/sdk/iot/ProvisioningSymmetricKeyIndividualEnrollmentSample.java

4. Nastavte hodnotu následujících proměnných pro vaši registraci DPS a zařízení:

   • Nahraďte <id-scope> oborem ID, který jste zkopírovali v kroku 2.
   • Nahraďte <provisioning-global-endpoint> globální koncový bod zařízení, který jste zkopírovali v kroku 2.
   • Nahraďte <registration-id> ID registrace, které jste zadali pro registraci zařízení.
   • Nahraďte <primarykey> primárním klíčem , který jste zkopírovali z registrace zařízení.

   private static final String SCOPE_ID = "<id-scope>";
   private static final String GLOBAL_ENDPOINT = "<provisioning-global-endpoint>";
   private static final String SYMMETRIC_KEY = "<primarykey>";
   private static final String REGISTRATION_ID = "<registration-id>";
   

5. Otevřete příkazový řádek pro sestavení. Přejděte do složky ukázkového projektu zřizování úložiště Sady Java SDK.

   cd azure-iot-sdk-java\provisioning\provisioning-device-client-samples\provisioning-symmetrickey-individual-sample
   

6. Sestavte ukázku.

   mvn clean install
   

7. Přejděte do target složky a spusťte vytvořený .jar soubor. java V příkazu nahraďte {version} zástupný symbol verzí v .jar názvu souboru na vašem počítači.

   cd target
   java -jar ./provisioning-symmetrickey-individual-sample-{version}-with-deps.jar
   

8. Teď byste měli vidět něco podobného jako v následujícím výstupu.

   Starting...
   Beginning setup.
   Initialized a ProvisioningDeviceClient instance using SDK version 1.11.0
   Starting provisioning thread...
   Waiting for Provisioning Service to register
   Opening the connection to device provisioning service...
   Connection to device provisioning service opened successfully, sending initial device registration message
   Authenticating with device provisioning service using symmetric key
   Waiting for device provisioning service to provision this device...
   Current provisioning status: ASSIGNING
   Device provisioning service assigned the device successfully
   IotHUb Uri : <Your IoT hub name>.azure-devices.net
   Device ID : java-device-007
   Sending message from device to IoT Hub...
   Press any key to exit...
   Message received! Response status: OK_EMPTY
   

Potvrzení registrace zřizování zařízení

1. Přejděte na Azure Portal.

2. V nabídce portálu nebo na stránce portálu vyberte Všechny prostředky.

3. Vyberte centrum IoT, ke kterému bylo vaše zařízení přiřazeno.

4. V nabídce služby v části Správa zařízení vyberte Zařízení.

5. Pokud se vaše zařízení úspěšně zřídilo, mělo by se v seznamu zobrazit ID zařízení se stavem nastaveným jako Povoleno. Pokud zařízení nevidíte, vyberte Aktualizovat v horní části podokna.

   

   

   

   

   

Poznámka:

Pokud jste v položce registrace pro vaše zařízení změnili počáteční stav dvojčete zařízení z výchozí hodnoty, může si zařízení požadovaný stav dvojčete vyžádat z centra a příslušně na něj reagovat. Další informace najdete v tématu Principy a použití dvojčat zařízení ve službě IoT Hub.

Vyčištění prostředků

Pokud chcete pokračovat v práci na ukázce klienta zařízení a prozkoumat ji, nevyčistit prostředky vytvořené v tomto rychlém startu. Pokud pokračovat nechcete, pomocí následujícího postupu odstraňte všechny prostředky vytvořené tímto rychlým startem.

Odstranění registrace zařízení

1. Zavřete na svém počítači okno výstupu ukázky klienta zařízení.

2. V nabídce portálu na webu Azure Portal vyberte Všechny prostředky.

3. Vyberte instanci služby Device Provisioning.

4. V nabídce služby v části Nastavení vyberte Spravovat registrace.

5. V pracovním podokně vyberte kartu Jednotlivé registrace .

6. Zaškrtněte políčko vedle ID registrace zařízení, které jste zaregistrovali v tomto rychlém startu.

7. V horní části podokna vyberte Odstranit.

Odstranění registrace zařízení ze služby IoT Hub

1. V nabídce portálu na webu Azure Portal vyberte Všechny prostředky.

2. Vyberte centrum IoT.

3. V nabídce služby v části Správa zařízení vyberte Zařízení.

4. V pracovním podokně zaškrtněte políčko vedle ID zařízení, které jste zaregistrovali v tomto rychlém startu.

5. V horní části podokna vyberte Odstranit.

Další kroky

V tomto rychlém startu jste pro centrum IoT zřídili jedno zařízení pomocí jednotlivé registrace. Dále se dozvíte, jak zřídit více zařízení napříč několika rozbočovači.

Kurz: Použití vlastních zásad přidělování se službou Device Provisioning Service (DPS)