Skip to content
All recipes

Build a Prism evidence pack before an audit

Pull FileVault, Application Firewall, Gatekeeper and OS version data from Prism and save it as CSV exports with dates.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
macOS, plus all devices for OS version
Effect
Read-only, requests exports
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).
  • Prism categories for FileVault, Application Firewall and Gatekeeper & XProtect cover macOS. Device information covers every platform Prism collects from.
  • This pack gathers device data. It doesn't claim to satisfy any compliance framework, so match each field to your auditor's request yourself.

Prompt for your agent

Build me a pre-audit evidence pack from Prism. Pull these four categories, paging with limit and offset until you have every device: GET /api/v1/prism/filevault GET /api/v1/prism/application_firewall GET /api/v1/prism/gatekeeper_and_xprotect GET /api/v1/prism/device_information For each Mac, show me the serial number, key_escrowed, the firewall status, gatekeeper_status, xprotect_version and os_version, plus last_collected_at for each category. Tell me which devices are missing from any category. Stop and wait for my approval before you request any export. After I approve, request exports with POST /api/v1/prism/export for the categories that API accepts, then check each one with GET /api/v1/prism/export/{export_id} until it succeeds and give me the signed_url.

Steps

  1. Pull the four categories

    Each call returns up to 300 device records per request. Use limit and offset to page, and blueprint_ids or device_families to narrow the scope.

    GET/api/v1/prism/filevault
    GET/api/v1/prism/application_firewall
    GET/api/v1/prism/gatekeeper_and_xprotect
    GET/api/v1/prism/device_information

    Source: Prism

  2. Read the evidence fields

    FileVault returns key_escrowed. Application Firewall returns block_all_incoming, stealth_mode, logging and allow_signed_applications. Gatekeeper & XProtect returns gatekeeper_status, xprotect_version and malware_removal_tool_version. Device information returns os_version and display_os_version.

    Every row also carries last_collected_at, which shows when Prism last collected that data. Keep it in the pack.

    Source: Iru API: Prism FileVault, Application firewall, Gatekeeper and XProtect, Device information

  3. Request the exports after you approve

    The export call takes one category per request. Its documented categories include device_information and gatekeeper_and_xprotect, but not filevault or application_firewall.

    For FileVault and Application Firewall, save the call results from the previous step, or in the web app open the category in Prism and select Export CSV, choose Current View or All Attributes, then select Start export.

    POST/api/v1/prism/export

    Approval requiredThe agent lists the exports it plans to request and waits for your go.

    Source: Iru API: Request category export

  4. Check each export and download it

    An export starts as pending. Read it back until status is success, then download the CSV from signed_url.

    GET/api/v1/prism/export/{export_id}

    Source: Iru API: Get category export

Check it worked

  • Each export reaches status success and has a signed_url.
  • Every row in the pack shows a last_collected_at date.

Common pitfalls

  • FileVault and Gatekeeper & XProtect collect every 15 minutes. Application Firewall collects every 15 minutes or every 24 hours, and Devices collect every 24 hours on Apple platforms. Note the collection time in your pack.
  • The FileVault category grays out when you filter Prism to iOS, and Gatekeeper & XProtect is limited to Mac.
  • Share the CSV through your normal evidence process.

FAQ

Which Prism calls cover FileVault, firewall, Gatekeeper and OS version?

GET /api/v1/prism/filevault, /application_firewall, /gatekeeper_and_xprotect and /device_information. The first three cover macOS.

Can I export FileVault and firewall data through the API?

The documented export categories don't include them. Save the call results, or use Export CSV on the category in Prism.

How current is the data?

FileVault and Gatekeeper & XProtect collect every 15 minutes. Devices collect every 24 hours on Apple platforms. Each row shows last_collected_at.

Does this pack satisfy a compliance framework?

The recipe gathers device data and makes no compliance claim. Map each field to your auditor's request yourself.

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.