Skip to main content

Dynatrace

Outline

Introduction

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

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

    • Select the available account.

    • Click on the Security drop-down from the header and then click Environments.

    • 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.


  • 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.

    • Select the available account.

    • Click the Identity & Access Management drop-down from the header and then click OAuth Client.

    • Click on the Create Client button.

    • Enter the admin user email and provide a description.

    • Select the View users and groups (account-idm-read) under permission.

    • Click on the Create client button.

    • The system displays the Client ID, Client Secret, and Account URN. Copy and save these details to use them while configuring Dynatrace in SAFE.


  • How to generate Access Token?

    • Login to Dynatrace as Admin.

    • From the left navigation, click on the Search icon

    • Search for Access Token and click it.

    • Click on the Generate new token button.

    • Enter a token name.

    • Set an expiration date.

    • Search and select the below scopes:

      • Read API Tokens

      • Read configuration



    • Click on the Generate Token button.


    • 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.

Configure Dynatrace in SAFE

  • Log in to your SAFE account as Admin.

  • Click on the Integrations option from the left navigation.

  • Scroll to find Dynatrace integration card or search for Dynatrace in the search bar.

  • Hover over the Dynatrace 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.


  • Once the configuration is saved successfully, click on the Sync Now button to trigger an on-demand sync.

  • 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.

    • Asset View: This tab displays all the assets pulled from Dynatrace.

To check sync status and errors for this integration, see Integration History.

Did this article help?

Let us know by leaving a star rating at the top of this article.