Skip to main content

Part 6: Create a cloud platform policy

Objectives

  • Onboard your device with Azure Event Grid MQTT Broker.

  • Securely connect your device with certificate-based MQTT client authentication.

  • Automatically provision your device through the DigiCert® Device Trust Manager's cloud platform policy feature.

Before you begin

You must have an active Microsoft Azure subscription with permissions to create and manage Event Grid namespaces and resources.

Microsoft Azure Event Grid MQTT Broker:

  • Create an MQTT Broker namespace:

    For creating an MQTT Broker namespace, see Create, view, and manage namespaces on the Azure Event Grid documentation page.

  • Enable certificate-based MQTT authentication:

    For configuring Microsoft Azure to authenticate MQTT clients using X.509 certificates, see the MQTT client authentication using certificates on the Azure Event Grid documentation page.

  • Establish TLS Trust with Azure Event Grid:

    To ensure a secure TLS connection between the device and the Azure Event Grid, the device must trust the Event Grid endpoint’s server certificate.

    • Retrieve the TLS certificate chain from the Event Grid endpoint using the following command:

      openssl s_client -connect <eventgrid-endpoint>:443 -showcerts
    • Install the root and intermediate CA certificates on the device at the following location:

      /etc/digicert/keystore/ca
  • Configure and keep the following details from your Azure account:

  • Collect and keep the following configuration details from your Azure account:

    • Azure subscription ID

    • Event Grid namespace

    • Client ID

Device Trust Manager

Step 1: Create a cloud platform policy

To create a cloud platform policy:

  1. Sign in to DigiCert® ONE as a Solution Administrator.

  2. In DigiCert ONE, in the Manager menu (grid at top right), select Device Trust.

  3. In the Device Trust Manager menu, select Cloud platform policies.

  4. Click Create cloud platform policy.

  5. Specify a Cloud platform Policy name.

  6. Select an Issuing CA from the dropdown list.

  7. Download the Issuing CA certificate.

  8. Register the Issuing CA certificate with Azure Event Grid Services.

    To register, follow the instructions mentioned in MQTT client authentication using certificates.

  9. Select the Set up certificate issuance checkbox.

  10. Click Next to add an MQTT broker.

Step 2: Add a Microsoft Azure Event Grid MQTT Broker

Next, add a Microsoft Azure Event Grid MQTT broker:

  1. Navigate to the Add MQTT broker tab.

  2. Click Add MQTT broker.

  3. Follow the on-screen instructions and provide the required configuration details from your Azure account for use in Device Trust Manager.

  4. Click Platform Onboarding Test once you provide all the required configuration details from your Azure account to verify if the configuration parameters provided by you are correct to add a cloud platform policy.

  5. Click Add broker to add an MQTT broker.

Step 3: Configure the cloud platform policy

To configure a cloud platform policy:

  1. Navigate to the Configure cloud platform policy tab.

  2. Optional (assign the cloud platform policy to a division).

  3. Click Add assignment to select the certificate management policy that will issue X.509 certificates for device authentication with the MQTT broker.

  4. From the Device Group dropdown menu, select a device group.

    • The devices you select in this group will have their device identity created in the MQTT broker, and will be assigned an MQTT endpoint to connect.

    • Based on the device group you select, the operational management policy certificate associated with it is automatically displayed in the Operational Certificate Management Policy dropdown menu.

  5. Click Create cloud platform policy.

    Upon successful creation of the cloud platform policy, the policy appears under the Completed policies list.