クイックスタート: シミュレートされた対称キーデバイスをプロビジョニングする

[アーティクル]
04/06/2023

このクイックスタートでは、シミュレートされたデバイスを Windows マシンに作成します。シミュレートされたデバイスは、認証のために対称キー構成証明のメカニズムを使用するように構成されます。デバイスを構成した後、Azure IoT Hub Device Provisioning Service を使用して IoT ハブにプロビジョニングします。

プロビジョニングのプロセスに慣れていない場合は、プロビジョニングの概要を確認してください。

このクイックスタートでは、Windows ベースワークステーションのソリューションについて説明します。しかし、Linux でこの手順を行うこともできます。 Linux の例については、「チュートリアル: geo 待機時間のためのプロビジョニング」を参照してください。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
Azure portal での IoT Hub Device Provisioning Service の設定に関するページの手順を完了します。

Windows 開発環境を使用する場合は、"C++ によるデスクトップ開発" のワークロードが有効になっている Visual Studio 2019 をインストールします。 Visual Studio 2015 と Visual Studio 2017 もサポートされています。 Linux または macOS については、SDK ドキュメントの「開発環境を準備する」の該当するセクションを参照してください。

Windows ベースのコンピューターに .NET SDK 6.0 以降をインストールします。次のコマンドを使用してバージョンを確認してください。
```
dotnet --info
```

Node.js v4.0 以降をインストールします。

Windows ベースのコンピューターに Python 3.7 以降をインストールします。 python --version を実行して、使用している Python のバージョンを確認できます。

コンピューターに Java SE Development Kit 8 以降をインストールします。
Maven をダウンロードし、インストールします。

最新バージョンの Git をインストールします。コマンドウィンドウからアクセスできる環境変数に Git が追加されていることを確認します。 Git Bash (ローカル Git リポジトリとやりとりする際に使用できるコマンドラインアプリ) を含む、インストールする git ツールの最新バージョンについては、Software Freedom Conservancy の Git クライアントツールに関するページを参照してください。

開発環境を準備する

このセクションでは、Azure IoT C SDK のビルドに使用する開発環境を準備します。このサンプルコードでは、デバイスのブートシーケンス中にデバイスのプロビジョニングを試みます。

最新の CMake ビルドシステムをダウンロードします。

重要

CMake のインストールを開始する前に、Visual Studio の前提条件 (Visual Studio と "C++ によるデスクトップ開発" ワークロード) がコンピューターにインストールされていることを確認します。前提条件を満たし、ダウンロードを検証したら、CMake ビルドシステムをインストールします。また、以前のバージョンの CMake ビルドシステムでは、この記事で使用されているソリューションファイルを生成できないことに注意してください。必ず最新バージョンの CMake を使用してください。
Web ブラウザーを開き、Azure IoT C SDK のリリースページに移動します。
そのページの上部にある [タグ] タブを選択します。
最新リリースの Azure IoT C SDK のタグ名をコピーします。
コマンドプロンプトまたは Git Bash シェルを開きます。次のコマンドを実行して、最新リリースの C 用 Azure IoT Device SDK の GitHub リポジトリを複製します。 <release-tag> を前のステップでコピーしたタグで置き換えます (例: lts_01_2023)。
```
git clone -b <release-tag> https://github.com/Azure/azure-iot-sdk-c.git
cd azure-iot-sdk-c
git submodule update --init
```
この操作が完了するまで数分かかる場合があります。
操作が完了したら、azure-iot-sdk-c ディレクトリから次のコマンドを実行します。
```
mkdir cmake
cd cmake
```
このコードサンプルでは、対称キーを使用して構成証明を指定します。次のコマンドを実行して、デバイスプロビジョニングクライアントを含む開発クライアントプラットフォームに固有の SDK のバージョンをビルドします。
```
cmake -Dhsm_type_symm_key:BOOL=ON -Duse_prov_client:BOOL=ON  ..
```
ヒント

cmake で C++ コンパイラが見つからない場合は、上記のコマンドの実行中にビルドエラーが発生する可能性があります。これが発生した場合は、Visual Studio コマンドプロンプトでコマンドを実行してください。

ビルドが正常に完了すると、最後のいくつかの出力行は次の出力のようになります。

$ 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

