X.509 証明書を使用するデバイスを Azure IoT Central アプリケーションに接続する方法

Windows を使用している場合、サンプルを機能させるには、X.509 証明書を Windows 証明書ストアに格納する必要があります。 Windows エクスプローラーで、以前生成した PFX ファイル mytestrootcert.pfx および sampleDevice01.pfx をダブルクリックします。 証明書のインポート ウィザードで、ストアの場所として [現在のユーザー] を選択し、パスワードとして1234を入力して、ウィザードに証明書ストアを自動的に選択させます。 ウィザードにより、現在のユーザーの個人用ストアに証明書がインポートされます。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. Visual Studio の IoTHubDeviceSamples ソリューションで、TemperatureController プロジェクトの Parameter.cs ファイルを開きます。

2. 次の 2 つのパラメーター定義をクラスに追加します。

   [Option(
       'x',
       "CertificatePath",
       HelpText = "(Required if DeviceSecurityType is \"dps\"). \nThe device PFX file to use during device provisioning." +
       "\nDefaults to environment variable \"IOTHUB_DEVICE_X509_CERT\".")]
   public string CertificatePath { get; set; } = Environment.GetEnvironmentVariable("IOTHUB_DEVICE_X509_CERT");
   
   [Option(
       'p',
       "CertificatePassword",
       HelpText = "(Required if DeviceSecurityType is \"dps\"). \nThe password of the PFX certificate file." +
       "\nDefaults to environment variable \"IOTHUB_DEVICE_X509_PASSWORD\".")]
   public string CertificatePassword { get; set; } = Environment.GetEnvironmentVariable("IOTHUB_DEVICE_X509_PASSWORD");
   

   変更を保存します。

3. Visual Studio の IoTHubDeviceSamples ソリューションで、TemperatureController プロジェクトの Program.cs ファイルを開きます。

4. 次の using ステートメントを追加します。

   using System.Security.Cryptography.X509Certificates;
   using System.IO;
   

5. クラスに次のメソッドを追加します。

   private static X509Certificate2 LoadProvisioningCertificate(Parameters parameters)
   {
       var certificateCollection = new X509Certificate2Collection();
       certificateCollection.Import(
           parameters.CertificatePath,
           parameters.CertificatePassword,
           X509KeyStorageFlags.UserKeySet);
   
       X509Certificate2 certificate = null;
   
       foreach (X509Certificate2 element in certificateCollection)
       {
           Console.WriteLine($"Found certificate: {element?.Thumbprint} {element?.Subject}; PrivateKey: {element?.HasPrivateKey}");
           if (certificate == null && element.HasPrivateKey)
           {
               certificate = element;
           }
           else
           {
               element.Dispose();
           }
       }
   
       if (certificate == null)
       {
           throw new FileNotFoundException($"{parameters.CertificatePath} did not contain any certificate with a private key.");
       }
   
       Console.WriteLine($"Using certificate {certificate.Thumbprint} {certificate.Subject}");
   
       return certificate;
   }
   

6. SetupDeviceClientAsync メソッド内で、case "dps" のコード ブロックを次のコードに置き換えます。

   case "dps":
       s_logger.LogDebug($"Initializing via DPS");
       Console.WriteLine($"Loading the certificate...");
       X509Certificate2 certificate = LoadProvisioningCertificate(parameters);
       DeviceRegistrationResult dpsRegistrationResult = await ProvisionDeviceAsync(parameters, certificate, cancellationToken);
       var authMethod = new DeviceAuthenticationWithX509Certificate(dpsRegistrationResult.DeviceId, certificate);
       deviceClient = InitializeDeviceClient(dpsRegistrationResult.AssignedHub, authMethod);
       break;
   

