Updated to add cert auth

Author: gsteve88

includes/iot-hub-howto-device-twins-dotnet.md

@@ -7,7 +7,7 @@ ms.author: kgremban
 ms.service: azure-iot-hub
 ms.devlang: csharp
 ms.topic: include
-ms.date: 07/12/2024
+ms.date: 12/31/2024
 ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 ---
 
@@ -25,13 +25,26 @@ This section describes how to use device application code to:
 * Update reported device twin properties
 * Create a desired property update callback handler
 
-[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
-
-### Add device NuGet Package
+### Required device NuGet package
 
 Device client applications written in C# require the **Microsoft.Azure.Devices.Client** NuGet package.
 
-### Connect to a device
+Add this `using` statements to use the device library.
+
+```csharp
+using Microsoft.Azure.Devices.Client;
+```
+
+### Connect a device to IoT Hub
+
+A device app can authenticate with IoT Hub using the following methods:
+
+* Shared access key
+* X.509 certificate
+
+[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
+
+#### Authenticate using a shared access key
 
 The [DeviceClient](/dotnet/api/microsoft.azure.devices.client.deviceclient) class exposes all the methods required to interact with device twins from the device.
 
@@ -61,6 +74,10 @@ _deviceClient = DeviceClient.CreateFromConnectionString(DeviceConnectionString,
    TransportType.Mqtt);
 ```
 
+#### Authenticate using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-dotnet](iot-hub-howto-auth-device-cert-dotnet.md)]
+
 ### Retrieve a device twin and examine properties
 
 Call [GetTwinAsync](/dotnet/api/microsoft.azure.devices.client.deviceclient.gettwinasync?#microsoft-azure-devices-client-deviceclient-gettwinasync) to retrieve the current device twin properties. There are many [Twin](/dotnet/api/microsoft.azure.devices.shared.twin?) object [properties](/dotnet/api/microsoft.azure.devices.shared.twin?&#properties) that you can use to access specific areas of the `Twin` JSON data including `Properties`, `Status`, `Tags`, and `Version`.

includes/iot-hub-howto-device-twins-java.md

@@ -38,9 +38,18 @@ import com.microsoft.azure.sdk.iot.device.*;
 import com.microsoft.azure.sdk.iot.device.DeviceTwin.*;
 ```
 
-### Connect to the device
+### Connect a device to IoT Hub
 
-To connect to a device:
+A device app can authenticate with IoT Hub using the following methods:
+
+* Shared access key
+* X.509 certificate
+
+[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
+
+#### Authenticate using a shared access key
+
+To connect a device to IoT Hub:
 
 1. Use [IotHubClientProtocol](/java/api/com.microsoft.azure.sdk.iot.device.iothubclientprotocol) to choose a transport protocol. For example:
 
@@ -61,6 +70,10 @@ To connect to a device:
     client.open(true);
     ```
 
+#### Authenticate using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-java](iot-hub-howto-auth-device-cert-java.md)]
+
 ### Retrieve and view a device twin
 
 After opening the client connection, call [getTwin](/java/api/com.microsoft.azure.sdk.iot.service.devicetwin.devicetwin?#com-microsoft-azure-sdk-iot-service-devicetwin-devicetwin-gettwin(com-microsoft-azure-sdk-iot-service-devicetwin-devicetwindevice)) to retrieve the current twin properties into a `Twin` object.

includes/iot-hub-howto-device-twins-node.md

@@ -35,6 +35,21 @@ Run this command to install the **azure-iot-device** device SDK on your developm
 npm install azure-iot-device --save
 ```
 
+### Connect a device to IoT Hub
+
+A device app can authenticate with IoT Hub using the following methods:
+
+* X.509 certificate
+* Shared access key
+
+[!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
+
+#### Authenticate using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-node](iot-hub-howto-auth-device-cert-node.md)]
+
+#### Authenticate using a shared access key
+
 The [azure-iot-device](/javascript/api/azure-iot-device) package contains objects that interface with IoT devices. The [Twin](/javascript/api/azure-iot-device/twin) class includes twin-specific objects. This section describes `Client` class code that is used to read and write device twin data.
 
 ### Choose a transport protocol

includes/iot-hub-howto-device-twins-python.md

@@ -15,6 +15,20 @@ ms.custom: mqtt, devx-track-python, py-fresh-zinc
 
 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 twins.
 
+## Install packages
+
+The **azure-iot-device** library must be installed to create device applications.
+
+```cmd/sh
+pip install azure-iot-device
+```
+
+The **azure-iot-hub** library must be installed to create backend service applications.
+
+```cmd/sh
+pip install azure-iot-hub
+```
+
 ## Create a device application
 
 Device applications can read and write twin reported properties, and be notified of desired twin property changes that are set by a backend application or IoT Hub.
@@ -26,30 +40,45 @@ This section describes how to create device application code that:
 * Retrieves a device twin and examine reported properties
 * Patch reported device twin properties
 
+### Device import statement
+
+Add this code to import the `IoTHubDeviceClient` functions from the azure.iot.device SDK.
+
+```python
+from azure.iot.device import IoTHubDeviceClient
+```
+
+### Connect a device to IoT Hub
+
+A device app can authenticate with IoT Hub using the following methods:
+
+* Shared access key
+* X.509 certificate
+
 [!INCLUDE [iot-authentication-device-connection-string.md](iot-authentication-device-connection-string.md)]
 
-### Connect to a device
+#### Authenticate using a shared access key
 
-This section shows how to connect an application to a device using a device primary key that includes a shared access key.
+To connect a device to IoT Hub:
 
-To connect an application to a device:
-1. Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to add the device connection string
-1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client to an Azure IoT hub
+1. Call [create_from_connection_string](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-connection-string) to add the device primary connection string.
+1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client.
 
-```python
-# import the device client library
-import asyncio
-from azure.iot.device.aio import IoTHubDeviceClient
+For example:
 
-# substitute the device connection string in conn_str
-# and add it to the IoTHubDeviceClient object
-conn_str = "{IOT hub device connection string}"
-device_client = IoTHubDeviceClient.create_from_connection_string(conn_str)
+```python
+# Add your IoT hub primary connection string
+CONNECTION_STRING = "{Device primary connection string}"
+device_client = IoTHubDeviceClient.create_from_connection_string(CONNECTION_STRING)
 
-# connect the application to the device
-await device_client.connect()
+# Connect the client
+device_client.connect()
 ```
 
+#### Authenticate using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-python](iot-hub-howto-auth-device-cert-python.md)]
+
 ### Retrieve a device twin and examine reported properties
 
 You can retrieve and examine device twin information including tags and properties. The device twin information retrieved matches device twin JSON-formatted data that you can view for a device in the Azure portal.