get https://api.picussecurity.com/v1/mitigation/devices
Device List; Device Name, Blocked Actions Count, Not Blocked Actions Count, Total Action Count, Score
About
Mitigation Device List Endpoint is designed to return mitigation device information as obtained under Picus platform > Mitigation > Vendor Based Mitigations. Vendor based mitigation devices can be fetched using the endpoint.
Return Definitions
- score field in the response is the value that indicates the cumulative score information of the simulations in the scope. Simulations in the scope can be filtered with the
simulation_idsquery parameter. If thesimulation_idsparameter is not included in the request, the score information of all simulations is taken into account when calculating the score value in the response.
Example
Get device information with statistics of simulations with id 4969, 4970, 4980.
curl --request GET \
--url 'https://api.picussecurity.com/v1/mitigation/devices?simulation_ids=4969,4970,4980' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer access_token'
[
{
"id": 25,
"device_name": "McAfee vNSP",
"blocked_action_count": 0,
"not_blocked_action_count": 31,
"total_action_count": 31,
"score": 0
},
{
"id": 19,
"device_name": "Forcepoint NGFW",
"blocked_action_count": 0,
"not_blocked_action_count": 33,
"total_action_count": 33,
"score": 0
},
{
"id": 20,
"device_name": "Fortigate AV",
"blocked_action_count": 0,
"not_blocked_action_count": 33,
"total_action_count": 33,
"score": 0
},
{
"id": 21,
"device_name": "Fortigate IPS",
"blocked_action_count": 0,
"not_blocked_action_count": 2,
"total_action_count": 2,
"score": 0
},
{
"id": 16,
"device_name": "Check Point NGFW",
"blocked_action_count": 0,
"not_blocked_action_count": 28,
"total_action_count": 28,
"score": 0
},
{
"id": 24,
"device_name": "Imperva SecureSphere",
"blocked_action_count": 0,
"not_blocked_action_count": 0,
"total_action_count": 0,
"score": 0
},
{
"id": 17,
"device_name": "Citrix Web App Firewall",
"blocked_action_count": 0,
"not_blocked_action_count": 0,
"total_action_count": 0,
"score": 0
},
{
"id": 18,
"device_name": "F5 BIG-IP",
"blocked_action_count": 0,
"not_blocked_action_count": 0,
"total_action_count": 0,
"score": 0
},
{
"id": 22,
"device_name": "Fortigate WAF",
"blocked_action_count": 0,
"not_blocked_action_count": 0,
"total_action_count": 0,
"score": 0
},
{
"id": 23,
"device_name": "FortiWeb",
"blocked_action_count": 0,
"not_blocked_action_count": 0,
"total_action_count": 0,
"score": 0
}
]
Simulation Ids Filter
Optional, Max 20 simulation ids can be filtered.