Git CMD または Git Bash コマンドライン環境を開きます。
次のコマンドを使用して、Azure IoT SDK for C# の GitHub リポジトリをクローンします。
```
git clone https://github.com/Azure/azure-iot-sdk-csharp.git
```

Git CMD または Git Bash コマンドライン環境を開きます。
次のコマンドを使用して、Azure IoT SDK for Node.js の GitHub リポジトリをクローンします。
```
git clone https://github.com/Azure/azure-iot-sdk-node.git --recursive
```

Git CMD または Git Bash コマンドライン環境を開きます。
次のコマンドを使用して、Azure IoT SDK for Python の GitHub リポジトリをクローンします。
```
git clone -b v2 https://github.com/Azure/azure-iot-sdk-python.git --recursive
```
注意

このチュートリアルで使用するサンプルは、azure-iot-sdk-python リポジトリの v2 ブランチにあります。 Python SDK の V3 はベータ版で使用できます。

Git CMD または Git Bash コマンドライン環境を開きます。
次のコマンドを使用して、Azure IoT SDK for Java の GitHub リポジトリをクローンします。
```
git clone https://github.com/Azure/azure-iot-sdk-java.git --recursive
```
ルート azure-iot-sdk-java ディレクトリに移動し、プロジェクトをビルドして必要なパッケージをすべてダウンロードします。この手順は、完了するまでに数分かかることがあります。
```
cd azure-iot-sdk-java
mvn install -DskipTests=true
```

デバイス登録を作成する

Azure IoT Device Provisioning Service では、次の 2 種類の登録がサポートされています。

登録グループ：複数の関連するデバイスを登録するために使用します。
個別登録: 単一デバイスを登録するために使用します。

この記事では、IoT ハブに単一のデバイスをプロビジョニングする個別登録のデモを行います。

Azure portal にサインインし、Device Provisioning Service インスタンスに移動します。
ナビゲーションメニューの [設定] セクションから [Manage enrollments] (登録の管理) を選択します。
[個々の登録] タブを選択し、[個別登録の追加] を選択します。

[登録の追加] ページの [登録とプロビジョニング] で、次の情報を入力して登録の詳細を構成します。

フィールド	説明
構成証明	[Attestation mechanism] (構成証明メカニズム) として [対称キー] を選択します。
Symmetric key settings (対称キーの設定)	ランダムに生成されたキーを使用する場合は、[Generate symmetric keys automatically] (対称キーを自動的に生成) ボックスをオンにします。独自のキーを指定する場合は、このボックスをオフにします。
登録 ID	デバイスの一意の登録 ID を指定します。
プロビジョニングの状態	この登録をデバイスのプロビジョニングに使用できるようにする場合は、[この登録を有効にする] チェックボックスをオンにします。登録を無効にする場合は、このチェックボックスをオフにします。この設定は後で変更できます。
再プロビジョニングポリシー	再プロビジョニングを要求するデバイスを DPS で処理する方法を反映する再プロビジョニングポリシーを選択します。詳細については、再プロビジョニングポリシーに関するページを参照してください。

[Next: IoT hubs] (次へ: IoT ハブ) を選択します。

[登録の追加] ページの [IoT ハブ] タブで、次の情報を入力して、登録でデバイスをプロビジョニングできる IoT ハブを決定します。

フィールド	説明
Target IoT hubs (ターゲット IoT ハブ)	1 つ以上のリンクされた IoT ハブを選択するか、IoT ハブへの新しいリンクを追加します。 IoT ハブを DPS インスタンスにリンクする方法の詳細については、IoT ハブをリンクして管理する方法に関するページを参照してください。
割り当てポリシー	複数のリンクされた IoT ハブを選択した場合は、デバイスを別のハブに割り当てる方法を選択します。割り当てポリシーの詳細については、割り当てポリシーの使用方法に関するページを参照してください。リンクされた IoT ハブを 1 つだけ選択した場合は、加重が均等に分布ポリシーを使用することをお勧めします。

フィールド

説明

Target IoT hubs (ターゲット IoT ハブ)

1 つ以上のリンクされた IoT ハブを選択するか、IoT ハブへの新しいリンクを追加します。 IoT ハブを DPS インスタンスにリンクする方法の詳細については、IoT ハブをリンクして管理する方法に関するページを参照してください。

割り当てポリシー

