Skip to content
/
Replace the malicious bro...

Replace the malicious browser extension detection configuration

Request

Replaces your organization's malicious browser extension detection configuration with the configuration you send. Any rule you don't include is deleted, and globals.excludedExtensions replaces your entire excluded-extension list — send the complete set you want to keep, or an empty array to clear it.

A rule with an id updates the existing rule with that id. A rule without an id is created. Rules are evaluated in the order you send them, and the first rule that matches wins.

To change part of the configuration, retrieve it first, apply your changes, and send the complete configuration back.

Security
x-api-key
Bodyapplication/jsonrequired

The complete configuration to save.

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.

PUT
/v1/controls/maliciousBrowserExtensionDetection/configuration
curl -i -X PUT \
  https://api.pushsecurity.com/v1/controls/maliciousBrowserExtensionDetection/configuration \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "globals": {
      "excludedExtensions": []
    },
    "rules": []
  }'

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