Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Macs enrolled in Iru. Gatekeeper and XProtect data is available for Mac only.
Prompt for your agent
Pull Gatekeeper and XProtect data for every Mac in Iru from Prism with GET /api/v1/prism/gatekeeper_and_xprotect. List the Macs where Gatekeeper is off. Then group the Macs by XProtect version and show me the ones on the oldest versions, with each Mac's name and serial number. Tell me which fields and values you used, since I want to check them. If the results run past one page, page through them with limit and offset until you have every Mac.
Steps
Pull the Prism Gatekeeper and XProtect category
Prism reports Gatekeeper status and mode, plus the Gatekeeper, Opaque, XProtect and MRT versions. The Iru Agent collects this data from every Mac every 15 minutes.
GET/api/v1/prism/gatekeeper_and_xprotectSource: Prism
Find Gatekeeper off and old XProtect versions
The response example includes
gatekeeper_statusandxprotect_version. Have the agent show you the value it treated as off and how it ranked XProtect versions.In the web app, open the Gatekeeper & XProtect category in Prism and use + Filter to narrow the table by any attribute.
Source: Prism
Export the list
In Prism, select Export CSV, choose Current View to keep your filter, then select Start export.
Source: Prism
Common pitfalls
- Gatekeeper exceptions aren't part of this category yet. The docs say they will arrive later as a separate category.
- Prism data can be up to 15 minutes old.
- The docs don't say which XProtect version is current, so compare versions across your own fleet.
- One request returns at most 300 device records, so a large fleet needs
limitandoffsetpaging.
FAQ
Which API call returns Gatekeeper and XProtect data?
GET /api/v1/prism/gatekeeper_and_xprotect returns Gatekeeper and XProtect attributes for macOS.
Which versions does Prism report?
Prism reports the Gatekeeper, Opaque, XProtect and MRT versions, plus Gatekeeper status and mode.
How current is the data?
The Iru Agent collects it every 15 minutes, so a result can be up to 15 minutes old.
Does it cover iPhone or iPad?
No. The API limits results to Mac because Gatekeeper and XProtect don't apply to other platforms.