• Home
  • Dynatrace API
  • Environment
  • Application Security
  • Davis security advisor

Davis security advisor API

The Davis Security Advisor API lists Davis recommendations related to open and unmuted security problems.

You can limit the output by using the pagination:

  1. Specify the number of results per page in the pageSize query parameter.
  2. Then use the cursor from the nextPageKey field of the previous response in the nextPageKey query parameter to obtain subsequent pages.

The request produces an application/json payload.

GETManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/v2/davis/securityAdvices
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/davis/securityAdvices
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/davis/securityAdvices

Authentication

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

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

Parameters

ParameterTypeDescriptionInRequired
managementZoneFilterstring

To specify management zones, use one of the options listed below. For each option you can specify multiple comma-separated values. If several values are specified, the OR logic applies. All values are case-sensitive and must be quoted.

  • Management zone ID: ids("mzId-1", "mzId-2").
  • Management zone names: names("mz-1", "mz-2").

You can specify several comma-separated criteria (for example, names("myMz"),ids("9130632296508575249")).

queryoptional
nextPageKeystring

The cursor for the next page of results. You can find it in the nextPageKey field of the previous response.

The first page is always returned if you don't specify the nextPageKey query parameter.

When the nextPageKey is set to obtain subsequent pages, you must omit all other query parameters.

queryoptional
pageSizeinteger

The amount of security advices in a single response payload.

The maximal allowed page size is 500.

If not set, 5 is used.

queryoptional

Response

Response codes

CodeTypeDescription
200DavisSecurityAdviceList

Success

Response body objects

The DavisSecurityAdviceList object

A list of advice from the Davis security advisor.

ElementTypeDescription
totalCountinteger

The total number of entries in the result.

pageSizeinteger

The number of entries per page.

nextPageKeystring

The cursor for the next page of results. Has the value of null on the last page.

Use it in the nextPageKey query parameter to obtain subsequent pages of the result.

advicesDavisSecurityAdvice[]-

The DavisSecurityAdvice object

Security advice from the Davis security advisor.

ElementTypeDescription
namestring

The name of the advice.

vulnerableComponentstring

The vulnerable component to which advice applies.

technologystring

The technology of the vulnerable component.

The element can hold these values
  • DOTNET
  • GO
  • JAVA
  • KUBERNETES
  • NODE_JS
  • PHP
adviceTypestring

The type of the advice.

The element can hold these values
  • UPGRADE
criticalstring[]

IDs of critical level security problems caused by vulnerable component.

highstring[]

IDs of high level security problems caused by vulnerable component.

mediumstring[]

IDs of medium level security problems caused by vulnerable component.

lowstring[]

IDs of low level security problems caused by vulnerable component.

nonestring[]

IDs of none level security problems caused by vulnerable component.

Response body JSON model

json
{ "totalCount": 1, "pageSize": 1, "nextPageKey": "AQAAABQBAAAABQ==", "advices": [ { "name": "string", "vulnerableComponent": "string", "technology": "DOTNET", "adviceType": "UPGRADE", "critical": [ "string" ], "high": [ "string" ], "medium": [ "string" ], "low": [ "string" ], "none": [ "string" ] } ] }
Related topics
  • Application Security

    Detect, monitor, remediate vulnerabilities at runtime, and block attacks on your applications.

  • Security problems API

    Find out what the Dynatrace Security problems API offers.