Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- The CVE ID you want to check, such as
CVE-2018-25032.
Prompt for your agent
List the software that [CVE ID] affects in my fleet with GET /api/v1/vulnerability-management/vulnerabilities/{cve_id}/software. For each app, show its name, how many versions are affected and how many devices it touches. Under each app, list every affected version with the number of devices on it and the latest detection date. Also report the severity of the CVE and tell me which field you read it from. Pages hold at most 50 records, so keep paging until you have everything, and tell me how many apps you found.
Steps
List the affected software
The call returns one entry per app, with
name,bundle_id,num_versionsandnum_devices. Each entry holds asoftware_versionslist with theversion,devices_impactedandlatest_detection_datefor every affected version.The response example also shows a
severityfield. Have the agent say which field it read the severity from.GET/api/v1/vulnerability-management/vulnerabilities/{cve_id}/softwareSource: Iru API: List Affected Software
Narrow by Blueprint or detection date
The call takes a
filteronblueprint_idanddetection_datetime, and it sorts bysoftwareordetection_datetime. Ask for a Blueprint when you want to patch one group of devices first.A page holds at most 50 records, so the agent pages with
pageandsizeuntil it has every app.Source: Iru API: List Affected Software
Compare with the web app
In the web app, search by CVE ID on the Vulnerabilities page, open the CVE and select the Vulnerable software tab. It lists the software name and version, the type, the affected device count and the platform, and you can filter by Detection date, Blueprint and Device.
Source: Vulnerability Management
Common pitfalls
- Devices scan every 15 minutes and matching runs hourly. Allow up to an hour for a new CVE to appear.
- Excluded devices don't count toward affected-device totals.
- A CVE shows as remediated only when every affected app and every active, non-excluded device is patched.
- This recipe lists affected software. To list the affected devices instead, use the exposed-devices recipe.
FAQ
Which API call lists the software a CVE affects?
GET /api/v1/vulnerability-management/vulnerabilities/{cve_id}/software returns the apps affected by that CVE, with each version and the devices on it.
How is this different from listing affected devices?
The software call lists apps and versions with device counts. The devices call, GET /api/v1/vulnerability-management/vulnerabilities/{cve_id}/devices, lists each affected device.
Can I filter the affected software by Blueprint?
Yes. The call takes a filter on blueprint_id and detection_datetime, and a page holds at most 50 records.
Does it cover Windows?
Yes. Vulnerability Management covers Mac and Windows computers.