• Home
  • Dynatrace API
  • Configuration
  • RUM
  • Web application configuration
  • Data privacy
  • GET data privacy of all web applications

Web application configuration API - GET data privacy of all web applications

Gets data privacy parameters of all web applications configured in your Dynatrace environment.

This API only supports web applications (including agentless applications and browser extensions). For mobile apps and custom applications, see Mobile and custom app API.

The request produces an application/json payload.

GETManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/config/v1/applications/web/dataPrivacy
SaaShttps://{your-environment-id}.live.dynatrace.com/api/config/v1/applications/web/dataPrivacy
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/applications/web/dataPrivacy

Authentication

To execute this request, you need an access token with ReadConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

The request doesn't provide any configurable parameters.

Response

Response codes

CodeTypeDescription
200ApplicationDataPrivacyList

Success

Response body objects

The ApplicationDataPrivacyList object

ElementTypeDescription
metadataConfigurationMetadata

Metadata useful for debugging

valuesApplicationDataPrivacy[]-

The ConfigurationMetadata object

Metadata useful for debugging

ElementTypeDescription
configurationVersionsinteger[]

A sorted list of the version numbers of the configuration.

currentConfigurationVersionsstring[]

A sorted list of version numbers of the configuration.

clusterVersionstring

Dynatrace version.

The ApplicationDataPrivacy object

Data privacy settings of the application.

ElementTypeDescription
metadataConfigurationMetadata

Metadata useful for debugging

identifierstring

Dynatrace entity ID of the web application.

dataCaptureOptInEnabledboolean

Set to true to disable data capture and cookies until JavaScriptAPI dtrum.enable() is called.

persistentCookieForUserTrackingboolean

Set to true to set persistent cookie in order to recognize returning devices.

doNotTrackBehaviourstring

How to handle the "Do Not Track" header:

  • IGNORE_DO_NOT_TRACK: ignore the header and capture the data.
  • CAPTURE_ANONYMIZED: capture the data but do not tie it to the user.
  • DO_NOT_CAPTURE: respect the header and do not capture.
The element can hold these values
  • CAPTURE_ANONYMIZED
  • DO_NOT_CAPTURE
  • IGNORE_DO_NOT_TRACK
sessionReplayDataPrivacySessionReplayDataPrivacySettings

Data privacy settings for Session Replay.

The SessionReplayDataPrivacySettings object

Data privacy settings for Session Replay.

ElementTypeDescription
optInModeEnabledboolean

If true, session recording is disabled until JavaScriptAPI dtrum.enableSessionReplay() is called.

urlExclusionRulesstring[]

A list of URLs to be excluded from recording.

contentMaskingSettingsSessionReplayContentMaskingSettings

Content masking settings for Session Replay.

For more details, see Configure Session Replay in Dynatrace Documentation.

The SessionReplayContentMaskingSettings object

Content masking settings for Session Replay.

For more details, see Configure Session Replay in Dynatrace Documentation.

ElementTypeDescription
recordingMaskingSettingsVersioninteger

The version of the content masking.

You can use this API only with the version 2.

If you're using version 1, set this field to 2 in the PUT request to switch to version 2.

recordingMaskingSettingsSessionReplayMaskingSetting

Configuration of the Session Replay masking.

playbackMaskingSettingsSessionReplayMaskingSetting

Configuration of the Session Replay masking.

The SessionReplayMaskingSetting object

Configuration of the Session Replay masking.

ElementTypeDescription
maskingPresetstring

The type of the masking:

  • MASK_ALL: Mask all texts, user input, and images.
  • MASK_USER_INPUT: Mask all data that is provided through user input
  • ALLOW_LIST: Only elements, specified in maskingRules are shown, everything else is masked.
  • BLOCK_LIST: Elements, specified in maskingRules are masked, everything else is shown.
The element can hold these values
  • ALLOW_LIST
  • BLOCK_LIST
  • MASK_ALL
  • MASK_USER_INPUT
maskingRulesMaskingRule[]

A list of masking rules.

The MaskingRule object

The masking rule defining how data is hidden.

ElementTypeDescription
maskingRuleTypestring

The type of the masking rule.

The element can hold these values
  • ATTRIBUTE
  • ELEMENT
selectorstring

The selector for the element or the attribute to be masked.

Specify a CSS expression for an element or a regular expression for an attribute.

userInteractionHiddenboolean

Interactions with the element are (true) or are not (`false) masked.

Response body JSON model

json
{
  "metadata": {
    "configurationVersions": [
      4,
      2
    ],
    "currentConfigurationVersions": [
      "1.0.4",
      "1.23"
    ],
    "clusterVersion": "1.192.1"
  },
  "values": [
    {
      "metadata": {},
      "identifier": "string",
      "dataCaptureOptInEnabled": true,
      "persistentCookieForUserTracking": true,
      "doNotTrackBehaviour": "CAPTURE_ANONYMIZED",
      "sessionReplayDataPrivacy": {
        "optInModeEnabled": true,
        "urlExclusionRules": [
          "string"
        ],
        "contentMaskingSettings": {
          "recordingMaskingSettingsVersion": 2,
          "recordingMaskingSettings": {
            "maskingPreset": "ALLOW_LIST",
            "maskingRules": [
              {
                "maskingRuleType": "ATTRIBUTE",
                "selector": "string",
                "userInteractionHidden": false
              }
            ]
          },
          "playbackMaskingSettings": {}
        }
      }
    }
  ]
}