Allowed beacon domains API - GET configuration

Gets the configuration of the allowed beacon origins for Cross Origin Resource Sharing (CORS) requests.

The request produces an application/json payload.

GET	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/allowedBeaconOriginsForCors`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/allowedBeaconOriginsForCors`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/allowedBeaconOriginsForCors`

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

Code	Type	Description
200	AllowedBeaconOrigins	Success

Response body objects

The `AllowedBeaconOrigins` object

Configuration of the allowed beacon origins for CORS requests.

Element Type Description

metadata

Element	Type	Description
metadata	ConfigurationMetadata	Metadata useful for debugging
allowedBeaconOrigins	BeaconDomainPattern[]	A list of allowed beacon origins for CORS requests.
rejectBeaconsWithoutOriginHeader	boolean	Discard (`true`) or keep (`false`) beacons without the Origin HTTP header on the BeaconForwarder. If not set, `false` is used.

ConfigurationMetadata

Metadata useful for debugging

allowedBeaconOrigins

BeaconDomainPattern[]

A list of allowed beacon origins for CORS requests.

rejectBeaconsWithoutOriginHeader

boolean

Discard (true) or keep (false) beacons without the Origin HTTP header on the BeaconForwarder.

If not set, false is used.

The `ConfigurationMetadata` object

Metadata useful for debugging

Element	Type	Description
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.
clusterVersion	string	Dynatrace version.

The `BeaconDomainPattern` object

Allowed beacon origin for CORS requests.

Element	Type	Description
domainNameMatcher	string	The matching operation for the domainNamePattern. The element can hold these values `CONTAINS` `ENDS_WITH` `EQUALS` `STARTS_WITH`
domainNamePattern	string	The pattern of the allowed domain name.

Response body JSON model

json
{
  "metadata": {
    "configurationVersions": [
      4,
      2
    ],
    "clusterVersion": "Mock version"
  },
  "allowedBeaconOrigins": [
    {
      "domainNameMatcher": "EQUALS",
      "domainNamePattern": "dynatrace.com"
    }
  ]
}