複数のリンクされた IoT ハブを選択した場合は、デバイスを別のハブに割り当てる方法を選択します。割り当てポリシーの詳細については、割り当てポリシーの使用方法に関するページを参照してください。

リンクされた IoT ハブを 1 つだけ選択した場合は、加重が均等に分布ポリシーを使用することをお勧めします。

[次へ: デバイスの設定] を選択します

[登録の追加] ページの [デバイス設定] タブで、次の情報を入力して、新しくプロビジョニングされたデバイスの構成方法を定義します。

フィールド	説明
Device ID	IoT Hub でプロビジョニングされたデバイスに割り当てられるデバイス ID を指定します。デバイス ID を指定しなかった場合は、登録 ID が使用されます。
IoT Edge	プロビジョニングされたデバイスで Azure IoT Edge が実行される場合は、[プロビジョニングされたデバイスで IoT Edge を有効にする] をオンにします。この登録が非 IoT Edge 対応デバイス用である場合は、このボックスをオフにします。
デバイスタグ	このテキストボックスを使用して、プロビジョニングされたデバイスのデバイスツインに適用するタグを指定します。
必要なプロパティ	このテキストボックスを使用して、プロビジョニングされたデバイスのデバイスツインに適用する必要なプロパティを指定します。

詳細については、「IoT Hub のデバイスツインの理解と使用」を参照してください。

確認と作成 をクリックします。
[確認 + 作成] タブで、すべての値を確認してから [作成] を選択します。

個々の登録を作成すると、主キーとセカンダリキーが生成され、登録エントリに追加されます。このクイックスタートで後に出てくるデバイスサンプルでは主キーを使用します。

シミュレートされた対称キーデバイスの登録を表示するには、[個々の登録] タブを選択します。
個々の登録の一覧からデバイスの登録 ID を選択します。
生成された主キーの値をコピーします。

デバイスプロビジョニングコードを準備して実行する

このセクションでは、デバイスのブートシーケンスを Device Provisioning Service インスタンスに送信するようにデバイスサンプルコードを更新します。このブートシーケンスを行うと、デバイスが認識され、認証されて、Device Provisioning Service インスタンスにリンクされた IoT ハブに割り当てられます。

サンプルプロビジョニングコードでは、次のタスクを順に実行します。

次の 3 つのパラメーターを使用して、Device Provisioning リソースでデバイスを認証します。
- Device Provisioning Service の ID スコープ
- デバイス登録の登録 ID。
- デバイス登録の主対称キー。
Device Provisioning Service インスタンスに既にリンクされている IoT ハブにデバイスを割り当てます。

デバイス情報を使用してプロビジョニングサンプルを更新して実行するには、次のようにします。

Device Provisioning Service のメインメニューで、 [概要] を選択します。
[ID スコープ] の値をコピーします。
CMake を実行して生成された azure_iot_sdks.sln ソリューションファイルを Visual Studio で開きます。ソリューションファイルは次の場所にあります。
```
\azure-iot-sdk-c\cmake\azure_iot_sdks.sln
```
ヒント