7. ProvisionDeviceAsync メソッドを次のコードで置き換えます。

   private static async Task<DeviceRegistrationResult> ProvisionDeviceAsync(Parameters parameters, X509Certificate2 certificate, CancellationToken cancellationToken)
   {
       SecurityProvider security = new SecurityProviderX509Certificate(certificate);
       ProvisioningTransportHandler mqttTransportHandler = new ProvisioningTransportHandlerMqtt();
       ProvisioningDeviceClient pdc = ProvisioningDeviceClient.Create(parameters.DpsEndpoint, parameters.DpsIdScope, security, mqttTransportHandler);
   
       var pnpPayload = new ProvisioningRegistrationAdditionalData
       {
           JsonData = PnpConvention.CreateDpsPayload(ModelId),
       };
       return await pdc.RegisterAsync(pnpPayload, cancellationToken);
   }
   

   変更を保存します。

サンプルを実行するには

1. 次の環境変数をプロジェクトに追加します。

   • IOTHUB_DEVICE_X509_CERT: <full path to folder that contains PFX files>sampleDevice01.pfx
   • IOTHUB_DEVICE_X509_PASSWORD: 1234

2. アプリケーションをビルドして実行します。 デバイスが正常にプロビジョニングされたことを確認します。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. 温度コントローラー デバイス サンプル用の pom.xml ファイルと src フォルダーが含まれる、azure-iot-sdk-java/device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample フォルダーに移動します。

2. pom.xml ファイルを編集して、<dependencies> ノードに次の依存関係構成を追加します。

   <dependency>
       <groupId>com.microsoft.azure.sdk.iot.provisioning.security</groupId>
       <artifactId>${x509-provider-artifact-id}</artifactId>
       <version>${x509-provider-version}</version>
   </dependency>
   

   変更を保存します。

3. テキスト エディターで src/main/java/samples/com/microsoft/azure/sdk/iot/device/TemperatureController.java ファイルを開きます。

4. SecurityProviderSymmetricKey の import を次の import に置き換えます。

   import com.microsoft.azure.sdk.iot.provisioning.security.SecurityProvider;
   import com.microsoft.azure.sdk.iot.provisioning.security.hsm.SecurityProviderX509Cert;
   import com.microsoft.azure.sdk.iot.provisioning.security.exceptions.SecurityProviderException;
   

5. 次の import を追加します。

   import java.nio.file.*;
   

