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

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

このクイックスタートでは、シミュレートされたデバイスを Windows コンピューターに作成します。シミュレートされたデバイスは、認証のためにトラステッドプラットフォームモジュール (TPM) の構成証明メカニズムを使用するように構成されます。デバイスを構成した後、Azure IoT Hub Device Provisioning Service を使用して IoT ハブにプロビジョニングします。その後、サンプルコードを使用します。これは、デバイスを Device Provisioning Service インスタンスに登録するのに役立ちます。

プロビジョニングのプロセスに慣れていない場合は、プロビジョニングの概要を確認してください。また、先に進む前に、Azure Portal での IoT Hub Device Provisioning Service の設定に関するページの手順も済ませておいてください。

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

登録グループ。複数の関連するデバイスを登録するために使用されます。
個別登録。1 台のデバイスを登録するために使用されます。

この記事では、個別登録の使用方法を示します。

トラステッドプラットフォームモジュール (TPM) の構成証明は、Python SDK ではサポートされていません。 Python では、対称キーまたは X.509 証明書を使ってデバイスをプロビジョニングできます。

前提条件

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

Windows 開発環境の前提条件は次のとおりです。 Linux または macOS については、SDK ドキュメントの「開発環境を準備する」の該当するセクションを参照してください。

C++ によるデスクトップ開発ワークロードを有効にした Visual Studio 2019。 Visual Studio 2015 と Visual Studio 2017 もサポートされています。

Windows ベースのマシン上の TPM 2.0 ハードウェアセキュリティモジュール。
Windows ベースのコンピューターに .NET Core SDK 6.0 以降をインストールします。次のコマンドを使用してバージョンを確認してください。
```
dotnet --info
```

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

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

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

開発環境を準備する

このセクションでは、Azure IoT C SDK と TPM デバイスシミュレーターのサンプルをビルドするために使用する開発環境を準備します。