cmake ディレクトリにファイルが生成されていない場合は、最新バージョンの CMake ビルドシステムを使用していることを確認してください。
Visual Studio の [ソリューションエクスプローラー] ウィンドウで、Provision_Samples フォルダーに移動します。 prov_dev_client_sample という名前のサンプルプロジェクトを展開します。 [ソースファイル] を展開して、prov_dev_client_sample.c を開きます。
定数 id_scope を探し、手順 2 でコピーした ID スコープの値で置き換えます。
```
static const char* id_scope = "0ne00002193";
```
同じファイル内で 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;
```
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");
```
ファイルを保存します。
prov_dev_client_sample プロジェクトを右クリックし、[スタートアッププロジェクトに設定] を選びます。
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:
```

サンプルプロビジョニングコードでは次のタスクを実行します。

次の 3 つのパラメーターを使用して、Device Provisioning リソースでデバイスを認証します。
- Device Provisioning Service の ID スコープ
- デバイス登録の登録 ID。
- デバイス登録の主対称キー。
Device Provisioning Service インスタンスに既にリンクされている IoT ハブにデバイスを割り当てます。
テストテレメトリメッセージを IoT ハブに送信します。

デバイス情報を使用してプロビジョニングサンプルを更新して実行するには、次のようにします。

Device Provisioning Service のメインメニューで、 [概要] を選択します。
[ID スコープ] の値をコピーします。
コマンドプロンプトを開き、クローンした sdk リポジトリ内の SymmetricKeySample に移動します。
```
cd '.\azure-iot-sdk-csharp\provisioning\device\samples\how to guides\SymmetricKeySample\'
```

SymmetricKeySample フォルダーの Parameters.cs をテキストエディターで開きます。このファイルは、サンプルで使用可能なパラメーターを示しています。この記事では、サンプルを実行するときに、最初の 3 つの必須パラメーターのみを使用します。このファイルのコードを確認します。変更は不要です。

パラメーター	必須	説明
`--i` または `--IdScope`	○	DPS インスタンスの ID スコープ
`--r` または `--RegistrationId`	○	登録 ID は、英数字と特殊文字 (`'-'`、`'.'`、`'_'`、`':'`) から成る、大文字と小文字が区別されない文字列です (最大 128 文字)。最後の文字は、英数字またはダッシュ (`'-'`) である必要があります。
`--p` または `--PrimaryKey`	○	個々の登録の主キーまたはグループ登録の派生デバイスキー。派生キーを生成する方法については、ComputeDerivedSymmetricKeySample を参照してください。
`--g` または `--GlobalDeviceEndpoint`	×	デバイスの接続先となるグローバルエンドポイント。既定値は `global.azure-devices-provisioning.net` です
`--t` または `--TransportType`	×	デバイスプロビジョニングインスタンスとの通信に使用するトランスポート。既定値は `Mqtt` です。指定できる値は、`Mqtt`、`Mqtt_WebSocket_Only`、`Mqtt_Tcp_Only`、`Amqp`、`Amqp_WebSocket_Only`、`Amqp_Tcp_only`、および `Http1` です。

SymmetricKeySample フォルダーの ProvisioningDeviceClientSample.cs をテキストエディターで開きます。このファイルには、SecurityProviderSymmetricKey クラスを ProvisioningDeviceClient クラスと共に使用して、シミュレートされた対称キーデバイスをプロビジョニングする方法が示されます。このファイルのコードを確認します。変更は不要です。
次のコマンドを使用してサンプルコードをビルドし、実行します。
- <id-scope> を、手順 2 でコピーした ID スコープに置き換えます。
- <registration-id> を、デバイス登録に指定した登録 ID に置き換えます。
- <primarykey> を、デバイス登録からコピーしたプライマリキーに置き換えます。
```
dotnet run --i <id-scope> --r <registration-id> --p <primarykey>
```

これで次の出力のようになるはずです。テストメッセージとして "TestMessage" という文字列がハブに送信されます。

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.

サンプルプロビジョニングコードでは、次のタスクを順に実行します。

次の 4 つのパラメーターを使用して、Device Provisioning リソースでデバイスを認証します。
- PROVISIONING_HOST
- PROVISIONING_IDSCOPE
- PROVISIONING_REGISTRATION_ID
- PROVISIONING_SYMMETRIC_KEY
Device Provisioning Service インスタンスに既にリンクされている IoT ハブにデバイスを割り当てます。
テストテレメトリメッセージを IoT ハブに送信します。

デバイス情報を使用してプロビジョニングサンプルを更新して実行するには、次のようにします。

Device Provisioning Service のメインメニューで、 [概要] を選択します。
[ID スコープ] と [グローバルデバイスエンドポイント] の値をコピーします。
Node.js コマンドを実行するためのコマンドプロンプトを開き、次のディレクトリに移動します。
```
cd azure-iot-sdk-node/provisioning/device/samples
```
provisioning/device/samples フォルダーの register_symkey.js を開いて、コードを確認します。サンプルコードでカスタムペイロードが設定されていることに注目してください。
```
provisioningClient.setProvisioningPayload({a: 'b'});
```
このコードはこのクイックスタートでは必要ないため、コメントアウトしてもかまいません。カスタムペイロードは、カスタム割り当て関数を使用して IoT ハブにデバイスを割り当てる場合に必要になります。詳細については、カスタム割り当てポリシーの使用に関するチュートリアルを参照してください。

provisioningClient.register() は、デバイスの登録を試行するメソッドです。

これ以上の変更は必要ありません。
コマンドプロンプトで、次のコマンドを実行して、サンプルによって使用される環境変数を設定します。
- <provisioning-global-endpoint> を、手順 2 でコピーしたグローバルデバイスエンドポイントに置き換えます。
- <id-scope> を、手順 2 でコピーした ID スコープに置き換えます。
- <registration-id> を、デバイス登録に指定した登録 ID に置き換えます。
- <primarykey> を、デバイス登録からコピーしたプライマリキーに置き換えます。
```
set PROVISIONING_HOST=<provisioning-global-endpoint>
```
```
set PROVISIONING_IDSCOPE=<id-scope>
```
```
set PROVISIONING_REGISTRATION_ID=<registration-id>
```
```
set PROVISIONING_SYMMETRIC_KEY=<primarykey>
```
次のコマンドを使用して、サンプルコードをビルドし、実行します。
```
 npm install
