빠른 시작: 시뮬레이션된 대칭 키 디바이스 프로비저닝

이 빠른 시작에서는 Windows 머신에서 시뮬레이션된 디바이스를 만듭니다. 시뮬레이션된 디바이스는 인증에 대칭 키 증명 메커니즘을 사용하도록 구성됩니다. 디바이스를 구성한 후 Azure IoT Hub Device Provisioning Service를 사용하여 IoT 허브에 프로비저닝합니다.

프로비저닝 프로세스에 익숙하지 않은 경우 프로비저닝 개요를 검토하세요.

이 빠른 시작에서는 Windows 기반 워크스테이션을 위한 솔루션을 보여 줍니다. 그러나 Linux에서 절차를 수행할 수도 있습니다. Linux 예제는 자습서: 지리 레이블 프로비저닝을 참조하세요.

사전 요구 사항

  • Windows 기반 컴퓨터에 .NET SDK 6.0 이상을 설치합니다. 다음 명령을 사용하여 버전을 확인할 수 있습니다.

    dotnet --info
    
  • Windows 기반 머신에 설치된 Python 3.7 이상을 설치합니다. python --version을 실행하여 Python 버전을 확인할 수 있습니다.
  • 최신 버전의 Git을 설치합니다. Git이 명령 창에 액세스할 수 있는 환경 변수에 추가되었는지 확인합니다. 설치할 git 도구의 최신 버전은 Software Freedom Conservancy의 Git 클라이언트 도구를 참조하세요. 여기에는 로컬 Git 리포지토리와 상호 작용하는 데 사용할 수 있는 명령줄 앱인 Git Bash가 포함됩니다.

개발 환경 준비

이 섹션에서는 Azure IoT C SDK를 빌드하는 데 사용되는 개발 환경을 준비합니다. 샘플 코드는 디바이스의 부팅 시퀀스 중에 디바이스를 프로비저닝하려고 시도합니다.

  1. 최신 CMake 빌드 시스템을 다운로드합니다.

    중요

    CMake 설치를 시작하기 전에 Visual Studio 필수 구성 요소(Visual Studio 및 'C++를 사용한 데스크톱 개발' 워크로드)를 머신에 설치해야 합니다. 필수 구성 요소가 설치되고 다운로드를 확인하면 CMake 빌드 시스템을 설치합니다. 이전 버전의 CMake 빌드 시스템은 이 문서에 사용된 솔루션 파일을 생성하지 못합니다. 최신 버전의 CMake를 사용해야 합니다.

  2. 웹 브라우저를 열고 Azure IoT C SDK 릴리스 페이지로 이동합니다.

  3. 페이지 맨 위에서 태그 탭을 선택합니다.

  4. Azure IoT C SDK의 최신 릴리스에 대한 태그 이름을 복사합니다.

  5. 명령 프롬프트 또는 Git Bash 셸을 엽니다. 다음 명령을 실행하여 Azure IoT C SDK GitHub 리포지토리의 최신 릴리스를 복제합니다(<release-tag>를 이전 단계에서 복사한 태그로 바꾸기).

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

    이 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

  6. 작업이 완료되면 azure-iot-sdk-c 디렉터리에서 다음 명령을 실행합니다.

    mkdir cmake
    cd cmake
    
  7. 코드 샘플에서는 대칭 키를 사용하여 증명을 제공합니다. 다음 명령을 실행하여 디바이스 프로비저닝 클라이언트를 포함하는 개발 클라이언트 플랫폼과 관련된 SDK 버전을 빌드합니다.

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

    cmake이(가) C++ 컴파일러를 찾지 못하면 위의 명령을 실행하는 동안 빌드 오류가 발생할 수 있습니다. 이 경우에는 Visual Studio 명령 프롬프트에서 명령을 실행합니다.

  8. 빌드가 성공적으로 완료되면 마지막 몇몇 출력 줄은 다음 출력과 유사하게 표시됩니다.

    $ 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. Git CMD 또는 Git Bash 명령줄 환경을 엽니다.

  2. 다음 명령을 사용하여 C# GitHub 리포지토리 용 Azure IoT SDK 를 복제합니다.

    git clone https://github.com/Azure/azure-iot-sdk-csharp.git
    
  1. Git CMD 또는 Git Bash 명령줄 환경을 엽니다.

  2. 다음 명령을 사용하여 Node.js용 Azure IoT SDK GitHub 리포지토리를 복제합니다.

    git clone https://github.com/Azure/azure-iot-sdk-node.git --recursive
    
  1. Git CMD 또는 Git Bash 명령줄 환경을 엽니다.

  2. 다음 명령을 사용하여 Python용 Azure IoT SDK GitHub 리포지토리를 복제합니다.

    git clone https://github.com/Azure/azure-iot-sdk-python.git --recursive
    
  1. Git CMD 또는 Git Bash 명령줄 환경을 엽니다.

  2. 다음 명령을 사용하여 Java용 Azure IoT SDK GitHub 리포지토리를 복제합니다.

    git clone https://github.com/Azure/azure-iot-sdk-java.git --recursive
    
  3. 필요한 모든 패키지를 다운로드하려면 루트 azure-iot-sdk-java 디렉터리로 이동하고 프로젝트를 빌드합니다. 이 단계를 완료하는 데 몇 분 정도 걸릴 수 있습니다.

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

