Skip to content

Browser extension blocking

Manage the rules that allow or block browser extensions across your organization.

Operations

Retrieve the browser extension blocking configuration

Request

Returns your organization's current browser extension blocking configuration, including 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/browserExtensionBlocking/configuration
curl -i -X GET \
  https://api.pushsecurity.com/v1/controls/browserExtensionBlocking/configuration \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
rulesArray of objects(Browser Extension Blocking Rule)required

Complete list of Browser Extension Blocking rules.

globalsobject

Reserved for control-wide settings. Empty for this control.

Example:
{}
Response
{
  "globals": {},
  "rules": [
    {
      "id": "c478966c-f927-411c-b919-179832d3d50c",
      "name": "Block risky extensions for Finance",
      "enabled": true,
      "mode": "BLOCK",
      "title": "Extension blocked",
      "subtext": "This extension is not permitted on company devices.",
      "criteria": {
        "employeeIds": {
          "matches": [ … ]
        },
        "employeeGroups": {
          "matches": [ … ]
        },
        "browserExtensionProfile": {
          "matches": [ … ]
        },
        "browserExtensions": {
          "matches": [ … ]
        },
        "browserExtensionPermissions": {
          "matches": [ … ]
        },
        "browserExtensionDeploymentType": {
          "matches": [ … ]
        }
      }
    }
  ]
}