Skip to content
/
Retrieve the malicious br...

Retrieve the malicious browser extension detection configuration

Request

Returns your organization's current malicious browser extension detection configuration, including the control-wide globals and every rule and its settings. Rules are returned in the order they're evaluated, with the highest-priority rule first.

Security
x-api-key
GET
/v1/controls/maliciousBrowserExtensionDetection/configuration
curl -i -X GET \
  https://api.pushsecurity.com/v1/controls/maliciousBrowserExtensionDetection/configuration \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
globalsobject(Malicious Browser Extension Detection Globals)required

Control-wide settings that apply across every rule.

rulesArray of objects(Malicious Browser Extension Detection Rule)required

Complete list of Malicious Browser Extension Detection rules.

Response
{
  "globals": {
    "excludedExtensions": [
      {
        "extensionId": "abcdefghijklmnopabcdefghijklmnop",
        "notes": "Approved by IT for the Finance team."
      }
    ]
  },
  "rules": [
    {
      "id": "c478966c-f927-411c-b919-179832d3d50c",
      "name": "Block high-severity extensions for Finance",
      "enabled": true,
      "mode": "BLOCK",
      "title": "Extension blocked",
      "subtext": "This extension is not permitted on company devices.",
      "profileScope": "COMPANY_DOMAIN",
      "criteria": {
        "employeeIds": {
          "matches": [ … ]
        },
        "employeeGroups": {
          "matches": [ … ]
        },
        "browserExtensionSeverities": {
          "matches": [ … ]
        }
      }
    }
  ]
}