6. main メソッドでスローされる例外リストに SecurityProviderException を追加します。

   public static void main(String[] args) throws IOException, URISyntaxException, ProvisioningDeviceClientException, InterruptedException, SecurityProviderException {
   

7. initializeAndProvisionDevice メソッドを次のコードで置き換えます。

   private static void initializeAndProvisionDevice() throws ProvisioningDeviceClientException, IOException, URISyntaxException, InterruptedException, SecurityProviderException {
       String deviceX509Key = new String(Files.readAllBytes(Paths.get(System.getenv("IOTHUB_DEVICE_X509_KEY"))));
       String deviceX509Cert = new String(Files.readAllBytes(Paths.get(System.getenv("IOTHUB_DEVICE_X509_CERT"))));
       SecurityProvider securityProviderX509 = new SecurityProviderX509Cert(deviceX509Cert, deviceX509Key, null);
       ProvisioningDeviceClient provisioningDeviceClient;
       ProvisioningStatus provisioningStatus = new ProvisioningStatus();
   
       provisioningDeviceClient = ProvisioningDeviceClient.create(globalEndpoint, scopeId, provisioningProtocol, securityProviderX509);
   
       AdditionalData additionalData = new AdditionalData();
       additionalData.setProvisioningPayload(com.microsoft.azure.sdk.iot.provisioning.device.plugandplay.PnpHelper.createDpsPayload(MODEL_ID));
   
       provisioningDeviceClient.registerDevice(new ProvisioningDeviceClientRegistrationCallbackImpl(), provisioningStatus, additionalData);
   
       while (provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() != ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_ASSIGNED)
       {
           if (provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_ERROR ||
                   provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_DISABLED ||
                   provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_FAILED)
           {
               provisioningStatus.exception.printStackTrace();
               System.out.println("Registration error, bailing out");
               break;
           }
           System.out.println("Waiting for Provisioning Service to register");
           Thread.sleep(MAX_TIME_TO_WAIT_FOR_REGISTRATION);
       }
   
       ClientOptions options = new ClientOptions();
       options.setModelId(MODEL_ID);
   
       if (provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_ASSIGNED) {
           System.out.println("IotHUb Uri : " + provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getIothubUri());
           System.out.println("Device ID : " + provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getDeviceId());
   
           String iotHubUri = provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getIothubUri();
           String deviceId = provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getDeviceId();
   
           log.debug("Opening the device client.");
           deviceClient = DeviceClient.createFromSecurityProvider(iotHubUri, deviceId, securityProviderX509, IotHubClientProtocol.MQTT, options);
           deviceClient.open();
       }
   }
   

   変更を保存します。

サンプルを実行するには

1. シェル環境で、次の 2 つの環境変数を追加します。 PEM ファイルへの完全なパスを指定し、オペレーティング システムに合ったパス区切り記号を使用してください。

   set IOTHUB_DEVICE_X509_CERT=<full path to folder that contains PEM files>sampleDevice01_cert.pem
   set IOTHUB_DEVICE_X509_KEY=<full path to folder that contains PEM files>sampleDevice01_key.pem
   

   ヒント

   その他の必要な環境変数は、クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続に関するチュートリアルを完了したときに設定しています。

2. アプリケーションをビルドして実行します。 デバイスが正常にプロビジョニングされたことを確認します。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. pnp_temperature_controller.js アプリケーションが格納されている azure-iot-sdk-node/device/samples/javascript フォルダーに移動し、次のコマンドを実行して X.509 パッケージをインストールします。

   npm install azure-iot-security-x509 --save
   

2. テキスト エディターで pnp_temperature_controller.js ファイルを開きます。

3. require ステートメントを編集して、次のコードを含めます。

   const fs = require('fs');
   const X509Security = require('azure-iot-security-x509').X509Security;
   

4. 次の 4 行を "DPS 接続情報" セクションに追加して、deviceCert 変数が初期化されるようにします。

   const deviceCert = {
     cert: fs.readFileSync(process.env.IOTHUB_DEVICE_X509_CERT).toString(),
     key: fs.readFileSync(process.env.IOTHUB_DEVICE_X509_KEY).toString()
   };
   

5. クライアントを作成する provisionDevice 関数を編集し、最初の行を次のコードに置き換えます。

   var provSecurityClient = new X509Security(registrationId, deviceCert);
   

6. 同じ関数で、deviceConnectionString 変数を設定する行を次のように変更します。

   deviceConnectionString = 'HostName=' + result.assignedHub + ';DeviceId=' + result.deviceId + ';x509=true';
   

7. main 関数で、Client.fromConnectionString を呼び出す行の後に次の行を追加します。

   client.setOptions(deviceCert);
   

   変更を保存します。

サンプルを実行するには

1. シェル環境で、次の 2 つの環境変数を追加します。 PEM ファイルへの完全なパスを指定し、オペレーティング システムに合ったパス区切り記号を使用してください。

   set IOTHUB_DEVICE_X509_CERT=<full path to folder that contains PEM files>sampleDevice01_cert.pem
   set IOTHUB_DEVICE_X509_KEY=<full path to folder that contains PEM files>sampleDevice01_key.pem
   

   ヒント

   その他の必要な環境変数は、クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続に関するチュートリアルを完了したときに設定しています。

2. スクリプトを実行し、デバイスが正常にプロビジョニングされたことを確認します。

   node pnp_temperature_controller.js
   

X.509 証明書を使用するようにサンプル コードを変更するには:

1. azure-iot-device/samples/pnp フォルダーに移動し、テキスト エディターで temp_controller_with_thermostats.py ファイルを開きます。

2. 次の from ステートメントを追加して、X.509 機能をインポートします。

   from azure.iot.device import X509
   

3. provision_device 関数の最初の部分を次のように変更します。

   async def provision_device(provisioning_host, id_scope, registration_id, x509, model_id):
       provisioning_device_client = ProvisioningDeviceClient.create_from_x509_certificate(
           provisioning_host=provisioning_host,
           registration_id=registration_id,
           id_scope=id_scope,
           x509=x509,
       )
   

4. main 関数で、symmetric_key 変数を設定する行を以下のコードに置き換えます。

   x509 = X509(
       cert_file=os.getenv("IOTHUB_DEVICE_X509_CERT"),
       key_file=os.getenv("IOTHUB_DEVICE_X509_KEY"),
   )
   

5. main 関数で、provision_device 関数を呼び出す行を以下のコードに置き換えます。

   registration_result = await provision_device(
       provisioning_host, id_scope, registration_id, x509, model_id
   )
   

6. main 関数で、IoTHubDeviceClient.create_from_symmetric_key 関数を呼び出す行を以下のコードに置き換えます。

   device_client = IoTHubDeviceClient.create_from_x509_certificate(
       x509=x509,
       hostname=registration_result.registration_state.assigned_hub,
       device_id=registration_result.registration_state.device_id,
       product_info=model_id,
   )
   

   変更を保存します。

サンプルを実行するには

1. シェル環境で、次の 2 つの環境変数を追加します。 PEM ファイルへの完全なパスを指定し、オペレーティング システムに合ったパス区切り記号を使用してください。

   set IOTHUB_DEVICE_X509_CERT=<full path to folder that contains PEM files>sampleDevice01_cert.pem
   set IOTHUB_DEVICE_X509_KEY=<full path to folder that contains PEM files>sampleDevice01_key.pem
   

   ヒント

   その他の必要な環境変数は、クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続に関するチュートリアルを完了したときに設定しています。

2. スクリプトを実行し、デバイスが正常にプロビジョニングされたことを確認します。

   python temp_controller_with_thermostats.py
   

Windows を使用している場合、サンプルを機能させるには、X.509 証明書を Windows 証明書ストアに格納する必要があります。 Windows エクスプローラーで、以前生成した PFX ファイル mytestselfcertprimary.pfx および mytestselfcertsecondary.pfx をダブルクリックします。 証明書のインポート ウィザードで、ストアの場所として [現在のユーザー] を選択し、パスワードとして1234を入力して、ウィザードに証明書ストアを自動的に選択させます。 ウィザードにより、現在のユーザーの個人用ストアに証明書がインポートされます。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. Visual Studio の IoTHubDeviceSamples ソリューションで、TemperatureController プロジェクトの Parameter.cs ファイルを開きます。

2. 次の 2 つのパラメーター定義をクラスに追加します。

   [Option(
       'x',
       "CertificatePath",
       HelpText = "(Required if DeviceSecurityType is \"dps\"). \nThe device PFX file to use during device provisioning." +
       "\nDefaults to environment variable \"IOTHUB_DEVICE_X509_CERT\".")]
   public string CertificatePath { get; set; } = Environment.GetEnvironmentVariable("IOTHUB_DEVICE_X509_CERT");
   
   [Option(
       'p',
       "CertificatePassword",
       HelpText = "(Required if DeviceSecurityType is \"dps\"). \nThe password of the PFX certificate file." +
       "\nDefaults to environment variable \"IOTHUB_DEVICE_X509_PASSWORD\".")]
   public string CertificatePassword { get; set; } = Environment.GetEnvironmentVariable("IOTHUB_DEVICE_X509_PASSWORD");
   

   変更を保存します。

3. Visual Studio の IoTHubDeviceSamples ソリューションで、TemperatureController プロジェクトの Program.cs ファイルを開きます。

4. 次の using ステートメントを追加します。

   using System.Security.Cryptography.X509Certificates;
   using System.IO;
   

5. クラスに次のメソッドを追加します。

   private static X509Certificate2 LoadProvisioningCertificate(Parameters parameters)
   {
       var certificateCollection = new X509Certificate2Collection();
       certificateCollection.Import(
           parameters.CertificatePath,
           parameters.CertificatePassword,
           X509KeyStorageFlags.UserKeySet);
   
       X509Certificate2 certificate = null;
   
       foreach (X509Certificate2 element in certificateCollection)
       {
           Console.WriteLine($"Found certificate: {element?.Thumbprint} {element?.Subject}; PrivateKey: {element?.HasPrivateKey}");
           if (certificate == null && element.HasPrivateKey)
           {
               certificate = element;
           }
           else
           {
               element.Dispose();
           }
       }
   
       if (certificate == null)
       {
           throw new FileNotFoundException($"{parameters.CertificatePath} did not contain any certificate with a private key.");
       }
   
       Console.WriteLine($"Using certificate {certificate.Thumbprint} {certificate.Subject}");
   
       return certificate;
   }
   

6. SetupDeviceClientAsync メソッド内で、case "dps" のコード ブロックを次のコードに置き換えます。

   case "dps":
       s_logger.LogDebug($"Initializing via DPS");
       Console.WriteLine($"Loading the certificate...");
       X509Certificate2 certificate = LoadProvisioningCertificate(parameters);
       DeviceRegistrationResult dpsRegistrationResult = await ProvisionDeviceAsync(parameters, certificate, cancellationToken);
       var authMethod = new DeviceAuthenticationWithX509Certificate(dpsRegistrationResult.DeviceId, certificate);
       deviceClient = InitializeDeviceClient(dpsRegistrationResult.AssignedHub, authMethod);
       break;
   

7. ProvisionDeviceAsync メソッドを次のコードで置き換えます。

   private static async Task<DeviceRegistrationResult> ProvisionDeviceAsync(Parameters parameters, X509Certificate2 certificate, CancellationToken cancellationToken)
   {
       SecurityProvider security = new SecurityProviderX509Certificate(certificate);
       ProvisioningTransportHandler mqttTransportHandler = new ProvisioningTransportHandlerMqtt();
       ProvisioningDeviceClient pdc = ProvisioningDeviceClient.Create(parameters.DpsEndpoint, parameters.DpsIdScope, security, mqttTransportHandler);
   
       var pnpPayload = new ProvisioningRegistrationAdditionalData
       {
           JsonData = PnpConvention.CreateDpsPayload(ModelId),
       };
       return await pdc.RegisterAsync(pnpPayload, cancellationToken);
   }
   

   変更を保存します。

サンプルを実行するには

1. 次の環境変数をプロジェクトに追加します。

   • IOTHUB_DEVICE_DPS_DEVICE_ID: mytestselfcertprimary
   • IOTHUB_DEVICE_X509_CERT: <full path to folder that contains PFX files>mytestselfcertprimary.pfx
   • IOTHUB_DEVICE_X509_PASSWORD: 1234

2. アプリケーションをビルドして実行します。 デバイスが正常にプロビジョニングされたことを確認します。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. 温度コントローラー デバイス サンプル用の pom.xml ファイルと src フォルダーが含まれる、azure-iot-sdk-java/device/iot-device-samples/pnp-device-sample/temperature-controller-device-sample フォルダーに移動します。

2. pom.xml ファイルを編集して、<dependencies> ノードに次の依存関係構成を追加します。

   <dependency>
       <groupId>com.microsoft.azure.sdk.iot.provisioning.security</groupId>
       <artifactId>${x509-provider-artifact-id}</artifactId>
       <version>${x509-provider-version}</version>
   </dependency>
   

   変更を保存します。

3. テキスト エディターで src/main/java/samples/com/microsoft/azure/sdk/iot/device/TemperatureController.java ファイルを開きます。

4. SecurityProviderSymmetricKey の import を次の import に置き換えます。

   import com.microsoft.azure.sdk.iot.provisioning.security.SecurityProvider;
   import com.microsoft.azure.sdk.iot.provisioning.security.hsm.SecurityProviderX509Cert;
   import com.microsoft.azure.sdk.iot.provisioning.security.exceptions.SecurityProviderException;
   

5. 次の import を追加します。

   import java.nio.file.*;
   

6. main メソッドでスローされる例外リストに SecurityProviderException を追加します。

   public static void main(String[] args) throws IOException, URISyntaxException, ProvisioningDeviceClientException, InterruptedException, SecurityProviderException {
   

7. initializeAndProvisionDevice メソッドを次のコードで置き換えます。

   private static void initializeAndProvisionDevice() throws ProvisioningDeviceClientException, IOException, URISyntaxException, InterruptedException, SecurityProviderException {
       String deviceX509Key = new String(Files.readAllBytes(Paths.get(System.getenv("IOTHUB_DEVICE_X509_KEY"))));
       String deviceX509Cert = new String(Files.readAllBytes(Paths.get(System.getenv("IOTHUB_DEVICE_X509_CERT"))));
       SecurityProvider securityProviderX509 = new SecurityProviderX509Cert(deviceX509Cert, deviceX509Key, null);
       ProvisioningDeviceClient provisioningDeviceClient;
       ProvisioningStatus provisioningStatus = new ProvisioningStatus();
   
       provisioningDeviceClient = ProvisioningDeviceClient.create(globalEndpoint, scopeId, provisioningProtocol, securityProviderX509);
   
       AdditionalData additionalData = new AdditionalData();
       additionalData.setProvisioningPayload(com.microsoft.azure.sdk.iot.provisioning.device.plugandplay.PnpHelper.createDpsPayload(MODEL_ID));
   
       provisioningDeviceClient.registerDevice(new ProvisioningDeviceClientRegistrationCallbackImpl(), provisioningStatus, additionalData);
   
       while (provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() != ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_ASSIGNED)
       {
           if (provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_ERROR ||
                   provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_DISABLED ||
                   provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_FAILED)
           {
               provisioningStatus.exception.printStackTrace();
               System.out.println("Registration error, bailing out");
               break;
           }
           System.out.println("Waiting for Provisioning Service to register");
           Thread.sleep(MAX_TIME_TO_WAIT_FOR_REGISTRATION);
       }
   
       ClientOptions options = new ClientOptions();
       options.setModelId(MODEL_ID);
   
       if (provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getProvisioningDeviceClientStatus() == ProvisioningDeviceClientStatus.PROVISIONING_DEVICE_STATUS_ASSIGNED) {
           System.out.println("IotHUb Uri : " + provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getIothubUri());
           System.out.println("Device ID : " + provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getDeviceId());
   
           String iotHubUri = provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getIothubUri();
           String deviceId = provisioningStatus.provisioningDeviceClientRegistrationInfoClient.getDeviceId();
   
           log.debug("Opening the device client.");
           deviceClient = DeviceClient.createFromSecurityProvider(iotHubUri, deviceId, securityProviderX509, IotHubClientProtocol.MQTT, options);
           deviceClient.open();
       }
   }
   

   変更を保存します。

サンプルを実行するには

1. シェル環境で、次の 2 つの環境変数を追加します。 PEM ファイルへの完全なパスを指定し、オペレーティング システムに合ったパス区切り記号を使用してください。

   set IOTHUB_DEVICE_DPS_DEVICE_ID=mytestselfcertprimary
   set IOTHUB_DEVICE_X509_CERT=<full path to folder that contains PEM files>mytestselfcertprimary_cert.pem
   set IOTHUB_DEVICE_X509_KEY=<full path to folder that contains PEM files>mytestselfcertprimary_key.pem
   

   ヒント

   その他の必要な環境変数は、クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続に関するチュートリアルを完了したときに設定しています。

2. アプリケーションをビルドして実行します。 デバイスが正常にプロビジョニングされたことを確認します。

mytestselfcertsecondary 証明書に対して、上記の手順を繰り返すことができます。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. pnp_temperature_controller.js アプリケーションが格納されている azure-iot-sdk-node/device/samples/javascript フォルダーに移動し、次のコマンドを実行して X.509 パッケージをインストールします。

   npm install azure-iot-security-x509 --save
   

2. テキスト エディターで pnp_temperature_controller.js ファイルを開きます。

3. require ステートメントを編集して、次のコードを含めます。

   const fs = require('fs');
   const X509Security = require('azure-iot-security-x509').X509Security;
   

4. 次の 4 行を "DPS 接続情報" セクションに追加して、deviceCert 変数が初期化されるようにします。

   const deviceCert = {
     cert: fs.readFileSync(process.env.IOTHUB_DEVICE_X509_CERT).toString(),
     key: fs.readFileSync(process.env.IOTHUB_DEVICE_X509_KEY).toString()
   };
   

5. クライアントを作成する provisionDevice 関数を編集し、最初の行を次のコードに置き換えます。

   var provSecurityClient = new X509Security(registrationId, deviceCert);
   

6. 同じ関数で、deviceConnectionString 変数を設定する行を次のように変更します。

   deviceConnectionString = 'HostName=' + result.assignedHub + ';DeviceId=' + result.deviceId + ';x509=true';
   

7. main 関数で、Client.fromConnectionString を呼び出す行の後に次の行を追加します。

   client.setOptions(deviceCert);
   

   変更を保存します。

サンプルを実行するには

1. シェル環境で、次の 2 つの環境変数を追加します。 PEM ファイルへの完全なパスを指定し、オペレーティング システムに合ったパス区切り記号を使用してください。

   set IOTHUB_DEVICE_DPS_DEVICE_ID=mytestselfcertprimary
   set IOTHUB_DEVICE_X509_CERT=<full path to folder that contains PEM files>mytestselfcertprimary_cert.pem
   set IOTHUB_DEVICE_X509_KEY=<full path to folder that contains PEM files>mytestselfcertprimary_key.pem
   

   ヒント

   その他の必要な環境変数は、クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続に関するチュートリアルを完了したときに設定しています。

2. スクリプトを実行し、デバイスが正常にプロビジョニングされたことを確認します。

   node pnp_temperature_controller.js
   

mytestselfcertsecondary 証明書に対して、上記の手順を繰り返すことができます。

X.509 証明書を使用するようにサンプル コードを変更するには:

1. azure-iot-device/samples/pnp フォルダーに移動し、テキスト エディターで temp_controller_with_thermostats.py ファイルを開きます。

2. 次の from ステートメントを追加して、X.509 機能をインポートします。

   from azure.iot.device import X509
   

3. provision_device 関数の最初の部分を次のように変更します。

   async def provision_device(provisioning_host, id_scope, registration_id, x509, model_id):
       provisioning_device_client = ProvisioningDeviceClient.create_from_x509_certificate(
           provisioning_host=provisioning_host,
           registration_id=registration_id,
           id_scope=id_scope,
           x509=x509,
       )
   

4. main 関数で、symmetric_key 変数を設定する行を以下のコードに置き換えます。

   x509 = X509(
       cert_file=os.getenv("IOTHUB_DEVICE_X509_CERT"),
       key_file=os.getenv("IOTHUB_DEVICE_X509_KEY"),
   )
   

5. main 関数で、provision_device 関数を呼び出す行を以下のコードに置き換えます。

   registration_result = await provision_device(
       provisioning_host, id_scope, registration_id, x509, model_id
   )
   

6. main 関数で、IoTHubDeviceClient.create_from_symmetric_key 関数を呼び出す行を以下のコードに置き換えます。

   device_client = IoTHubDeviceClient.create_from_x509_certificate(
       x509=x509,
       hostname=registration_result.registration_state.assigned_hub,
       device_id=registration_result.registration_state.device_id,
       product_info=model_id,
   )
   

   変更を保存します。

サンプルを実行するには

1. シェル環境で、次の 2 つの環境変数を追加します。 PEM ファイルへの完全なパスを指定し、オペレーティング システムに合ったパス区切り記号を使用してください。

   set IOTHUB_DEVICE_DPS_DEVICE_ID=mytestselfcertprimary
   set IOTHUB_DEVICE_X509_CERT=<full path to folder that contains PEM files>mytestselfcertprimary_cert.pem
   set IOTHUB_DEVICE_X509_KEY=<full path to folder that contains PEM files>mytestselfcertprimary_key.pem
   

   ヒント

   その他の必要な環境変数は、クライアント アプリケーションを作成して Azure IoT Central アプリケーションに接続に関するチュートリアルを完了したときに設定しています。

2. スクリプトを実行し、デバイスが正常にプロビジョニングされたことを確認します。

   python temp_controller_with_thermostats.py
   

mytestselfcertsecondary 証明書に対して、上記の手順を繰り返すことができます。