Edits and added Entra connection text

gsteve88 · gsteve88 · commit e9f8932af74f · 2024-11-25T13:57:12.000-08:00
diff --git a/articles/iot-hub/how-to-device-management.md b/articles/iot-hub/how-to-device-management.md
@@ -8,30 +8,26 @@ manager: lizross
 ms.service: azure-iot-hub
 ms.devlang: csharp
 ms.topic: how-to
-ms.date: 10/09/2024
+ms.date: 11/25/2024
 zone_pivot_groups: iot-hub-howto-c2d-1
 ---
 
 # Get started with device management
 
 Back-end apps can use Azure IoT Hub primitives, such as [device twins](iot-hub-devguide-device-twins.md) and [direct methods](iot-hub-devguide-direct-methods.md), to remotely start and monitor device management actions on devices.
 
-Use a direct method to initiate device management actions (such as reboot, factory reset, and firmware update) from a back-end app in the cloud.
+Use a direct method to initiate device management actions (such as reboot, factory reset, and firmware update) from a back-end application.
 
 The device is responsible for:
 
 * Handling the method request sent from IoT Hub.
-
 * Initiating the corresponding device-specific action on the device.
-
 * Providing status updates through reported properties to IoT Hub.
 
-The back-end app can run device twin queries to report on the progress of the device management actions.
-
-This article shows you how a back-end app and a device app can work together to initiate and monitor a remote device action using direct methods and device twins. For this article, we use a device reboot as an example:
+This article shows you how a back-end app and a device app can work together to initiate and monitor a remote device action using a direct method.
 
-* A service app calls a direct method to reboot in a device app through an IoT hub. The service app then displays the response and updated reported properties.
-* A device app handles a direct method to reboot a device and updates the last reboot time.
+* A service app calls a direct method to reboot in a device app through an IoT hub.
+* A device app handles a direct method to reboot a device.
 
 [!INCLUDE [iot-hub-basic](../../includes/iot-hub-basic-whole.md)]
 
diff --git a/includes/iot-hub-howto-device-management-dotnet.md b/includes/iot-hub-howto-device-management-dotnet.md
@@ -7,7 +7,7 @@ ms.author: kgremban
 ms.service: iot-hub
 ms.devlang: csharp
 ms.topic: include
-ms.date: 10/09/2024
+ms.date: 11/25/2024
 ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 ---
 
@@ -27,6 +27,13 @@ This section describes how to use device application code to create a direct met
 
 Device client applications written in C# require the **Microsoft.Azure.Devices.Client** NuGet package.
 
+Add these `using` statements to use the device library.
+
+```csharp
+using Microsoft.Azure.Devices.Client;
+using Microsoft.Azure.Devices.Shared;
+```
+
 ### Connect to a device
 
 The [DeviceClient](/dotnet/api/microsoft.azure.devices.client.deviceclient) class exposes all the methods required to interact with device messages from the device.
@@ -125,8 +132,24 @@ The [ServiceClient](/dotnet/api/microsoft.azure.devices.serviceclient) class exp
 
 Backend service applications require the **Microsoft.Azure.Devices** NuGet package.
 
+Add these `using` statements to use the service library.
+
+```csharp
+using Microsoft.Azure.Devices;
+using Microsoft.Azure.Devices.Shared;
+```
+
 ### Connect to IoT hub
 
