---
title: "Dynatrace Integration Guide"
slug: "dynatrace-integration-guide"
updated: 2024-05-24T08:57:14Z
published: 2024-05-24T08:57:14Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safe.security/llms.txt
> Use this file to discover all available pages before exploring further.

# Dynatrace

## About this document

---

This document provides the step-by-step procedure to configure Dynatrace in SAFE.

## Introduction

---

SAFE integrates with Dynatrace, and fetches the security misconfiguration of the Dynatrace account in SAFE.

## Prerequisite

---

- Access required in **SAFE**:
  - SAFE Admin Access
- Access required in **Dynatrace**:
  - Dynatrace Admin Access
- Required User Inputs:
  - Account URN
  - Environment ID
  - Client ID
  - Client Secret
  - API Key
- Scope:
  - View users and groups
  - Read API Tokens
  - Read configuration

## Generate Connection Details

---

- How to get an Environment ID?
  - Log in to Dynatrace **Admin**.
  - Click on the **Profile** icon in the bottom left corner.
  - Click on **Account Management**

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/1(40).png)
  - Select the available account.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/2(37).png)
  - Click on the **Security** drop-down from the header and then click **Environments**.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/3(36).png)
  - Choose the Environment ID for which you want to perform the configuration assessment. **Copy** and **Save** this Environment ID to use it while configuring Dynatrace in SAFE.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/4(36).png)
- How to generate a **Client ID**and**Client Secret?**
  - Login to Dynatrace as **Admin**.
  - Click on the **Profile** icon in the bottom left corner.
  - Click on the **Account Management.**

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image-20240404-065843.png)
  - Select the available account.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image-20240404-070018.png)
  - Click the **Identity & Access Management** drop-down from the header and then click **0Auth Client**.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/5(36).png)
  - Click on the **Create Client** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/6(35).png)
  - Enter the admin user email and provide a description.
  - Select the **View users and groups (account-idm-read)** under permission.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/7(34).png)
  - Click on the **Create client** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/8(37).png)
  - The system displays the **Client ID**, **Client Secret**, and **Account URN**. **Copy** and **save** these details to use them while configuring Dynatrace in SAFE.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/15(7).png)
- How to generate **Access Token?**
  - Login to Dynatrace as **Admin.**
  - From the left navigation, click on the **Search** icon

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/16(6).png)
    - 
  - Search for **Access Token** and click it.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/17(3).png)
  - Click on the **Generate new token** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/18(2).png)
  - Enter a token name.
  - Set an expiration date.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/19(3).png)
  - Search and select the below scopes:
    - **Read API Tokens**
    - **Read configuration**
  - Click on the **Generate Token** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/20(3).png)
  - The system displays the API token. **Copy** and **save** the API token to use them while configuring Dynatrace in SAFE.
  - It's important to regularly update the API Token in SAFE according to its expiration date.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/9(35).png)

## **5. Configure Dynatrace in SAFE**

- Log in to your SAFE account a[s **Admin**.](http://Admin.Click)
- Click on the **Integrations**option from the left navigation.
- Scroll to find Dynatrace integration card or search for Dynatrace in the search bar.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image(22).png)
- Hover over the **GitLab** integration card and click on the **Configure** button.
- Enter the following details:
  - **Account URN**
  - **Environment ID**
  - **Client ID**
  - **Client Secret**
  - **API Key**
- Enter the **Auto Sync Frequency**.
- Click on the **Test Connection** button.
- Once the connection is successful, click on the **Save** button.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image(23).png)
- Once the configuration is saved successfully, click on the **Sync** **Now** button to trigger an on-demand sync.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image(24).png)
- Upon a successful sync, the system pulls the Dynatrace assets and their findings in SAFE. You can track the status of the sync in the **History** table.

## View Results

---

- Go to the **Integrations** homepage.
- Scroll to find the Dynatrace integration card or search for Dynatrace in the search bar.
- Click on the Dynatrace integration card for **Finding View** and **Asset View**.
  - **Finding View:** This tab displays all the findings details pulled from Dynatrace.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image(25).png)
  - **Asset View**: This tab displays all the assets pulled from Dynatrace.

![](https://cdn.document360.io/23dc20b8-a989-48c0-8653-f1d3e4abc734/Images/Documentation/image(27).png)

## History

---

Learn More about Integration History [here](https://docs.safe.security/safe-4/docs/integration-history).

## SAFE's Outgoing IP Addresses

---

Click [here](https://docs.safe.security/safe-4/docs/safes-outgoing-ip-addresses) to find the outgoing IP addresses of SAFE. All traffic to any integrations in SAFE will see one IP address as the source IP of the incoming connection.