디바이스 등록 만들기

Azure IoT Device Provisioning 서비스는 다음과 같은 두 가지 등록을 지원합니다.

  • 등록 그룹: 여러 관련 디바이스를 등록하는 데 사용됩니다.
  • 개별 등록: 단일 디바이스를 등록하는 데 사용됩니다.

이 문서에서는 IoT 허브로 프로비저닝할 단일 디바이스에 대한 개별 등록을 보여줍니다.

  1. Azure Portal에 로그인합니다.

  2. 왼쪽 메뉴 또는 포털 페이지에서 모든 리소스를 선택합니다.

  3. Device Provisioning Service를 선택합니다.

  4. 설정 메뉴에서 등록 관리를 선택합니다.

  5. 페이지 위쪽에서 + 개별 등록 추가를 선택합니다.

  6. 등록 추가 패널에서 다음 정보를 입력합니다.

    • 메커니즘: ID 증명 메커니즘으로 ‘대칭 키’를 선택합니다.

    • 키 자동 생성: 이 상자를 선택합니다.

    • 등록 ID: 등록을 식별하는 등록 ID를 입력합니다. 등록 ID는 영숫자 문자와 특수 문자'-'인 , , '.', '_'':'의 대/소문자를 구분하지 않는 문자열(최대 128자 길이)입니다. 마지막 문자는 영숫자 또는 대시('-')여야 합니다. 예를 들어 symm-key-device-007입니다.

    • IoT Hub 디바이스 ID: 디바이스 식별자를 입력합니다. 디바이스 ID는 디바이스 ID 문자열 요구 사항을 준수해야 합니다.

    디바이스 등록 정보 입력

    C# 디바이스 등록 정보 입력

    Node.js 디바이스 등록 정보 입력

    Python 디바이스 등록 정보 입력

    Java 디바이스 등록 정보 입력

  7. 저장을 선택합니다. 기본 키보조 키가 생성되고 등록 항목에 추가되며 등록 관리 페이지로 돌아갑니다.

  8. 시뮬레이션된 대칭 키 디바이스 등록을 보려면 개별 등록 탭을 선택합니다.

  9. 디바이스(symm-key-device-007)를 선택합니다.

  10. 생성된 기본 키의 값을 복사합니다.

    디바이스 등록의 기본 키 복사

디바이스 프로비저닝 코드 준비 및 실행

이 섹션에서는 디바이스의 부팅 시퀀스를 Device Provisioning Service 인스턴스에 보내도록 디바이스 샘플 코드를 업데이트합니다. 이 부팅 시퀀스를 사용하면 디바이스가 인식되고, 인증되며, Device Provisioning Service 인스턴스에 연결된 IoT Hub에 할당됩니다.

샘플 프로비저닝 코드는 다음 작업을 순서대로 수행합니다.

  1. 다음 세 개의 매개 변수를 사용하여 Device Provisioning 리소스로 디바이스를 인증합니다.

    • Device Provisioning Service의 ID 범위
    • 디바이스 등록의 등록 ID
    • 디바이스 등록의 기본 대칭 키
  2. Device Provisioning Service 인스턴스에 이미 연결된 IoT Hub에 디바이스를 할당합니다.

