Get Audit trails

The endpoint returns a paginated list of audits of the pod depending on input parameters such as the categories of audits, time interval etc. Each page can contain up to 100 audits.

Get Audit Trail Events

get

This operation returns paginated list of audit trail events. You can narrow down search results by specifying categories, action, originating userId, attribute, groupId, authorization role, streamId, affected userId, temporary authId, disclaimerId or policyId parameter. Pages can contain up to 100 records. This operation returns only audits for the categories the requester is entitled to.

Query parameters

startDatestringOptional

start range date restriction. Date must be formatted the following way: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

endDatestringOptional

end range date restriction. Date must be formatted the following way: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'

categoriesstringRequired

List of Audit Trail categories restriction

Example: login,malwarescan

affectedUserIdstringOptional

"Affected User Id" filter single value restriction

originatingUserIdstringOptional

"Originating User Id" filter single value restriction (a.k.a. "Performed by)"

actionIdstringOptional

"Action Id" filter single value restriction

attributestringOptional

"Attribute" filter single value restriction

groupIdstringOptional

"Group Id" filter single value restriction (used by Info barrier, Role Scope...)

authorizationRolestringOptional

"Authorization Role" filter single value restriction

streamIdstringOptional

"Stream Id" filter single value restriction (using either Base64 or Base64URL encoding)

policyIdstringOptional

"Policy Id" filter single value restriction

applicationIdstringOptional

"Application Id" filter single value restriction

tempAuthIdstringOptional

"Temporary Authorization Id" filter single value restriction

disclaimerIdstringOptional

"Disclaimer Id" filter single value restriction

dateFormatstringOptional

Used format for output date values. Possible values: STANDARD_AT_ACP_DATE - MM-dd-YYYY - as historically used in Symphony Audit Trails or anything supported by java11 DateTimeFormatter (https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/format/DateTimeFormatter.html) BASIC_ISO_DATE ISO_DATE ISO_DATE_TIME ISO_INSTANT ISO_LOCAL_DATE ISO_LOCAL_DATE_TIME ISO_LOCAL_TIME ISO_OFFSET_DATE ISO_OFFSET_DATE_TIME ISO_OFFSET_TIME ISO_ORDINAL_DATE ISO_TIME ISO_WEEK_DATE ISO_ZONED_DATE_TIME RFC_1123_DATE_TIME any supported date/time pattern - YYYYMMddHHmmss, ....

Default: STANDARD_AT_ACP_DATE

limitinteger · int32 · min: 1 · max: 100Optional

Specifies the maximum number of objects to return. It is possible that fewer than the specified number is returned, either due to reaching the end of the record set or due to data access rules that filter results of the back end query. The number of returned objects should not be used to determine if there are more objects to retrieve. Instead, the presence of the "next" and "previous" (see below) fields should be used.

Default: 100

beforestringOptional

Cursor value that specifies that the returned page of data should consist of records that come before this cursor value (essentially the "previous" page).

afterstringOptional

Cursor value that specifies that the returned page of data should consist of records that come after this cursor value (essentially the "next" page).

Responses

200

Success

application/jsontext/csv

400

Bad request

application/json

401

Unauthorized. Returned if JWT token verification failed.

application/json

403

Forbidden. Returned if the caller doesn't have the required entitlements to call an endpoint.

application/json

404

Not found. Returned if specified key is not found.

application/json

get

HTTPcURLJavaScriptPython

GET /at2/v1/audits?categories=login%2Cmalwarescan HTTP/1.1
Host: youraudittrailURL.symphony.com
Accept: */*

{
  "pagination": {
    "next": "next",
    "cursors": {
      "before": "before",
      "after": "after"
    },
    "previous": "previous"
  },
  "data": [
    {
      "createdDate": "2000-01-23T04:56:07.000+00:00",
      "details": [
        {
          "complexValue": [
            {
              "value": "value",
              "key": "key"
            },
            {
              "value": "value",
              "key": "key"
            }
          ],
          "value": "value",
          "key": "key"
        },
        {
          "complexValue": [
            {
              "value": "value",
              "key": "key"
            },
            {
              "value": "value",
              "key": "key"
            }
          ],
          "value": "value",
          "key": "key"
        }
      ],
      "id": "id",
      "category": "category"
    },
    {
      "createdDate": "2000-01-23T04:56:07.000+00:00",
      "details": [
        {
          "complexValue": [
            {
              "value": "value",
              "key": "key"
            },
            {
              "value": "value",
              "key": "key"
            }
          ],
          "value": "value",
          "key": "key"
        },
        {
          "complexValue": [
            {
              "value": "value",
              "key": "key"
            },
            {
              "value": "value",
              "key": "key"
            }
          ],
          "value": "value",
          "key": "key"
        }
      ],
      "id": "id",
      "category": "category"
    }
  ],
  "warnings": [
    {
      "code": "code",
      "message": "message"
    },
    {
      "code": "code",
      "message": "message"
    }
  ]
}