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_ids query parameter. If the simulation_ids parameter 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.