디바이스 정보를 사용하여 프로비저닝 샘플을 업데이트하고 실행하려면:

  1. Device Provisioning Service의 기본 메뉴에서 개요를 선택합니다.

  2. ID 범위 값을 복사합니다.

    Device Provisioning Service 엔드포인트 정보 추출

  3. Visual Studio에서 CMake를 실행하여 생성된 azure_iot_sdks.sln 솔루션 파일을 엽니다. 솔루션 파일은 다음 위치에 있습니다.

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

    파일이 Cmake 디렉터리에 생성되지 않는 경우 최신 버전의 CMake 빌드 시스템을 사용했는지 확인합니다.

  4. Visual Studio의 솔루션 탐색기 창에서 Provision_Samples 폴더로 이동합니다. prov_dev_client_sample 라는 샘플 프로젝트를 확장합니다. 원본 파일을 확장하고 prov_dev_client_sample.c를 엽니다.

  5. 상수를 id_scope 찾고 값을 2단계에서 복사한 ID 범위 값으로 바꿉니다.

    static const char* id_scope = "0ne00002193";
    
  6. 동일한 파일에서 main() 함수에 대한 정의를 찾습니다. 아래와 같이 hsm_type 변수가 SECURE_DEVICE_TYPE_SYMMETRIC_KEY로 설정되었는지 확인합니다.

    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. 주석 처리된 prov_dev_client_sample.c에서 에 대한 호출 prov_dev_set_symmetric_key_info() 을 찾습니다.

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

    함수 호출의 주석 처리를 제거하고 자리 표시자 값(꺾쇠괄호 포함)을 앞에서 복사한 등록 ID 및 기본 키 값으로 바꿉니다.

    // Set the symmetric key if using they auth type
    prov_dev_set_symmetric_key_info("symm-key-device-007", "your primary key here");
    
  8. 파일을 저장합니다.

  9. prov_dev_client_sample 프로젝트를 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정을 선택합니다.

  10. Visual Studio 메뉴에서 디버그>디버깅하지 않고 시작을 선택하여 솔루션을 실행합니다. 프로젝트 다시 빌드 프롬프트에서 를 선택하여 실행하기 전에 프로젝트를 다시 빌드합니다.

    다음 출력은 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:
    

샘플 프로비저닝 코드는 다음 작업을 수행합니다.

  1. 다음 세 개의 매개 변수를 사용하여 Device Provisioning 리소스로 디바이스를 인증합니다.

    • Device Provisioning Service의 ID 범위
    • 디바이스 등록의 등록 ID
    • 디바이스 등록의 기본 대칭 키
  2. Device Provisioning Service 인스턴스에 이미 연결된 IoT Hub에 디바이스를 할당합니다.

  3. IoT 허브에 테스트 원격 분석 메시지를 보냅니다.

