Skip to content
All recipes

Get a Recovery Lock password for an Apple silicon Mac

Retrieve the Recovery Lock password for a Mac with Apple silicon after you approve it, then hand it to the user or technician.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
macOS
Effect
Shows a secret
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 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

  1. 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/devices

    Source: Iru API: List Devices

  2. 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_password value.

    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/recoverypassword

    Approval requiredThe agent shows you the Mac and waits. Approve only when you are ready to use the password.

    Source: Configure the Recovery Password Library Item

  3. Enter the password exactly as shown

    An automatically generated recovery password must be entered exactly as displayed, including all capital letters and hyphens.

    Source: Configure the Recovery Password Library Item

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.

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.