+You can connect a backend service to IoT Hub using the following methods:
+
+* Shared access policy
+* Microsoft Entra
+
+[!INCLUDE [iot-authentication-service-connection-string.md](iot-authentication-service-connection-string.md)]
+
+#### Connect using a shared access policy
+
 Connect a backend application using [CreateFromConnectionString](/dotnet/api/microsoft.azure.devices.serviceclient.createfromconnectionstring?#microsoft-azure-devices-serviceclient-createfromconnectionstring(system-string-microsoft-azure-devices-serviceclientoptions)).
 
 To invoke a direct method on a device through IoT Hub, your service needs the **service connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission.
@@ -141,6 +164,10 @@ static string connectionString = "{IoT hub service shared access policy connecti
 client = ServiceClient.CreateFromConnectionString(connectionString);
 ```
 
+#### Connect using Microsoft Entra
+
+[!INCLUDE [iot-hub-howto-connect-service-iothub-entra-dotnet](iot-hub-howto-connect-service-iothub-entra-dotnet.md)]
+
 ### Invoke a method on a device
 
 To invoke a method on a device:
diff --git a/includes/iot-hub-howto-device-management-java.md b/includes/iot-hub-howto-device-management-java.md
@@ -7,7 +7,7 @@ ms.author: kgremban
 ms.service: iot-hub
 ms.devlang: csharp
 ms.topic: include
-ms.date: 10/09/2024
+ms.date: 11/25/2024
 ms.custom: amqp, mqtt, devx-track-java, devx-track-extended-java
 ---
 
@@ -23,7 +23,7 @@ This section describes how to use device application code to create a direct met
 
 [!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
 
-### Device import statements
+### Device import statement
 
 Use the following device import statement to access the Azure IoT SDK for Java.
 
@@ -88,6 +88,15 @@ The `ServiceClient` [DeviceMethod](/java/api/com.microsoft.azure.sdk.iot.service
 
 ### Connect to IoT hub
 
+You can connect a backend service to IoT Hub using the following methods:
+
+* Shared access policy
+* Microsoft Entra
+
+[!INCLUDE [iot-authentication-service-connection-string.md](iot-authentication-service-connection-string.md)]
+
+#### Connect using a shared access policy
+
 Use the [DeviceMethod](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicemethod?#com-microsoft-azure-sdk-iot-service-devicetwin-devicemethod-devicemethod(java-lang-string)) constructor to add the service primary connection string and connect to IoT Hub.
 
 To invoke a direct method on a device through IoT Hub, your service needs the **service connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission.
@@ -101,6 +110,10 @@ public static final String iotHubConnectionString = "HostName=xxxxx.azure-device
 DeviceMethod methodClient = new DeviceMethod(iotHubConnectionString);
 ```
 
+#### Connect using Microsoft Entra
+
+[!INCLUDE [iot-hub-howto-connect-service-iothub-entra-java](iot-hub-howto-connect-service-iothub-entra-java.md)]
+
 ### Invoke a method on a device
 
 Call [invoke](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicemethod?#method-details) to invoke a method on a device and return its result.
diff --git a/includes/iot-hub-howto-device-management-node.md b/includes/iot-hub-howto-device-management-node.md
@@ -7,7 +7,7 @@ ms.author: kgremban
 ms.service: iot-hub
 ms.devlang: csharp
 ms.topic: include
-ms.date: 10/09/2024
+ms.date: 11/25/2024
 ms.custom: mqtt, devx-track-js
 ---
 
@@ -19,11 +19,7 @@ This article describes how to use the [Azure IoT SDK for Node.js](https://github
 
 ## Create a device application
 
-This section describes how to use device application code to:
-
-* Respond to a direct method called by the cloud
-* Trigger a simulated device reboot
-* Use the reported properties to enable device twin queries to identify devices and when they were last rebooted
+This section describes how to use device application code to create a direct method callback.
 
 ### Install SDK packages
 
@@ -161,7 +157,7 @@ The Azure IoT SDK for Node.js provides working samples of device apps that handl
 
 ## Create a backend application
 
-This section describes how to initiate a remote reboot on a device using a direct method. The app uses device twin queries to discover the last reboot time for that device.
+This section describes how to invoke a direct method on a device.
 
 ### Install service SDK package
 
@@ -177,6 +173,15 @@ The [Registry](/javascript/api/azure-iothub/registry) class exposes all methods
 
 ### Connect to IoT hub
 
+You can connect a backend service to IoT Hub using the following methods:
+
+* Shared access policy
+* Microsoft Entra
+
+[!INCLUDE [iot-authentication-service-connection-string.md](iot-authentication-service-connection-string.md)]
+
+#### Connect using a shared access policy
+
 Use [fromConnectionString](/javascript/api/azure-iothub/registry?#azure-iothub-registry-fromconnectionstring) to connect to IoT hub.
 
 To invoke a direct method on a device through IoT Hub, your service needs the **service connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission.
@@ -191,6 +196,10 @@ var client = Client.fromConnectionString(connectionString);
 var registry = Registry.fromConnectionString(serviceConnectionString);
 ```
 
+#### Connect using Microsoft Entra
+
+[!INCLUDE [iot-hub-howto-connect-service-iothub-entra-node](iot-hub-howto-connect-service-iothub-entra-node.md)]
+
 ### Invoke a method on a device
 
 Use [invokeDeviceMethod](/javascript/api/azure-iothub/client?#azure-iothub-client-invokedevicemethod) to invoke a direct method by name on a device. The method name parameter identifies the direct method. The method name is "reboot" in the examples within this article.
diff --git a/includes/iot-hub-howto-device-management-python.md b/includes/iot-hub-howto-device-management-python.md
@@ -7,27 +7,29 @@ ms.author: kgremban
 ms.service: iot-hub
 ms.devlang: csharp
 ms.topic: include
-ms.date: 10/09/2024
+ms.date: 11/25/2024
 ms.custom: mqtt, devx-track-python, py-fresh-zinc
 ---
 
   * **Python SDK** - [Python version 3.7 or later](https://www.python.org/downloads/) is recommended. Make sure to use the 32-bit or 64-bit installation as required by your setup. When prompted during the installation, make sure to add Python to your platform-specific environment variable.
 
-    * Device applications require the **azure-iot-device** package. You can install the package using this command:
+## Overview
 
-      ```cmd/sh
-        pip install azure-iot-device
-      ```
+This article describes how to use the [Azure IoT SDK for Python](https://github.com/Azure/azure-iot-sdk-python) to create device and backend service application code for device direct methods.
 
-    * Service applications require the **azure-iot-hub** package. You can install the package using this command:
+## Install packages
 
-      ```cmd/sh
-        pip install azure-iot-hub
-      ```
+The **azure-iot-device** library must be installed to create device applications.
 
-## Overview
+```cmd/sh
+pip install azure-iot-device
+```
 
-This article describes how to use the [Azure IoT SDK for Python](https://github.com/Azure/azure-iot-sdk-python) to create device and backend service application code for device direct methods.
+The **azure-iot-hub** library must be installed to create backend service applications.
+
+```cmd/sh
+pip install azure-iot-hub
+```
 
 ## Create a device application
 
@@ -41,12 +43,10 @@ This section describes how to use device application code to:
 
 ### Device import statements
 
-Add import statements to access `IoTHubDeviceClient` and `MethodResponse`.
+Add this import to access `IoTHubDeviceClient` and `MethodResponse`.
 
 ```python
 # import the device client library
-import time
-import datetime
 from azure.iot.device import IoTHubDeviceClient, MethodResponse
 ```
 
@@ -59,7 +59,7 @@ Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.devi
 ```python
 # substitute the device connection string in conn_str
 # and add it to the IoTHubDeviceClient object
-conn_str = "{IOT hub device connection string}"
+conn_str = "{IoT hub device connection string}"
 device_client = IoTHubDeviceClient.create_from_connection_string(conn_str)
 ```
 
@@ -127,14 +127,21 @@ The [IoTHubRegistryManager](/python/api/azure-iot-hub/azure.iot.hub.iothubregist
 Add these import statements to connect to Iot Hub, receive cloud-to-device methods, and call device twin methods.
 
 ```python
-import sys, time
-
 from azure.iot.hub import IoTHubRegistryManager
 from azure.iot.hub.models import CloudToDeviceMethod, CloudToDeviceMethodResult, Twin
 ```
 
 ### Connect to IoT hub
 
+You can connect a backend service to IoT Hub using the following methods:
+
+* Shared access policy
+* Microsoft Entra
+
+[!INCLUDE [iot-authentication-service-connection-string.md](iot-authentication-service-connection-string.md)]
+
+#### Connect using a shared access policy
+
 Connect to IoT hub using [from_connection_string](/python/api/azure-iot-hub/azure.iot.hub.iothubregistrymanager?#azure-iot-hub-iothubregistrymanager-from-connection-string). As a parameter, supply the **IoT Hub service connection string** that you created in the prerequisites section.
 
 To invoke a direct method on a device through IoT Hub, your service needs the **service connect** permission. By default, every IoT Hub is created with a shared access policy named **service** that grants this permission.
@@ -149,6 +156,10 @@ IOTHUB_CONNECTION_STRING = "{IoT hub service connection string}"
 iothub_registry_manager = IoTHubRegistryManager.from_connection_string(IOTHUB_CONNECTION_STRING)
 ```
 
+#### Connect using Microsoft Entra
+
+[!INCLUDE [iot-hub-howto-connect-service-iothub-entra-python](iot-hub-howto-connect-service-iothub-entra-python.md)]
+
 ### Invoke a method on a device
 
 You can invoke a direct method by name on a device. The method name identifies the method. The method name is "rebootTime" in the examples within this article.