디바이스 정보를 사용하여 프로비저닝 샘플을 업데이트하고 실행하려면:

  1. Device Provisioning Service의 기본 메뉴에서 개요를 선택합니다.

  2. ID 범위 값을 복사합니다.

    Device Provisioning Service 엔드포인트 정보 추출

  3. 명령 프롬프트를 열고 복제된 sdk 리포지토리에서 SymmetricKeySample 로 이동합니다.

    cd '.\azure-iot-sdk-csharp\provisioning\device\samples\How To\SymmetricKeySample\'
    
  4. SymmetricKeySample 폴더의 Parameters.cs를 텍스트 편집기에서 엽니다. 이 파일은 샘플에서 지원하는 매개 변수를 보여 줍니다. 이 문서에서는 샘플을 실행할 때 처음 세 개의 필수 매개 변수만 사용합니다. 이 파일의 코드를 살펴보세요. 변경할 필요는 없습니다.

    매개 변수 필수 설명
    --i 또는 --IdScope True DPS 인스턴스의 ID 범위
    --r 또는 --RegistrationId True 등록 ID는 영숫자 문자와 특수 문자'-'인 , , '.', '_'':'의 대/소문자를 구분하지 않는 문자열(최대 128자 길이)입니다. 마지막 문자는 영숫자 또는 대시('-')여야 합니다.
    --p 또는 --PrimaryKey True 개별 등록의 기본 키 또는 그룹 등록의 파생 디바이스 키입니다. 파생 키를 생성하는 방법은 ComputeDerivedSymmetricKeySample 을 참조하세요.
    --g 또는 --GlobalDeviceEndpoint 거짓 디바이스에서 연결할 전역 엔드포인트. 기본값은 global.azure-devices-provisioning.net입니다.
    --t 또는 --TransportType 거짓 디바이스 프로비저닝 인스턴스와 통신하는 데 사용할 전송. 기본값은 Mqtt입니다. 가능한 값은 Mqtt, Mqtt_WebSocket_Only, Mqtt_Tcp_Only, Amqp, Amqp_WebSocket_Only, Amqp_Tcp_onlyHttp1입니다.
  5. SymmetricKeySample 폴더의 ProvisioningDeviceClientSample.cs를 텍스트 편집기에서 엽니다. 이 파일은 시뮬레이션된 대칭 키 디바이스를 프로비저닝하기 위해 SecurityProviderSymmetricKey 클래스와 ProvisioningDeviceClient 클래스가 어떻게 함께 사용되는지 보여 줍니다. 이 파일의 코드를 살펴보세요. 변경할 필요는 없습니다.

  6. 다음 명령을 사용하여 샘플 코드를 빌드하고 실행합니다.

    • 를 2단계에서 복사한 ID 범위로 바꿉니다<id-scope>.
    • 를 디바이스 등록에서 복사한 등록 ID로 바꿉니다<registration-id>.
    • 를 디바이스 등록에서 복사한 기본 키로 바꿉니다<primarykey>.
    dotnet run --i <id-scope> --r <registration-id> --p <primarykey>
    
  7. 이제 다음 출력과 비슷하게 표시됩니다. “TestMessage” 문자열은 테스트 메시지로 허브에 전송됩니다.

    D:\azure-iot-sdk-csharp\provisioning\device\samples\How To\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.
    

샘플 프로비저닝 코드는 다음 작업을 순서대로 수행합니다.

  1. 다음 네 개의 매개 변수를 사용하여 Device Provisioning 리소스로 디바이스를 인증합니다.

    • PROVISIONING_HOST
    • PROVISIONING_IDSCOPE
    • PROVISIONING_REGISTRATION_ID
    • PROVISIONING_SYMMETRIC_KEY
  2. Device Provisioning Service 인스턴스에 이미 연결된 IoT Hub에 디바이스를 할당합니다.

  3. IoT 허브에 테스트 원격 분석 메시지를 보냅니다.

디바이스 정보를 사용하여 프로비저닝 샘플을 업데이트하고 실행하려면:

  1. Device Provisioning Service의 기본 메뉴에서 개요를 선택합니다.

  2. ID 범위전역 디바이스 엔드포인트 값을 복사합니다.

    Device Provisioning Service 엔드포인트 정보 추출

  3. Node.js 명령을 실행하기 위한 명령 프롬프트를 열고 다음 디렉터리로 이동합니다.

    cd azure-iot-sdk-node/provisioning/device/samples
    
  4. provisioning/device/samples 폴더에서 register_symkey.js를 열고, 코드를 검토합니다. 샘플 코드에서는 사용자 지정 페이로드를 설정합니다.

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

    이 빠른 시작에는 필요하지 않으므로 이 코드를 주석으로 처리할 수 있습니다. 사용자 지정 할당 함수를 사용하여 디바이스를 IoT Hub에 할당하려는 경우 사용자 지정 페이로드가 필요합니다. 자세한 내용은 자습서: 사용자 지정 할당 정책 사용을 참조하세요.

    provisioningClient.register() 메서드에서 디바이스 등록을 시도합니다.

    추가 변경은 필요하지 않습니다.

  5. 명령 프롬프트에서 다음 명령을 실행하여 샘플에서 사용하는 환경 변수를 설정합니다.

    • 을 2단계에서 복사한 전역 디바이스 엔드포인트로 바꿉 있습니다<provisioning-global-endpoint>.
    • 를 2단계에서 복사한 ID 범위로 바꿉니다<id-scope>.
    • 를 디바이스 등록에서 복사한 등록 ID로 바꿉니다<registration-id>.
    • 를 디바이스 등록에서 복사한 기본 키로 바꿉니다<primarykey>.
    set PROVISIONING_HOST=<provisioning-global-endpoint>
    
    set PROVISIONING_IDSCOPE=<id-scope>
    
    set PROVISIONING_REGISTRATION_ID=<registration-id>
    
    set PROVISIONING_SYMMETRIC_KEY=<primarykey>
    
  6. 다음 명령을 사용하여 샘플 코드를 빌드하고 실행합니다.

     npm install
    
    node register_symkey.js
    
  7. 이제 다음 출력과 비슷하게 표시됩니다. “Hello World” 문자열이 테스트 메시지로 허브에 전송됩니다.

    D:\azure-iot-samples-csharp\provisioning\Samples\device\SymmetricKeySample>dotnet run --s 0ne00000A0A --i 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.
    