最新の 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
```

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-utpm-c の GitHub リポジトリをクローンします。
```
git clone https://github.com/Azure/azure-utpm-c.git --recursive
```

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

TPM デバイスシミュレーターをビルドして実行する

このセクションでは、TPM シミュレーターをビルドして実行します。このシミュレーターは、ソケットでポート 2321 とポート 2322 をリッスンします。コマンドウィンドウは閉じないでください。このクイックスタートを終了するまで、このシミュレーターを実行状態にしておく必要があります。

次のコマンドを実行して、TPM デバイスシミュレーターのサンプルコードを含む Azure IoT C SDK をビルドします。シミュレートされたデバイスの Visual Studio ソリューションが cmake ディレクトリに生成されます。このサンプルは、Shared Access Signature (SAS) トークン認証を使用して、TPM 構成証明メカニズムを提供します。
```
cmake -Duse_prov_client:BOOL=ON -Duse_tpm_simulator:BOOL=ON ..
```
ヒント

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

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

$ cmake -Duse_prov_client:BOOL=ON ..
-- Building for: Visual Studio 16 2019
-- The C compiler identification is MSVC 19.23.28107.0
-- The CXX compiler identification is MSVC 19.23.28107.0

...

-- Configuring done
-- Generating done
-- Build files have been written to: C:/code/azure-iot-sdk-c/cmake

クローンした git リポジトリのルートフォルダーに移動します。
以下に示すパスを使用して、TPM シミュレーターを実行します。
```
cd ..
.\provisioning_client\deps\utpm\tools\tpm_simulator\Simulator.exe
```
シミュレーターに出力は表示されません。 TPM デバイスがシミュレートされるので、実行したままにします。

GitHub ルートフォルダーに移動します。
シミュレートされたデバイスの HSM として TPM シミュレーターを実行します。
```
.\azure-utpm-c\tools\tpm_simulator\Simulator.exe
```
registerdevice という名前の新しい空のフォルダーを作成します。コマンドプロンプトで次のコマンドを使用して、registerdevice フォルダーに package.json ファイルを作成します (必ず、npm による質問に回答するか、既定値が適切であれば、それを受け入れてください)。
```
npm init
```
次の前段階パッケージをインストールします。
```
npm install node-gyp -g
npm install ffi-napi -g
```
Note

上記のパッケージのインストールには、いくつかの既知の問題があります。これらの問題を解決するには、 [管理者として実行] モードのコマンドプロンプトで npm install --global --production windows-build-tools を実行し、インストールしたバージョンにパスを置き換えて SET VCTargetsPath=C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V140 を実行します。その後、上のインストールコマンドを再実行します。
コマンドプロンプトで次のコマンドを実行し、registerdevice フォルダーに必要なすべてのパッケージをインストールします。
```
npm install --save azure-iot-device azure-iot-device-mqtt azure-iot-security-tpm azure-iot-provisioning-device-http azure-iot-provisioning-device
```
このコマンドでは次のパッケージがインストールされます。
- TPM と連係するセキュリティクライアント: azure-iot-security-tpm
- デバイスが Device Provisioning Service に接続するためのトランスポート: azure-iot-provisioning-device-http または azure-iot-provisioning-device-amqp
- トランスポートおよびセキュリティクライアントを使用するクライアント: azure-iot-provisioning-device
- デバイスクライアント: azure-iot-device
- トランスポート: azure-iot-device-amqp、azure-iot-device-mqtt、azure-iot-device-http のいずれか
- 既にインストール済みのセキュリティクライアント: azure-iot-security-tpm
  
  Note
  
  このクイックスタートのサンプルでは、azure-iot-provisioning-device-http および azure-iot-device-mqtt トランスポートを使用します。
任意のテキストエディターを開きます。
registerdevice フォルダーに、新しい ExtractDevice.js ファイルを作成します。

ExtractDevice.js ファイルの先頭に、次の require ステートメントを追加します。


'use strict';

var tpmSecurity = require('azure-iot-security-tpm');
var tssJs = require("tss.js");

var myTpm = new tpmSecurity.TpmSecurityClient(undefined, new tssJs.Tpm(true));

メソッドを実装するために、次の関数を追加します。


myTpm.getEndorsementKey(function(err, endorsementKey) {
  if (err) {
    console.log('The error returned from get key is: ' + err);
  } else {
    console.log('the endorsement key is: ' + endorsementKey.toString('base64'));
    myTpm.getRegistrationId((getRegistrationIdError, registrationId) => {
      if (getRegistrationIdError) {
        console.log('The error returned from get registration id is: ' + getRegistrationIdError);
      } else {
        console.log('The Registration Id is: ' + registrationId);
        process.exit();
      }
    });
  }
});

ExtractDevice.js ファイルを保存して閉じます。
```
node ExtractDevice.js
```
サンプルを実行します。
デバイス登録に必要な 保証キー と 登録 ID が出力ウィンドウに表示されます。これらの値をコピーします。

シミュレートされたデバイスの HSM として TPM シミュレーターを実行します。
[アクセスを許可] を選択します。シミュレーターでは、ソケットでポート 2321 および 2322 をリッスンします。このコマンドウィンドウを閉じないでください。このクイックスタートガイドの終了まで、このシミュレーターを実行状態にしておく必要があります。
```
.\azure-iot-sdk-java\provisioning\provisioning-tools\tpm-simulator\Simulator.exe
```
2 つ目のコマンドプロンプトを開きます。
2 つ目のコマンドプロンプトで、ルートフォルダーに移動し、サンプルの依存関係をビルドします。
```
cd azure-iot-sdk-java
mvn install -DskipTests=true
```

サンプルフォルダーに移動します。

cd provisioning/provisioning-samples/provisioning-tpm-sample

TPM デバイスから暗号化キーを読み取る

このセクションでは、実行したままにし、引き続きポート 2321 と 2322 でリッスンしている TPM シミュレーターから保証キーと登録 ID を読み取るサンプルをビルドして実行します。これらの値は、Device Provisioning Service インスタンスにデバイスを登録する際に使用します。

Visual Studio を起動します。
cmake フォルダーに生成されたソリューション (azure_iot_sdks.sln という名前) を開きます。
Visual Studio のメニューで [ビルド]>[ソリューションのビルド] の順に選択して、ソリューション内のすべてのプロジェクトをビルドします。
Visual Studio の "ソリューションエクスプローラー" ウィンドウで、Provision_Tools フォルダーに移動します。 tpm_device_provision プロジェクトを右クリックし、[スタートアッププロジェクトに設定] を選択します。
Visual Studio のメニューで [デバッグ]>[デバッグなしで開始] の順に選択して、ソリューションを実行します。アプリが登録 ID と保証キーを読み取って表示します。この値をメモに書くかコピーします。これらは次のセクションでデバイスを登録する際に使用します。

Azure portal にサインインし、左側のメニューの [すべてのリソース] ボタンを選択して、Device Provisioning Service を開きます。 "ID スコープ" と "プロビジョニングサービスグローバルエンドポイント" をメモします。

src/main/java/samples/com/microsoft/azure/sdk/iot/ProvisioningTpmSample.java を編集して、メモした "ID スコープ" と "プロビジョニングサービスグローバルエンドポイント" を含めます。

private static final String idScope = "[Your ID scope here]";
private static final String globalEndpoint = "[Your Provisioning Service Global Endpoint here]";
private static final ProvisioningDeviceClientTransportProtocol PROVISIONING_DEVICE_CLIENT_TRANSPORT_PROTOCOL = ProvisioningDeviceClientTransportProtocol.HTTPS;

ファイルを保存します。
次のコマンドを使用してプロジェクトをビルドし、ターゲットフォルダーに移動して、作成した jar ファイルを実行します ({version} は、ご利用の Java のバージョンに置き換えてください)。
```
mvn clean install
cd target
java -jar ./provisioning-tpm-sample-{version}-with-deps.jar
```
プログラムの実行が開始されると、[保証キー] と [登録キー] が表示されます。次のセクションのためにこれらの値をコピーします。プログラムは必ず実行したままにしておいてください。

このセクションでは、TPM 2.0 ハードウェアセキュリティモジュールから保証キーを読み取るサンプルをビルドして実行します。この値は、Device Provisioning Service インスタンスにデバイスを登録する際に使用します。

コマンドプロンプトで、ディレクトリを TPM デバイスプロビジョニングサンプルのプロジェクトディレクトリに変更します。
```
cd '.\azure-iot-sdk-csharp\provisioning\device\samples\how to guides\TpmSample\'
```
次のコマンドを入力して、TPM デバイスプロビジョニングサンプルをビルドして実行します。 TPM 2.0 ハードウェアセキュリティモジュールから返された保証キーをコピーして、デバイスを登録するときに後で使用できるようにします。
```
dotnet run -- -e
```

デバイス登録エントリを作成する

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

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

フィールド	説明
構成証明	[Attestation mechanism] (構成証明メカニズム) として [Trusted Platform Module (TPM)] (トラステッドプラットフォームモジュール (TPM)) を選択します。
トラステッドプラットフォームモジュール (TPM) の設定	この登録でのデバイスの検証に使用する保証キーを指定します。保証キーは、デバイスの TPM から取得できます。
登録 ID	デバイスの一意の登録 ID を指定します。登録 ID は、デバイスの TPM から取得できます。
プロビジョニングの状態	この登録をデバイスのプロビジョニングに使用できるようにする場合は、[この登録を有効にする] チェックボックスをオンにします。登録を無効にする場合は、このチェックボックスをオフにします。この設定は後で変更できます。
再プロビジョニングポリシー	再プロビジョニングを要求するデバイスを 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 のデバイスツインの理解と使用」を参照してください。

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

このクイックスタートの C# TPM サンプルでは登録 ID を提供していません。個々の登録で追加するように求められたら、独自の値を指定してください。

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

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

フィールド	説明
構成証明	[Attestation mechanism] (構成証明メカニズム) として [Trusted Platform Module (TPM)] (トラステッドプラットフォームモジュール (TPM)) を選択します。
トラステッドプラットフォームモジュール (TPM) の設定	この登録でのデバイスの検証に使用する保証キーを指定します。保証キーは、デバイスの TPM から取得できます。
登録 ID	デバイスの一意の登録 ID を指定します。登録 ID は、デバイスの TPM から取得できます。
プロビジョニングの状態	この登録をデバイスのプロビジョニングに使用できるようにする場合は、[この登録を有効にする] チェックボックスをオンにします。登録を無効にする場合は、このチェックボックスをオフにします。この設定は後で変更できます。
再プロビジョニングポリシー	再プロビジョニングを要求するデバイスを DPS で処理する方法を反映する再プロビジョニングポリシーを選択します。詳細については、再プロビジョニングポリシーに関するページを参照してください。

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

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

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

フィールド

説明

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

割り当てポリシー

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

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

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

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

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

デバイスの登録

このセクションでは、Advanced Message Queuing Protocol (AMQP) を使用して、デバイスのブートシーケンスを Device Provisioning Service インスタンスに送信するようにサンプルコードを構成します。このブートシーケンスにより、Device Provisioning Service インスタンスにリンクされた IoT ハブにデバイスが登録されます。

Azure portal で、Device Provisioning Service の [概要] タブを選択します。
[ID スコープ] の値をコピーします。
Visual Studio の [ソリューションエクスプローラー] ウィンドウで、Provision_Samples フォルダーに移動します。 prov_dev_client_sample という名前のサンプルプロジェクトを展開します。 [ソースファイル] を展開して、prov_dev_client_sample.c を開きます。
ファイルの先頭近くで、以下のような各デバイスプロトコルの #define ステートメントを探します。 SAMPLE_AMQP のみがコメント解除されていることを確認します。

現在、TPM の個別登録で MQTT プロトコルはサポートされていません。
```
//
// The protocol you wish to use should be uncommented
//
//#define SAMPLE_MQTT
//#define SAMPLE_MQTT_OVER_WEBSOCKETS
#define SAMPLE_AMQP
//#define SAMPLE_AMQP_OVER_WEBSOCKETS
//#define SAMPLE_HTTP
```
定数 id_scope を探し、以前にコピーした ID スコープの値で置き換えます。
```
static const char* id_scope = "0ne00002193";
```
同じファイル内で main() 関数の定義を探します。以下に示すように hsm_type 変数が SECURE_DEVICE_TYPE_TPM に設定されていることを確認します。
```
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 プロジェクトを右クリックし、[スタートアッププロジェクトに設定] を選択します。
Visual Studio のメニューで [デバッグ]>[デバッグなしで開始] の順に選択して、ソリューションを実行します。プロジェクトをリビルドするよう求められたら、 [はい] を選択して、プロジェクトをリビルドしてから実行します。

