Skip to content
All recipes

Check Gatekeeper and XProtect on every Mac

Pull Gatekeeper and XProtect data for every Mac from Prism and list the Macs with Gatekeeper off or an XProtect version that trails the rest of your fleet.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
macOS
Effect
Read-only
Agent access
Iru MCP or the Iru API

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

  1. 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_xprotect

    Source: Prism

  2. Find Gatekeeper off and old XProtect versions

    The response example includes gatekeeper_status and xprotect_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

  3. 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 limit and offset paging.

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.

Next steps

Sources

Stay up to date

Iru's bi-weekly collection of articles, videos, and research to keep IT & Security teams ahead of the curve.