Skip to content
/
Replace the malicious cop...

Replace the malicious copy paste detection configuration

Request

Replaces your organization's malicious copy paste detection configuration with the configuration you send. Any rule you don't include is deleted.

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 set of rules to save.

globalsobject(Malicious Copy Paste Detection Globals)required

Control-wide settings that apply across every rule.

rulesArray of objects(Malicious Copy Paste Detection Rule)required

Complete list of Malicious Copy Paste Detection rules.

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

Responses

OK

Bodyapplication/json
globalsobject(Malicious Copy Paste Detection Globals)required

Control-wide settings that apply across every rule.

rulesArray of objects(Malicious Copy Paste Detection Rule)required

Complete list of Malicious Copy Paste Detection rules.

Response
{
  "globals": {
    "ignoredHosts": [
      "*.internal.example.com",
      "build-server",
      "10.0.1.1"
    ]
  },
  "rules": [
    {
      "id": "c478966c-f927-411c-b919-179832d3d50c",
      "name": "Block malicious paste for Finance",
      "enabled": true,
      "mode": "BLOCK",
      "title": "Paste blocked",
      "subtext": "This paste looks malicious and has been blocked.",
      "buttonText": "Proceed anyway",
      "safeText": "This paste is safe to use.",
      "payloadCollection": true,
      "osTarget": "WINDOWS",
      "criteria": {
        "employeeIds": {
          "matches": [ … ]
        },
        "employeeGroups": {
          "matches": [ … ]
        }
      }
    }
  ]
}