Get trusted traffic data

Get trusted traffic data related to a firewall name.

Use the device-setup-controller API GET /devices method to return the firewall name.

Resource Name: /api/v1/trustedTraffic/firewalls/{firewallName}

Request Method: GET

Request Parameters:

Element

Type

Description
firewallName Mandatory

String

Firewall name. Use the device-setup-controller API GET /devices method to return the firewall name or use ALL_FIREWALLS.

pageSize

Optional

Integer

The number of rows to display per page in the output JSON file. Default is 10.

Tip: By default, rules with zero hits are not shown in the results, although the user is notified that these rules exist.

To include rules with zero hit counts in the response, increase the pageSize parameter in the API enough to fit all the rules onto a single page.

pageNo

Optional

Integer

The page to display in the output JSON file. Default is 0.

Response:

Code

Description
200

Operation completed successfully

401

Unauthorized

Request cURL examples 

Get-curl -X GET "https://[machine IP]/afa/api/v1/trustedTraffic/firewalls/ALL_FIREWALLS?pageNo=0&pageSize=10" -H "accept: */*"

Response example in JSON Format 

{
  "content": [
    {
      "source": "a_10.20.7.235",
      "destination": "10.20.2.148",
      "expirationDate": 1599253200000,
      "service": "lpdw0rm",
      "trusted_traffic_id": 908,
      "display_traffic_level": "All firewalls",
      "trust_future_host_group_changes": false,
      "compatible_trusted_traffic_id": "N6lQJUpeynZEw"
    },
    {
      "source": "10.20.2.148",
      "destination": "a_10.20.3.107",
      "service": "lpdw0rm",
      "trusted_traffic_id": 909,
      "display_traffic_level": "All firewalls",
      "trust_future_host_group_changes": false,
      "compatible_trusted_traffic_id": "uxavXs33Slwep"
    },
    {
      "source": "10.20.2.148",
      "destination": "acl-5f980636",
      "expirationDate": 1599253200000,
      "service": "RAT",
      "trusted_traffic_id": 911,
      "display_traffic_level": "All firewalls",
      "trust_future_host_group_changes": false,
      "compatible_trusted_traffic_id": "svi8Mu6qtjQmV"
    },
    {
      "source": "10.20.1.4",
      "destination": "10.20.1.6",
      "expirationDate": 1598648400000,
      "service": "name of service",
      "comment": "comment text",
      "trusted_traffic_id": 912,
      "display_traffic_level": "All firewalls",
      "trust_future_host_group_changes": false,
      "compatible_trusted_traffic_id": "rHxI1IJjT9iBw"
    }
  ],
  "pageable": {
    "sort": {
      "sorted": false,
      "unsorted": true,
      "empty": true
    },
    "pageSize": 4,
    "pageNumber": 0,
    "offset": 0,
    "paged": true,
    "unpaged": false
  },
  "totalPages": 37,
  "totalElements": 147,
  "last": false,
  "number": 0,
  "size": 4,
  "numberOfElements": 4,
  "sort": {
    "sorted": false,
    "unsorted": true,
    "empty": true
  },
  "first": true,
  "empty": false
}

Related topics

Trusted Traffic Data APIs