샘플 프로비저닝 코드는 다음 작업을 순서대로 수행합니다.

  1. 다음 네 개의 매개 변수를 사용하여 Device Provisioning 리소스로 디바이스를 인증합니다.

    • PROVISIONING_HOST
    • PROVISIONING_IDSCOPE
    • PROVISIONING_REGISTRATION_ID
    • PROVISIONING_SYMMETRIC_KEY
  2. Device Provisioning Service 인스턴스에 이미 연결된 IoT Hub에 디바이스를 할당합니다.

  3. IoT 허브에 테스트 원격 분석 메시지를 보냅니다.

디바이스 정보를 사용하여 프로비저닝 샘플을 업데이트하고 실행하려면:

  1. Device Provisioning Service의 기본 메뉴에서 개요를 선택합니다.

  2. ID 범위전역 디바이스 엔드포인트 값을 복사합니다.

    Device Provisioning Service 엔드포인트 정보 추출

  3. 명령 프롬프트를 열고 샘플 파일 provision_symmetric_key.py가 있는 디렉터리로 이동합니다.

    cd azure-iot-sdk-python\samples\async-hub-scenarios
    
  4. 명령 프롬프트에서 다음 명령을 실행하여 샘플에서 사용하는 환경 변수를 설정합니다.

    • 를 2단계에서 복사한 전역 디바이스 엔드포인트로 바꿉 있습니다<provisioning-global-endpoint>.
    • 를 2단계에서 복사한 ID 범위로 바꿉니다<id-scope>.
    • 를 디바이스 등록에서 복사한 등록 ID로 바꿉니다<registration-id>.
    • 를 디바이스 등록에서 복사한 기본 키로 바꿉니다<primarykey>.
    set PROVISIONING_HOST=<provisioning-global-endpoint>
    
    set PROVISIONING_IDSCOPE=<id-scope>
    
    set PROVISIONING_REGISTRATION_ID=<registration-id>
    
    set PROVISIONING_SYMMETRIC_KEY=<primarykey>
    
  5. 다음 명령을 실행하여 azure-iot-device 라이브러리를 설치합니다.

    pip install azure-iot-device
    
  6. provision_symmetric_key.py에서 Python 샘플 코드를 실행합니다.

    python provision_symmetric_key.py
    
  7. 이제 다음 출력과 비슷하게 표시됩니다. 몇 가지 예제 풍속 원격 분석 메시지도 테스트로 허브에 전송됩니다.

    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
    

샘플 프로비저닝 코드는 다음 작업을 순서대로 수행합니다.

  1. 다음 네 개의 매개 변수를 사용하여 Device Provisioning 리소스로 디바이스를 인증합니다.

    • GLOBAL_ENDPOINT
    • SCOPE_ID
    • REGISTRATION_ID
    • SYMMETRIC_KEY
  2. Device Provisioning Service 인스턴스에 이미 연결된 IoT Hub에 디바이스를 할당합니다.

  3. IoT 허브에 테스트 원격 분석 메시지를 보냅니다.