```
```
node register_symkey.js
```

これで次の出力のようになるはずです。テストメッセージとして "Hello World" という文字列がハブに送信されます。

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

サンプルプロビジョニングコードでは、次のタスクを順に実行します。

次の 4 つのパラメーターを使用して、Device Provisioning リソースでデバイスを認証します。
- PROVISIONING_HOST
- PROVISIONING_IDSCOPE
- PROVISIONING_REGISTRATION_ID
- PROVISIONING_SYMMETRIC_KEY
Device Provisioning Service インスタンスに既にリンクされている IoT ハブにデバイスを割り当てます。
テストテレメトリメッセージを IoT ハブに送信します。

デバイス情報を使用してプロビジョニングサンプルを更新して実行するには、次のようにします。

Device Provisioning Service のメインメニューで、 [概要] を選択します。
[ID スコープ] と [グローバルデバイスエンドポイント] の値をコピーします。
コマンドプロンプトを開き、サンプルファイルの provision_symmetric_key.py があるディレクトリに移動します。
```
cd azure-iot-sdk-python\samples\async-hub-scenarios
```
コマンドプロンプトで、次のコマンドを実行して、サンプルによって使用される環境変数を設定します。
- <provisioning-global-endpoint> を、手順 2 でコピーしたグローバルデバイスエンドポイントに置き換えます。
- <id-scope> を、手順 2 でコピーした ID スコープに置き換えます。
- <registration-id> を、デバイス登録に指定した登録 ID に置き換えます。
- <primarykey> を、デバイス登録からコピーしたプライマリキーに置き換えます。
```
set PROVISIONING_HOST=<provisioning-global-endpoint>
```
```
set PROVISIONING_IDSCOPE=<id-scope>
```
```
set PROVISIONING_REGISTRATION_ID=<registration-id>
```
```
set PROVISIONING_SYMMETRIC_KEY=<primarykey>
```
次のコマンドを実行して、azure-iot-device ライブラリをインストールします。
```
pip install azure-iot-device
```
provision_symmetric_key.py の Python サンプルコードを実行します。
```
python provision_symmetric_key.py
```

これで次の出力のようになるはずです。一部の風速テレメトリメッセージも、テストとしてハブに送信されます。

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

サンプルプロビジョニングコードでは、次のタスクを順に実行します。

次の 4 つのパラメーターを使用して、Device Provisioning リソースでデバイスを認証します。
- GLOBAL_ENDPOINT
- SCOPE_ID
- REGISTRATION_ID
- SYMMETRIC_KEY
Device Provisioning Service インスタンスに既にリンクされている IoT ハブにデバイスを割り当てます。
テストテレメトリメッセージを IoT ハブに送信します。

デバイス情報を使用してプロビジョニングサンプルを更新して実行するには、次のようにします。

Device Provisioning Service のメインメニューで、 [概要] を選択します。
[ID スコープ] と [グローバルデバイスエンドポイント] の値をコピーします。これらの値はそれぞれ、SCOPE_ID パラメーターと GLOBAL_ENDPOINT パラメーターです。
Java デバイスサンプルコードを開いて編集します。デバイスのサンプルコードの完全パスは次のとおりです。

azure-iot-sdk-java/provisioning/provisioning-device-client-samples/provisioning-symmetrickey-individual-sample/src/main/java/samples/com/microsoft/azure/sdk/iot/ProvisioningSymmetricKeyIndividualEnrollmentSample.java
DPS とデバイスの登録に対して、次の変数の値を設定します。
- <id-scope> を、手順 2 でコピーした ID スコープに置き換えます。
- <provisioning-global-endpoint> を、手順 2 でコピーしたグローバルデバイスエンドポイントに置き換えます。
- <registration-id> を、デバイス登録に指定した登録 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>";
```
ビルドを実行するために、コマンドプロンプトを開きます。 Java SDK リポジトリのプロビジョニングサンプルプロジェクトフォルダーに移動します。
```
cd azure-iot-sdk-java\provisioning\provisioning-device-client-samples\provisioning-symmetrickey-individual-sample
```
サンプルをビルドします。
```
mvn clean install
```
target フォルダーに移動し、作成した .jar ファイルを実行します。 java コマンドで、{version} プレースホルダーをマシンの .jar ファイル名のバージョンに置き換えます。
```
cd target
java -jar ./provisioning-symmetrickey-individual-sample-{version}-with-deps.jar
```