次の出力は、プロビジョニングデバイスクライアントのサンプルが正常に起動し、Device Provisioning Service インスタンスに接続して、IoT ハブの情報を取得し、登録した場合の例です。
```
Provisioning API Version: 1.2.7

Registering... Press enter key to interrupt.

Provisioning Status: PROV_DEVICE_REG_STATUS_CONNECTED
Provisioning Status: PROV_DEVICE_REG_STATUS_ASSIGNING
Provisioning Status: PROV_DEVICE_REG_STATUS_ASSIGNING

Registration Information received from service:
test-docs-hub.azure-devices.net, deviceId: test-docs-cert-device
```

Azure portal で、Device Provisioning Service の [概要] タブを選択します。
[ID スコープ] の値をコピーします。
コマンドプロンプトで、ディレクトリを TPM デバイスプロビジョニングサンプルのプロジェクトディレクトリに変更します。
```
 cd '.\azure-iot-sdk-csharp\provisioning\device\samples\how to guides\TpmSample\'
```

次のコマンドを実行して、デバイスを登録します。 <IdScope> を、コピーした DPS の値に置き換え、<RegistrationId> を、デバイス登録の作成時に使用した値に置き換えます。

dotnet run -- -s <IdScope> -r <RegistrationId>

デバイスの登録が成功した場合は、次のメッセージが表示されます。

