Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Macs enrolled in Iru. Startup settings are available for macOS only.
Prompt for your agent
Pull startup settings for every Mac in Iru from Prism with GET /api/v1/prism/startup_settings. List the Macs where System Integrity Protection is off or Secure Boot is not at the full level, 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 Startup Settings category
Prism reports core macOS security settings such as System Integrity Protection (SIP), Authenticated Root Volume, Bootstrap Token and Secure Boot.
GET/api/v1/prism/startup_settingsSource: Prism
Keep the Macs that miss your baseline
The response example includes
sipandsecure_boot_level. Have the agent show you the value it treated as off for SIP and the level it treated as below full for Secure Boot.In the web app, open the Startup Settings 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
- Prism collects startup settings through MDM every 24 hours, so a recent change can take a day to appear.
- One request returns at most 300 device records, so a large fleet needs
limitandoffsetpaging.
FAQ
Which API call returns Mac startup security settings?
GET /api/v1/prism/startup_settings returns startup settings for macOS from Prism.
Which settings does it cover?
Prism reports System Integrity Protection (SIP), Authenticated Root Volume, Bootstrap Token and Secure Boot.
How often does Prism collect startup settings?
Prism collects them through MDM every 24 hours.
Does it cover Windows or iOS?
No. Startup settings in Prism are listed for macOS only.