Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- Macs enrolled in Iru. The Transparency Database covers macOS only.
Prompt for your agent
Pull the Transparency Database for every Mac in Iru from Prism with GET /api/v1/prism/transparency_database. List the apps that have been granted full disk access or screen recording, with each Mac's name, the app and the status. Tell me which service values you matched on and which fields you used, since the docs don't list the service values and 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 Transparency Database
Prism reports Transparency, Consent, and Control (TCC) entries on macOS, including the service, the application, an Allowed or Denied status and the status reason (User Set, System Set or MDM Policy). The Iru Agent collects this data every 15 minutes.
GET/api/v1/prism/transparency_databaseSource: Prism
Keep the two services you care about
The response example includes
service,applicationandstatus. The docs don't list the service values, so have the agent name each value it matched for full disk access and for screen recording.Ask the agent to keep only entries with an Allowed status, then group them by app.
Source: Prism
Export the list
In Prism, open the Transparency Database category, use + Filter to narrow the table, then select Export CSV, choose Current View and select Start export.
Source: Prism
Set the decision with the Privacy Library Item
To decide access yourself, use the App access control in the Privacy Library Item. It writes the privacy decision to the Mac, so the user isn't prompted and can't change it.
You identify each app by bundle ID or path plus its code requirement, then choose Allow or Deny. Apple only permits Deny for Camera, Microphone and Screen Recording.
Common pitfalls
- The status reason tells you who made the decision. An entry marked User Set came from the user, and one marked MDM Policy came from device management.
- Prism data can be up to 15 minutes old.
- One request returns at most 300 device records, so a large fleet needs
limitandoffsetpaging. - When more than one Privacy Library Item covers the same app on a device, only the rules from the first one applied are used.
FAQ
Which API call shows which apps have privacy access on a Mac?
GET /api/v1/prism/transparency_database returns Transparency Database (TCC) attributes for macOS.
Which service values mean full disk access or screen recording?
The docs don't list the service values, so the prompt asks the agent to name the ones it matched. Check them before you act on the list.
How can I tell whether a user or an admin granted access?
Each entry carries a status reason of User Set, System Set or MDM Policy.
How do I enforce or deny access for an app?
Use the App access control in the Privacy Library Item. Apple only permits Deny for Camera, Microphone and Screen Recording.