You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
IoT-For-Beginners/2-farm/lessons/6-keep-your-plant-secure/single-board-computer-x509.md

2.7 KiB

Use the X.509 certificate in your device code - Virtual IoT Hardware and Raspberry Pi

In this part of the lesson, you will connect your virtual IoT device or Raspberry Pi to your IoT Hub using the X.509 certificate.

Connect your device to IoT Hub

The next step is to connect your device to IoT Hub using the X.509 certificates.

Task - connect to IoT Hub

  1. Copy the key and certificate files to the folder containing your IoT device code. If you are using a Raspberry Pi through VS Code Remote SSH and created the keys on your PC or Mac, you can drag and drop the files into the explorer in VS Code to copy them.

  2. Open the app.py file

  3. To connect using an X.509 certificate, you will need the host name of the IoT Hub, and the X.509 certificate. Start by creating a variable containing the host name by adding the following code before the device client is created:

    host_name = "<host_name>"
    

    Replace <host_name> with your IoT Hub's host name. You can get this from the HostName section in the connection_string. It will be the name of your IoT Hub, ending with .azure-devices.net

  4. Below this, declare a variable with the device ID:

    device_id = "soil-moisture-sensor-x509"
    
  5. You will need an instance of the X509 class containing the X.509 files. Add X509 to the list of classes imported from the azure.iot.device module:

    from azure.iot.device import IoTHubDeviceClient, Message, MethodResponse, X509
    
  6. Create an X509 class instance using your certificate and key files by adding this code below the host_name declaration:

    x509 = X509("./soil-moisture-sensor-x509-cert.pem", "./soil-moisture-sensor-x509-key.pem")
    

    This will create the X509 class using the soil-moisture-sensor-x509-cert.pem and soil-moisture-sensor-x509-key.pem files created earlier.

  7. Replace the line of code that creates the device_client from a connection string, with the following:

    device_client = IoTHubDeviceClient.create_from_x509_certificate(x509, host_name, device_id)
    

    This will connect using the X.509 certificate instead of a connection string.

  8. Delete the line with connection_string variable.

  9. Run your code. Monitor the messages sent to IoT Hub, and send direct method requests as before. You will see the device connecting and sending soil moisture readings, as well as receiving direct method requests.

💁 You can find this code in the code/pi or code/virtual-device folder.

😀 Your soil moisture sensor program is connected to your IoT Hub using an X.509 certificate!