Skip to content

Malicious browser extension detection

Manage the rules and excluded extensions that detect malicious browser extensions across your organization.

Operations

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": [ … ]
        }
      }
    }
  ]
}