Skip to content
All recipes

Find out who viewed a FileVault key or other secret

Search the audit log for access to sensitive data, then match each actor to a tenant admin by name and email.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
All
Effect
Read-only
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).
  • 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

  1. Pull audit events for the date range

    The audit log includes access to sensitive data such as FileVault keys and recovery keys. Pass start_date and end_date to limit the range, and use the next cursor to read more than 500 events.

    GET/api/v1/audit/events?limit=500&sort_by=-occurred_at

    Source: Iru API: List audit events

  2. 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_type and target_id of the events it kept, and the value it matched on.

    Source: Activity

  3. Match each actor to an admin

    The id of each tenant admin maps to the actor_id in audit events. Each admin record has email, first_name, last_name, role and is_active.

    GET/api/v1/admins

    Source: Iru API: List tenant admins (actors)

  4. Confirm 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_id can 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.

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.