Before you start
- An Iru API token with MCP turned on and permissions that cover the calls below (recipe 1).
- The Mac has a Recovery Password Library Item applied. After the password is set, it becomes available once the device's next daily check-in completes.
Prompt for your agent
Find the Mac used by [user name or serial number] in Iru with GET /api/v1/devices. Show me its name, serial number and model, then stop and wait for my approval. After I approve, retrieve its recovery password with GET /api/v1/devices/{device_id}/secrets/recoverypassword and show it to me once, exactly as returned. Tell me whether this is an Apple silicon Mac, since that decides what kind of password it is.
Steps
Find the Mac
Have the agent find the Mac by the user's name or the serial number and show you the device record, including its model, before it goes further.
GET/api/v1/devicesSource: Iru API: List Devices
Retrieve the password after you approve
On an Apple silicon Mac the call returns the Recovery Lock password. On an Intel Mac it returns the legacy EFI firmware password. The response holds a
recovery_passwordvalue.To do the same in the web app, open the Device Action Menu in the upper right of the device record and select View Recovery Lock password.
GET/api/v1/devices/{device_id}/secrets/recoverypasswordApproval requiredThe agent shows you the Mac and waits. Approve only when you are ready to use the password.
Enter the password exactly as shown
An automatically generated recovery password must be entered exactly as displayed, including all capital letters and hyphens.
Check it worked
- The Mac accepts the password at the Recovery Lock prompt.
Common pitfalls
- The password is not available until the device's next daily check-in completes after it is set.
- When you move a device to a Blueprint with different recovery password settings, Iru updates the password on the Mac to match, so retrieve it again afterward.
- After you remove the Recovery Password Library Item, the password still shows on the device record until the next daily check-in.
FAQ
Which API call returns the Recovery Lock password?
GET /api/v1/devices/{device_id}/secrets/recoverypassword returns the Recovery Lock password for an Apple silicon Mac.
What does the call return for an Intel Mac?
It returns the legacy EFI firmware password.
Is access to the password logged?
The sources I checked don't say. The audit log documents access to sensitive data such as FileVault keys, so look for the event in GET /api/v1/audit/events before you rely on it.
Where is the password in the web app?
Open the Device Action Menu in the upper right of the device record and select View Recovery Lock password.