DataDog
Use DataDog data with Cortex XSIAM.
The capabilities and sub-capabilities listed for this connector are available with any active Cortex XSIAM or Cortex Cloud Posture Security license.
This connector includes the following capabilities and sub-capabilities (if applicable):
Security Posture: Detect, monitor and alert on settings of your SaaS application.
saas-posture-config-remediation: Help remediate the misconfigured security settings of your SaaS application.
How to configure the DataDog connector
To access DataDog, Cortex XSIAM requires the following information, which you will specify during the connection process.
Account information for accessing your Datadog instance
Task 1: Collect Information for accessing Your Datadog Instance
To access your Datadog instance, Cortex XSIAM requires the following information, which you specify during the onboarding process.
Region
Datadog manages a number of independent sites in separate geographic areas around the world. Because these sites are separate from each other, you must specify which regional Datadog site you are using.
API Key
A generated character string that uniquely identifies your organization to the Datadog API. Cortex XSIAM requires this API key to authenticate to the Datadog API.
Application Key
A generated character string that the Datadog API uses to determine the access permissions of a calling application. The application key is associated with the administrator who generates the key.
As you complete the following steps, make note of the values of the items described in the preceding table. You will need to enter these values during onboarding to access your Datadog instance from Cortex XSIAM.
Identify the Datadog administrator account that will generate the API Key and Application Key.
Required Permissions: The administrator must have the Datadog Admin role with the following permissions:
Org Management
User App Keys
API Keys Read
API Keys Write
Identify your Datadog region.
Open a web browser and go to the Datadog login page that you use to access your Datadog instance.
Make a note of the regional Datadog site that your organization is using. Use the following table to determine your region based on the site URL. Do not continue to the next step unless you have recorded the region information. You must provide this information to Cortex XSIAM during the onboarding process.
Log in to the administrator account.
Generate an API key for your organization.
Click your Datadog account icon in the top-right corner and select Organization Settings.
On the Organization Settings page, select API Keys.
Click New Key.
In the New API Key dialog, enter a name for the key and click Create Key. Datadog generates and displays your new key.
Click Copy Key and paste the key into a text file. Do not continue to the next step unless you have copied the API Key. You must provide this key to Cortex XSIAM during the data connection process.
Generate an Application key to grant Cortex XSIAM access permissions. An application key inherits the permissions of the person who creates it, but you can further limit the application's access to certain authorization scopes. If you scope the application key, Cortex XSIAM will be unable to access some of your Datadog instance's settings — up to 19 settings may be inaccessible, preventing Cortex XSIAM from determining if those settings are misconfigured. To avoid restricting Cortex XSIAM's access, create an unscoped application key.
On the Organization Settings page, select Application Keys.
Click New Key.
In the New Key dialog, enter a name for the key and click Create Key. Datadog generates and displays your new key.
Click Copy Key and paste the key into a text file.
Task 2: Connect Datadog to Cortex XSIAM
In Cortex XSIAM, navigate to Settings → Data Sources & Integrations.
Click + Add new.
In the Add Data Sources or Integrations page, search for Datadog.
Under Recommended, hover over the new Datadog integration and click Add Instance to launch the configuration wizard.
Under the Capabilities tab, Enter a Name for your application.
Select Security Posture under Default Capabilities.
Click Next.
Under Connection, enter the API Key, Application Key, and Region for your Datadog instance.
Under Configuration tab, select a Sync Interval. Choose a meaningful Tag to distinguish between various applications in different environments.
A confirmation message indicates that Datadog is successfully connected. Confirm the Summary details and click Save instance.
Last updated
Was this helpful?
