Edits

gsteve88 · gsteve88 · commit db16b91385d9 · 2024-12-12T15:16:00.000-08:00
diff --git a/includes/iot-hub-howto-auth-device-cert-dotnet.md b/includes/iot-hub-howto-auth-device-cert-dotnet.md
@@ -14,13 +14,11 @@ ms.custom: mqtt, devx-track-csharp, devx-track-dotnet
 
 To connect a device to IoT Hub using an X.509 certificate:
 
-1. Use [DeviceAuthenticationWithX509Certificate](/dotnet/api/microsoft.azure.devices.client.deviceauthenticationwithx509certificate) to create an object that contains device and certificate information that is passed as the second parameter to `DeviceClient.Create` (step 2).
+1. Use [DeviceAuthenticationWithX509Certificate](/dotnet/api/microsoft.azure.devices.client.deviceauthenticationwithx509certificate) to create an object that contains device and certificate information. `DeviceAuthenticationWithX509Certificate` is passed as the second parameter to `DeviceClient.Create` (step 2).
 
-1. Use [DeviceClient.Create](/dotnet/api/microsoft.azure.devices.client.deviceclient.create?#microsoft-azure-devices-client-deviceclient-create(system-string-microsoft-azure-devices-client-iauthenticationmethod)) to connect the device to IoT Hub using an X.509 certificate.
+1. Use [DeviceClient.Create](/dotnet/api/microsoft.azure.devices.client.deviceclient.create?view=azure-dotnet&branch=main#microsoft-azure-devices-client-deviceclient-create(system-string-microsoft-azure-devices-client-iauthenticationmethod-microsoft-azure-devices-client-transporttype)) to connect the device to IoT Hub using an 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 `Environment.GetEnvironmentVariable("HOSTNAME")` to read the host name environment variable.
-
-In this example, the device and certificate information populated `auth` `DeviceAuthenticationWithX509Certificate` object is passed as to `DeviceClient.Create`. An example of `DeviceAuthenticationWithX509Certificate` information population is omitted because of the flexible nature of how the certificate information can be added.
+In this example, the device and certificate information has been populated in the `auth` `DeviceAuthenticationWithX509Certificate` object that is passed to `DeviceClient.Create`. An example of `DeviceAuthenticationWithX509Certificate` information population is omitted because of the flexible nature of how the certificate information can be added.
 
 ```csharp
 HostName = "xxxxx.azure-devices.net";
@@ -33,10 +31,11 @@ using var deviceClient = DeviceClient.Create(
 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)
+* [Tutorial: Create and upload certificates for testing](/azure/iot-hub/tutorial-x509-test-certs)
 * [X509Certificate2Collection](/dotnet/api/system.security.cryptography.x509certificates.x509certificate2collection)
 * [X509Certificate2](/dotnet/api/system.security.cryptography.x509certificates.x509certificate2)
-* [Tutorial: Provision multiple X.509 devices using enrollment groups](/azure/iot-dps/tutorial-custom-hsm-enrollment-group-x509?pivots=programming-language-java)
+* [Tutorial: Provision multiple X.509 devices using enrollment groups](/azure/iot-dps/tutorial-custom-hsm-enrollment-group-x509?pivots=programming-language-csharp)
+* [OpenSSL CA](https://openssl-ca.readthedocs.io/)
 
 ##### Code samples
 
diff --git a/includes/iot-hub-howto-auth-device-cert-java.md b/includes/iot-hub-howto-auth-device-cert-java.md
@@ -13,7 +13,7 @@ ms.date: 12/12/2024
 
 To connect a device to IoT Hub using an X.509 certificate:
 
-1. Build the [SSLContext](https://docs.oracle.com/javase/8/docs/api/javax/net/ssl/SSLContext.html) object using [buildSSLContext](https://hc.apache.org/httpcomponents-core-4.4.x/current/httpcore/apidocs/org/apache/http/ssl/SSLContextBuilder.html)
+1. Build the [SSLContext](https://docs.oracle.com/javase/8/docs/api/javax/net/ssl/SSLContext.html) object using [buildSSLContext](https://hc.apache.org/httpcomponents-core-4.4.x/current/httpcore/apidocs/org/apache/http/ssl/SSLContextBuilder.html).
 1. Add the `SSLContext` information to a [ClientOptions](/java/api/com.microsoft.azure.sdk.iot.device.clientoptions) object.
 1. Call [DeviceClient](/java/api/com.microsoft.azure.sdk.iot.device.deviceclient?#com-microsoft-azure-sdk-iot-device-deviceclient-deviceclient(java-lang-string-com-microsoft-azure-sdk-iot-device-iothubclientprotocol-com-microsoft-azure-sdk-iot-device-clientoptions)) using the `ClientOptions` information to create the device-to-IoT Hub connection.
 
@@ -41,7 +41,9 @@ DeviceClient client = new DeviceClient(connString, protocol, clientOptions);
 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)
+* [Tutorial: Create and upload certificates for testing](/azure/iot-hub/tutorial-x509-test-certs)
+* [Tutorial: Provision multiple X.509 devices using enrollment groups](/azure/iot-dps/tutorial-custom-hsm-enrollment-group-x509?pivots=programming-language-java)
+* [OpenSSL CA](https://openssl-ca.readthedocs.io/)
 
 ##### Code samples
 
diff --git a/includes/iot-hub-howto-auth-device-cert-node.md b/includes/iot-hub-howto-auth-device-cert-node.md
@@ -41,7 +41,9 @@ 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)
+* [Tutorial: Provision multiple X.509 devices using enrollment groups](/azure/iot-dps/tutorial-custom-hsm-enrollment-group-x509?pivots=programming-language-nodejs)
+* [OpenSSL CA](https://openssl-ca.readthedocs.io/)
 
 ##### Code samples
 
-For a working sample of device X.509 certificate authentication, see  [Simple sample device X.509](https://github.com/Azure/azure-iot-sdk-node/blob/main/device/samples/javascript/simple_sample_device_x509.js).
+For a working sample of device X.509 certificate authentication, see [Simple sample device X.509](https://github.com/Azure/azure-iot-sdk-node/blob/main/device/samples/javascript/simple_sample_device_x509.js).
diff --git a/includes/iot-hub-howto-auth-device-cert-python.md b/includes/iot-hub-howto-auth-device-cert-python.md
@@ -11,7 +11,7 @@ ms.manager: lizross
 ms.date: 12/06/2024
 ---
 
-To connect a device to IoT Hub:
+To connect a device to IoT Hub using an X.509 certificate:
 
 1. Use [create_from_x509_certificate](/python/api/azure-iot-device/azure.iot.device.iothubdeviceclient?#azure-iot-device-iothubdeviceclient-create-from-x509-certificate) to add the X.509 certificate parameters
 
@@ -50,8 +50,10 @@ 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)
+* [Tutorial: Create and upload certificates for testing](/azure/iot-hub/tutorial-x509-test-certs)
+* [Tutorial: Provision multiple X.509 devices using enrollment groups](/azure/iot-dps/tutorial-custom-hsm-enrollment-group-x509?pivots=programming-language-python)
+* [OpenSSL CA](https://openssl-ca.readthedocs.io/)
 
 ##### 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).
+For working samples of device X.509 certificate authentication, see the examples whose file names end in x509 at [Async hub scenarios](https://github.com/Azure/azure-iot-sdk-python/tree/main/samples/async-hub-scenarios).