디바이스 정보를 사용하여 프로비저닝 샘플을 업데이트하고 실행하려면:

  1. Device Provisioning Service의 기본 메뉴에서 개요를 선택합니다.

  2. ID 범위전역 디바이스 엔드포인트 값을 복사합니다. 해당 값은 각각 SCOPE_IDGLOBAL_ENDPOINT입니다.

    Device Provisioning Service 엔드포인트 정보 추출

  3. 편집을 위해 Java 디바이스 샘플 코드를 엽니다. 디바이스 샘플 코드에 대한 전체 경로는 다음과 같습니다.

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

  4. DPS 및 디바이스 등록에 대해 다음 변수의 값을 설정합니다.

    • 를 2단계에서 복사한 ID 범위로 바꿉니다<id-scope>.
    • 를 2단계에서 복사한 전역 디바이스 엔드포인트로 바꿉 있습니다<provisioning-global-endpoint>.
    • 를 디바이스 등록에서 복사한 등록 ID로 바꿉니다<registration-id>.
    • 를 디바이스 등록에서 복사한 기본 키로 바꿉니다<primarykey>.
    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. 빌드를 위한 명령 프롬프트를 엽니다. Java SDK 리포지토리의 프로비저닝 샘플 프로젝트 폴더로 이동합니다.

    cd azure-iot-sdk-java\provisioning\provisioning-samples\provisioning-symmetrickey-individual-sample
    
  6. 샘플을 빌드합니다.

    mvn clean install
    
  7. 폴더로 target 이동하여 만든 .jar 파일을 실행합니다. 명령에서 java 자리 표시자를 컴퓨터의 파일 이름에 있는 .jar 버전으로 바꿉 {version} 니다.

    cd target
    java -jar ./provisioning-symmetrickey-individual-sample-{version}-with-deps.jar
    
  8. 이제 다음 출력과 비슷하게 표시됩니다.

    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
    

디바이스 프로비저닝 등록 확인

  1. Azure Portal로 이동합니다.

  2. 왼쪽 메뉴 또는 포털 페이지에서 모든 리소스를 선택합니다.

  3. 디바이스가 할당된 IoT Hub를 선택합니다.

  4. Explorers 메뉴에서 IoT 디바이스를 선택합니다.

  5. 디바이스가 성공적으로 프로비전된 경우 상태사용으로 설정된 디바이스 ID가 목록에 표시됩니다. 디바이스가 표시되지 않으면 페이지 위쪽에서 새로 고침을 선택합니다.

    디바이스가 IoT Hub에 등록됨

    CSharp 디바이스가 IoT 허브에 등록됨

    Node.js 디바이스가 IoT 허브에 등록됨

    Python 디바이스가 IoT 허브에 등록됨

    Java 디바이스가 IoT 허브에 등록됨

참고

디바이스에 대한 등록 항목의 기본값으로부터 초기 디바이스 쌍 상태를 변경한 경우, 허브에서 원하는 쌍 상태를 가져와서 그에 맞게 작동할 수 있습니다. 자세한 내용은 IoT Hub의 디바이스 쌍 이해 및 사용을 참조하세요.

리소스 정리

디바이스 클라이언트 샘플에 계속 작업하고 탐색할 계획인 경우 이 빠른 시작에서 만든 리소스를 정리하지 마세요. 그만하려면 다음 단계를 사용하여 이 빠른 시작에서 만든 모든 리소스를 삭제합니다.

디바이스 등록 삭제

  1. 컴퓨터에서 디바이스 클라이언트 샘플 출력 창을 닫습니다.

  2. Azure Portal의 왼쪽 메뉴에서 모든 리소스를 선택합니다.

  3. Device Provisioning Service를 선택합니다.

  4. 설정 메뉴에서 등록 관리를 선택합니다.

  5. 개별 등록 탭을 선택합니다.

  6. 이 빠른 시작에 등록한 디바이스의 등록 ID 옆에 있는 확인란을 선택합니다.

  7. 페이지 위쪽에서 삭제를 선택합니다.

IoT Hub에서 디바이스 등록 삭제

  1. Azure Portal의 왼쪽 메뉴에서 모든 리소스를 선택합니다.

  2. IoT Hub를 선택합니다.

  3. Explorers 메뉴에서 IoT 디바이스를 선택합니다.

  4. 이 빠른 시작에서 등록한 디바이스의 디바이스 ID 옆에 있는 확인란을 선택합니다.

  5. 페이지 위쪽에서 삭제를 선택합니다.

다음 단계

등록 그룹을 사용하여 여러 대칭 키 디바이스를 프로비전합니다.