Added cert auth include file

Author: gsteve88

includes/iot-hub-howto-auth-device-cert-python.md

@@ -0,0 +1,53 @@
+---
+title: How to connect a device to IoT Hub using a certificate (Python)
+titleSuffix: Azure IoT Hub
+description: Learn how to connect a device to IoT Hub using a certificate and the Azure IoT Hub SDK for Python.
+author: kgremban
+ms.author: kgremban
+ms.service: iot-hub
+ms.devlang: python
+ms.topic: include
+ms.manager: lizross
+ms.date: 12/06/2024
+---
+
+Use [create_from_x509_certificate](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-x509-certificate) to connect a device to IoT Hub using a X.509 certificate.
+
+This example shows certificate input parameter values as local variables for clarity. In a production system, store sensitive input parameters in environment variables or another more secure storage location. For example, use `os.getenv("HOSTNAME")` to read the host name environment variable.
+
+```python
+# The Azure IoT hub name
+hostname = "xxxxx.azure-devices.net"
+
+# The device that has been created on the portal using X509 CA signing or self-signing capabilities
+device_id = "MyDevice"
+
+# The X.509 certificate file name
+cert_file = "~/certificates/certs/sensor-thl-001-device.cert.pfx"
+key_file = "~/certificates/certs/sensor-thl-001-device.cert.key"
+# The certificate pass phrase is optional
+pass_phrase = "1234"
+
+x509 = X509(
+    cert_file,
+    key_file,
+    pass_phrase,
+)
+
+# The client object is used to interact with your Azure IoT hub.
+device_client = IoTHubDeviceClient.create_from_x509_certificate(
+    hostname=hostname, device_id=device_id, x509=x509
+)
+
+# Connect to IoT Hub
+await device_client.connect()
+```
+
+For more information about certificate authentication, see:
+
+* [Authenticate identities with X.509 certificates](/azure/iot-hub/authenticate-authorize-x509)
+* [Create and upload certificates for testing](/azure/iot-hub/tutorial-x509-test-certs)
+
+##### Code samples
+
+For working samples of device X.509 certificate authentication, see the examples whose file names end in X.509 at [Async hub scenarios](https://github.com/Azure/azure-iot-sdk-python/tree/main/samples/async-hub-scenarios).

includes/iot-hub-howto-file-upload-python.md

@@ -45,13 +45,24 @@ from azure.core.exceptions import AzureError
 from azure.storage.blob import BlobClient
 ```
 
-### Connect to the device
+### Connect a device to IoT Hub
 
-To connect to the device:
+A device app can authenticate and connect using the following methods:
 
-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.
+* X.509 certificate
+* Shared access key
 
-1. Call [connect](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-connect) to connect the device client.
+#### Connect using an X.509 certificate
+
+[!INCLUDE [iot-hub-howto-auth-device-cert-python](iot-hub-howto-auth-device-cert-python.md)]
+
+#### Connect using a shared access key
+
+To connect a device to 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
 
 For example: