V2 Signal Violations

Gets violations as a result of policy enforcement on signals. Signal rules and matched terms are decrypted by the agent.

Get violations as a result of policy enforcement on signals.

GETyouragentURL.symphony.com/agent/v1/dlp/violations/signal

Query parameters

Header parameters

Response

200204400401403500

OK

Body

application/json

violations*array of V1DLPViolationSignal (object)

A representation of list of violations due to signal creation/update sent by a user of Symphony

nextOffsetstring

Offset for the next chunk of violations to be submitted in the next request. Value is null if there are no further violations.

Request

JavaScriptCurl

const response = await fetch('youragentURL.symphony.com/agent/v1/dlp/violations/signal', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "violations": [
    {
      "violation": {
        "enforcementEventID": "text",
        "entityID": "text",
        "matchedPolicies": [
          {
            "id": "text",
            "version": "text",
            "policyName": "text",
            "type": "text",
            "terms": "text",
            "diagnostic": "text"
          }
        ],
        "action": "text",
        "outcome": {
          "type": "text"
        },
        "contentType": {
          "type": "text"
        },
        "version": "text",
        "ignoreDLPwarning": false
      },
      "signal": {
        "name": "text",
        "rules": "text",
        "diagnostic": "text"
      }
    }
  ],
  "nextOffset": "text"
}

🚧 Required Permissions

Calling this endpoint requires a ceservice account. For more information, see the Symphony Administration Guide.

See Bot Permissions for a list of roles and associated privileges.