これで次の出力のようになるはずです。

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

デバイスプロビジョニングの登録を確認する

Azure ポータルにアクセスします。
左側のメニューまたはポータルページで、 [すべてのリソース] を選択します。
デバイスが割り当てられた IoT ハブを選択します。
[デバイス管理] メニューで、[デバイス] を選択します。
デバイスが正常にプロビジョニングされた場合は、デバイス ID が一覧に表示され、[状態] が [有効] として設定されているはずです。デバイスが表示されていない場合は、ページの上部にある [最新の情報に更新] を選択します。

Note

[Initial device twin state](初期のデバイスツインの状態) をデバイスの登録エントリの既定値から変更した場合、デバイスはハブから目的のツインの状態をプルし、それに従って動作することができます。詳細については、「IoT Hub のデバイスツインの理解と使用」を参照してください。

リソースをクリーンアップする

デバイスクライアントサンプルでの作業と確認を続行する予定の場合は、このクイックスタートで作成したリソースをクリーンアップしないでください。続行する予定がない場合は、次の手順を使用して、このクイックスタートで作成したすべてのリソースを削除してください。

デバイスの登録を削除する

マシンに表示されているデバイスクライアントサンプルの出力ウィンドウを閉じます。
Azure portal の左側のメニューから、 [すべてのリソース] を選択します。
ご利用の Device Provisioning Service を選択します。
[設定] メニューで [登録の管理] を選択します。
[個別の登録] タブを選択します。
このクイックスタートで登録したデバイスの登録 ID の横にあるチェックボックスをオンにします。
ページの上部で、[削除] を選択します。

IoT Hub からデバイスの登録を削除する

Azure portal の左側のメニューから、 [すべてのリソース] を選択します。
IoT ハブを選択します。
[エクスプローラー] メニューで、 [IoT デバイス] を選択します。
このクイックスタートで登録したデバイスのデバイス ID の横にあるチェックボックスをオンにします。
ページの上部で、[削除] を選択します。

次のステップ

このクイックスタートでは、個別登録を使用して 1 つのデバイスを IoT ハブにプロビジョニングしました。次に、複数のハブ間で複数のデバイスをプロビジョニングする方法について説明します。

チュートリアル: カスタム割り当てポリシーを使用して IoT ハブ割り当てを管理する

次の方法で共有

クイックスタート: シミュレートされた対称キーデバイスをプロビジョニングする

前提条件

開発環境を準備する

デバイス登録を作成する

デバイスプロビジョニングコードを準備して実行する

デバイスプロビジョニングの登録を確認する

リソースをクリーンアップする

デバイスの登録を削除する

IoT Hub からデバイスの登録を削除する

次のステップ

フィードバック

その他のリソース

次の方法で共有

クイックスタート: シミュレートされた対称キー デバイスをプロビジョニングする

前提条件

開発環境を準備する

デバイス登録を作成する

デバイス プロビジョニング コードを準備して実行する

デバイス プロビジョニングの登録を確認する

リソースをクリーンアップする

デバイスの登録を削除する

IoT Hub からデバイスの登録を削除する

次のステップ

フィードバック

その他のリソース

クイックスタート: シミュレートされた対称キーデバイスをプロビジョニングする

デバイスプロビジョニングコードを準備して実行する

デバイスプロビジョニングの登録を確認する