Initializing security using the local TPM...
Initializing the device provisioning client...
Initialized for registration Id <RegistrationId>.
Registering with the device provisioning service...
Registration status: Assigned.
Device <RegistrationId> registered to <HubName>.azure-devices.net.
Creating TPM authentication for IoT Hub...
Testing the provisioned device with IoT Hub...
Sending a telemetry message...
Finished.

Azure portal で、Device Provisioning Service の [概要] タブを選択します。
[ID スコープ] の値をコピーします。
任意のテキストエディターを開きます。
registerdevice フォルダーに、新しい RegisterDevice.js ファイルを作成します。

RegisterDevice.js ファイルの先頭に、次の require ステートメントを追加します。


'use strict';

var ProvisioningTransport = require('azure-iot-provisioning-device-http').Http;
var iotHubTransport = require('azure-iot-device-mqtt').Mqtt;
var Client = require('azure-iot-device').Client;
var Message = require('azure-iot-device').Message;
var tpmSecurity = require('azure-iot-security-tpm');
var ProvisioningDeviceClient = require('azure-iot-provisioning-device').ProvisioningDeviceClient;

Note

Node.js 用 Azure IoT SDK では、AMQP、AMQP WS、MQTT WS などの追加プロトコルがサポートされています。詳細については、「Device Provisioning Service SDK for Node.js samples (Node.js 用 Device Provisioning Service SDK のサンプル)」を参照してください。

