Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- The date range to check, and the device if you want one Mac's key.
Prompt for your agent
Search the Iru audit log with GET /api/v1/audit/events?limit=500&sort_by=-occurred_at for events that record access to sensitive data such as FileVault keys, between [start date] and [end date]. Page through every result with the cursor. Show me the field and value you used to pick those events, since I want to check it. Then list tenant admins with GET /api/v1/admins and match each actor_id to an admin id. For each event, show me the admin's name and email, the occurred_at time and the target_id. If an actor_id matches no admin, say so and show me its actor_type. Don't guess who it is.
Steps
Pull audit events for the date range
The audit log includes access to sensitive data such as FileVault keys and recovery keys. Pass
start_dateandend_dateto limit the range, and use thenextcursor to read more than 500 events.GET/api/v1/audit/events?limit=500&sort_by=-occurred_atSource: Iru API: List audit events
Keep the sensitive-data events
The docs don't name the field that marks a key view. Have the agent show you the
action,target_typeandtarget_idof the events it kept, and the value it matched on.Source: Activity
Match each actor to an admin
The
idof each tenant admin maps to theactor_idin audit events. Each admin record hasemail,first_name,last_name,roleandis_active.GET/api/v1/adminsConfirm it in the web app
Select the Activity icon at the top right, filter by Date, User or Category, then expand a row. Select Show JSON for the raw event record.
Source: Activity
Check it worked
- The events the agent lists match the same date range on the Activity page.
Common pitfalls
- The User filter in Activity lists administrators only. It doesn't list users synced through a User Directory Integration.
- Admins come back in pages. Page through the admin list, or an
actor_idcan look unmatched when it isn't.
FAQ
Which API call shows who viewed a FileVault key?
GET /api/v1/audit/events lists access to sensitive data such as FileVault keys. Each event has an actor_id that you match to a tenant admin.
How do I turn an actor_id into a name?
GET /api/v1/admins lists tenant admins. Each admin id maps to an actor_id in the audit events.
How is this different from the setting-changes recipe?
That recipe searches for who changed a Blueprint, Library Item or device setting. This one searches for who accessed sensitive data and resolves the actor to an admin.
Can I check it in the web app?
Yes. Open Activity, filter by Date, User or Category, and select Show JSON on a row. The User filter lists administrators only.