Retrieves a list of all system misconfigurations detected in the network

This API lists system misconfigurations across the network, with filters for name, description, severity, post-deployment issues, and ID to enable precise data retrieval

Endpoints

get /dcapi/threats/systemmisconfigurations

Copy full URL

Request URL

https://{server-hostname}:8383/dcapi/threats/systemmisconfigurations

Scope

VulnerabilityMgmt.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Sample Request

Curl

Java

Python

Deluge

PowerShell

Copied!

curl --request GET \
  --url https://appdomain/dcapi/threats/systemmisconfigurations \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomain/dcapi/threats/systemmisconfigurations"))
        .header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("appdomain")

headers = { 'Authorization': " d92d4xxxxxxxxxxxxx15f52" }

conn.request("GET", "/dcapi/threats/systemmisconfigurations", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))


    headersMap = Map();
    headersMap.put("Accept", "application/json");

    response = invokeUrl
    [
        url: "https://appDomain/dcapi/threats/systemmisconfigurations"
        type: GET
        headers: headersMap
        connection: connection_name
    ]

    info response;

$headers=@{}
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/threats/systemmisconfigurations' -Method GET -Headers $headers

▼ Show full

Response Parameters

- HTTP code 200

Response Body - application/json

JSON object

Hide Sub-Attributes

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Copied!

  {
    "metadata": {
      "pageLimit": 30,
      "totalRecords": "2",
      "totalPages": 1,
      "links": {
        "next": null,
        "prev": null
      },
      "page": 1
    },
    "response_code": 200,
    "message_type": "systemmisconfigurations",
    "message_response": {
      "systemmisconfigurations": [
        {
          "severity": "Critical",
          "os_platform": "Windows",
          "fix_availability": "not available",
          "description": "A host-based firewall lets a user define a set of rules that controls incoming and outgoing network traffic across a particular device. This prevents unauthorized access and unrestricted connections to the device. Windows-based computers comes with an in-built firewall. Resolve this misconfiguration to enable Microsoft windows firewall in your windows-based computers.",
          "affected_systems": 1,
          "misconfig_name": "Windows firewall disabled/ No third-party firewall present",
          "solution": "no fix available",
          "reboot_required": "not required",
          "post_deployment_issues": "No Impact",
          "undo_supported": false,
          "category": "Windows Firewall",
          "misconfigid": "4",
          "potential_impact": false
        },
        {
          "severity": "Critical",
          "os_platform": "Windows",
          "fix_availability": "not available",
          "description": "BitLocker is a full disk encryption feature included in Microsoft Windows versions starting with Windows Vista. It is designed to protect data by providing encryption for entire volumes. In many cases, encryption of customer data is required by law. Resolution: It is advisable to enable bitlocker encryption to protect entire disk volumes.",
          "affected_systems": 1,
          "misconfig_name": "Bitlocker not enabled",
          "solution": "no fix available",
          "reboot_required": "not required",
          "post_deployment_issues": "No Impact",
          "undo_supported": false,
          "category": "BitLocker Encryption",
          "misconfigid": "6",
          "potential_impact": false
        }
      ]
    },
    "status": "success"
  }

▼ Show full

Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.