globalDeviceEndpoint と idScope 変数を追加し、それらを使用して ProvisioningDeviceClient インスタンスを作成します。 {globalDeviceEndpoint} と {idScope} を、手順 1. の " グローバルデバイスエンドポイント " と " ID スコープ " の値に置き換えます。


var provisioningHost = '{globalDeviceEndpoint}';
var idScope = '{idScope}';

var tssJs = require("tss.js");
var securityClient = new tpmSecurity.TpmSecurityClient('', new tssJs.Tpm(true));
// if using non-simulated device, replace the above line with following:
//var securityClient = new tpmSecurity.TpmSecurityClient();

var provisioningClient = ProvisioningDeviceClient.create(provisioningHost, idScope, new ProvisioningTransport(), securityClient);

デバイスにメソッドを実装する次の関数を追加します。


provisioningClient.register(function(err, result) {
  if (err) {
    console.log("error registering device: " + err);
  } else {
    console.log('registration succeeded');
    console.log('assigned hub=' + result.registrationState.assignedHub);
    console.log('deviceId=' + result.registrationState.deviceId);
    var tpmAuthenticationProvider = tpmSecurity.TpmAuthenticationProvider.fromTpmSecurityClient(result.registrationState.deviceId, result.registrationState.assignedHub, securityClient);
    var hubClient = Client.fromAuthenticationProvider(tpmAuthenticationProvider, iotHubTransport);

    var connectCallback = function (err) {
      if (err) {
        console.error('Could not connect: ' + err.message);
      } else {
        console.log('Client connected');
        var message = new Message('Hello world');
        hubClient.sendEvent(message, printResultFor('send'));
      }
    };

    hubClient.open(connectCallback);

    function printResultFor(op) {
      return function printResult(err, res) {
        if (err) console.log(op + ' error: ' + err.toString());
        if (res) console.log(op + ' status: ' + res.constructor.name);
        process.exit(1);
      };
    }
  }
});

RegisterDevice.js ファイルを保存して閉じます。
次のコマンドを実行します。
```
node RegisterDevice.js
```
デバイスが起動して Device Provisioning Service に接続し、IoT ハブの情報を取得する動作がシミュレートされるので、そのメッセージに注目してください。

コンピューター上で Java サンプルコードを実行しているコマンドウィンドウで、Enter キーを押してアプリケーションの実行を続けます。デバイスが起動して Device Provisioning Service に接続し、IoT ハブの情報を取得する動作がシミュレートされるので、そのメッセージに注目してください。

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

Azure portal にサインインします。
左側のメニューまたはポータルページで、 [すべてのリソース] を選択します。
デバイスが割り当てられた IoT ハブを選択します。
[エクスプローラー] メニューで、 [IoT デバイス] を選択します。

デバイスが正常にプロビジョニングされた場合は、デバイス ID が一覧に表示され、 [状態] が [有効] として設定されているはずです。デバイスが表示されていない場合は、ページの上部にある [最新の情報に更新] を選択します。

デバイスが正常にプロビジョニングされた場合は、デバイス ID が一覧に表示され、 [状態] が [有効] として設定されているはずです。デバイスが表示されていない場合は、ページの上部にある [最新の情報に更新] を選択します。

デバイスが正常にプロビジョニングされた場合は、デバイス ID が一覧に表示され、 [状態] が [有効] として設定されているはずです。デバイスが表示されていない場合は、ページの上部にある [最新の情報に更新] を選択します。

デバイスが正常にプロビジョニングされた場合は、デバイス ID が一覧に表示され、 [状態] が [有効] として設定されているはずです。デバイスが表示されていない場合は、ページの上部にある [最新の情報に更新] を選択します。

Note

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

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

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

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

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

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

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

次のステップ

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

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

次の方法で共有

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

前提条件

開発環境を準備する

TPM デバイスシミュレーターをビルドして実行する

TPM デバイスから暗号化キーを読み取る

デバイス登録エントリを作成する

デバイスの登録

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

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

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

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

次のステップ

フィードバック

その他のリソース

次の方法で共有

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

前提条件

開発環境を準備する

TPM デバイス シミュレーターをビルドして実行する

TPM デバイスから暗号化キーを読み取る

デバイス登録エントリを作成する

デバイスの登録

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

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

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

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

次のステップ

フィードバック

その他のリソース

TPM デバイスシミュレーターをビルドして実行する

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