Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Macs enrolled in Iru. Prism collects Application Firewall data on macOS only.
Prompt for your agent
Pull Application Firewall data for every Mac in Iru from Prism with GET /api/v1/prism/application_firewall. List the Macs whose firewall is off, with each Mac's name, serial number and Blueprint. Tell me which field and value you used to decide, since I want to check it. If the results run past one page, page through them with limit and offset until you have every Mac.
Steps
Pull the Prism Application Firewall category
Prism reports the built-in macOS application firewall, including block all incoming, stealth mode, logging, allow signed applications and firewall unloading. Each record also carries the device name, serial number and Blueprint.
GET/api/v1/prism/application_firewallSource: Prism
Keep the Macs with the firewall off
The response example includes a
statusfield, but the docs don't say what it means, so have the agent show you the field and value it filtered on.In the web app, open the Application Firewall 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
- Firewall exceptions aren't part of this category yet. The docs say they will ship later in their own category.
- Prism collects Application Firewall data every 15 minutes or every 24 hours, depending on the attribute, so a recent change can take time to appear.
- One request returns at most 300 device records, so a large fleet needs
limitandoffsetpaging.
FAQ
Which API call lists Application Firewall status for every Mac?
GET /api/v1/prism/application_firewall returns Application Firewall details for macOS from Prism.
What does the Application Firewall category cover?
It covers block all incoming, stealth mode, logging, allow signed applications and firewall unloading. Firewall exceptions aren't included yet.
How often does Prism collect firewall data?
Prism lists the collection frequency as 15 minutes or 24 hours, depending on the attribute.
Does it cover Windows?
No. The Application Firewall category and this endpoint cover macOS only.