Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Macs enrolled in Iru. System extension data is available for macOS only.
Prompt for your agent
Pull system extension data for every Mac in Iru from Prism with GET /api/v1/prism/system_extensions. Group the extensions by name and Team ID, and for each one show how many Macs have it, its state and whether it is MDM managed. Call out the endpoint security and network extensions, since those cover security agents and VPN clients. Tell me which fields 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 System Extensions category
Prism reports installed system extensions on macOS, including state, MDM Managed, Team ID and version details. The Iru Agent collects this data every 15 minutes.
GET/api/v1/prism/system_extensionsSource: Prism
Group by extension type
The response example includes
name,identifier,team_id,state,categoriesandis_mdm_managed. The docs describe three system extension frameworks: DriverKit for drivers, Network Extensions for content filters, DNS proxies and VPN clients, and Endpoint Security for monitoring and blocking system events.Have the agent show you which field it used to sort extensions into those types.
Source: System extensions on macOS
Export the list
In Prism, open the System Extensions category, use + Filter to narrow the table, then select Export CSV, choose Current View and select Start export.
Source: Prism
Pre-approve an extension
To pre-approve an extension, create a system extension profile. Enter its Team ID, then leave Approve all system extensions at its default or choose Allow specific system extensions or Allow specific system extension types.
Source: System extensions on macOS
Common pitfalls
- Prism data can be up to 15 minutes old.
- Kernel extensions are a separate Prism category, so this report covers system extensions only.
- Deselecting Allow users to approve system extensions in a system extension profile also disapproves any extension a user approved earlier.
- One request returns at most 300 device records, so a large fleet needs
limitandoffsetpaging.
FAQ
Which API call lists system extensions on every Mac?
GET /api/v1/prism/system_extensions returns system extension attributes for macOS from Prism.
Which kinds of system extension can I find?
The docs describe DriverKit drivers, Network Extensions such as content filters, DNS proxies and VPN clients, and Endpoint Security extensions.
Do kernel extensions show up in the same call?
No. Prism lists kernel extensions as their own category.
How do I pre-approve a system extension?
Create a system extension profile, enter the extension's Team ID and choose which extensions to approve.