Integrate Datadog with Zero Trust Network Access

In this topic, you will find general instructions on how to integrate Datadog with Portnox™ Zero Trust Network Access.

Create a Portnox Cloud application configuration

In this step, you will create a configuration in Portnox Cloud that will contain all the information necessary to integrate with Datadog.

  1. In a new tab of your browser, open your Portnox Cloud account by accessing the following URL: https://clear.portnox.com/

    From now on, we will call this tab the Portnox tab.

  2. In the Cloud portal top menu, click on the Zero Trust Resources option.

  3. On the Resources screen, click on the Create resource button.

    1. In the What type of resource is this? section, select the SSO web application option.
    2. In the Authentication protocol section, select the SAML option.
    3. Click on the Next button.

  4. Optional: If you have more than one SAML identity provider configured, select the identity provider in the Select an identity provider to use for this resource section.
  5. In the Resource details section, enter a Resource name and optionally a Description.

    In this example, we used the name Datadog for the new application configuration but you can use any name you like.

  6. Keep this browser tab open. You will need it later.

Open your Datadog SAML settings

In this section, you will access Datadog and find the SAML settings.

In another tab of your browser, open Datadog on the SAML settings page by accessing the following URL: https://app.datadoghq.com/organization-settings/login-methods/saml.
Note:
You can also open the main Datadog page, click on your name in the bottom-left corner, and select the Organization Settings option. Then, in the second menu, select the Login Methods option and click on the Configure button next to the SAML heading.

From now on, we will call this tab the Datadog tab.

Export metadata from the Portnox tab and upload it in the Datadog tab

In this section, you will export the metadata from Portnox Cloud into a file and upload that file in the Datadog custom SAML setup section.

  1. In the Portnox tab, in the SAML metadata section, click on the Download metadata XML file link to download the XML file and save it to your local drive.

  2. In the Datadog tab, in the Start by uploading your Identity Provider (IdP) metadata section, click on the Choose File button, and then select the XML file downloaded from Portnox Cloud. Then, click on the Upload and Enable button in the bottom-right corner.

Copy configuration values from the Datadog tab to the Portnox tab

In this section, you will copy the values displayed in your Datadog SAML setup section, and paste them in the relevant fields in Portnox Cloud.

  1. In the Datadog tab, select the text displayed next to the Service Provider Entity ID heading and copy the value to the clipboard.

  2. In the Portnox tab, in the Resource properties section, click on the empty field under the Entity ID / Service Provider Entity URL heading and paste the value copied from Datadog.

  3. In the Datadog tab, select the text displayed next to the Assertion Consumer Service URL heading and copy the value to the clipboard.

  4. In the Portnox tab, in the Resource properties section, click on the empty field under the Assertion Consumer Service (ACS) URL / Reply URL heading and paste the value copied from Datadog.

Finalize the configuration

In this section, you will finalize the configuration in Portnox Cloud and Datadog.

  1. Finalize the configuration in the Portnox tab.
    1. Optional: Click on the Next button, and in the Policy enforcement section, in the Device risk assessment section, change the setting to Override with custom policy and then select a risk assessment policy if you want to assess risk with this application using a custom risk assessment policy, and in the Access control section, change the setting to Override with custom policy and then select an access control policy if you want to control access to this application using a custom access control policy.
    2. Scroll all the way down to the end of the page, and then click on the Add resource button.

  2. Finalize the configuration in the Datadog tab.
    1. In the Login Methods pane, configure the login methods available to users.

      Note:
      We recommend to first test if the integration works correctly, and then turn off the Password and Google login methods. This will make Zero Trust Network Access the only login method for all Datadog users in the organization. Then, in the Users pane, you can override the method for one admin account to make it possible to log in to Datadog if something goes wrong.
  3. Check the configuration of your identity provider.
    Important:
    Datadog SAML implementation requires you to map the user’s email address to the eduPersonPrincipalName SAML attribute or the NameID attribute. This is configured in the identity provider. Check your identity provider configuration to make sure this mapping is configured.

Result: You have configured Datadog to be accessible using Portnox Zero Trust Network Access.