Note: Available only for new signups after the 31 March, 2026 release. If you signed up earlier, refer to the existing ITAM documentation.

Jamf discovery identifies Apple devices managed by Jamf to streamline asset management. This article provides information on how to configure Jamf discovery jobs, set up required permissions, and collect data from your Jamf environment.

Jamf Discovery items

Jamf discovery retrieves comprehensive data from managed Apple environments, ensuring your inventory stays up to date with the following information:

• Computers and mobile devices

• IP and MAC addresses

• Installed software and applications

• Extension attributes (Custom Fields)

You can view discovered software under the Software In Use tab on the details page of any discovered mobile device.

Prerequisites

You need the following before the installation:

• A Jamf account with a standard user account and read-all permissions. The Auditor privilege set is recommended. Alternatively, you can use a Custom privilege set with all-read permissions enabled. For information on standard accounts and privilege sets, refer to the Jamf Pro User Accounts and Groups documentation.

• Valid Jamf account credentials (username and password) to request a bearer token for authentication.

• The URL for your Jamf instance, including the port if applicable.

Create a Jamf discovery job

To configure a Jamf discovery job, follow these steps:

Step 1: Add a new discovery job

1. Go to Admin > Asset Management > Scan and discover and click the Discovery Jobs tab.

2. Select Cloud from the list of discovery jobs and click Add new.

3. Select Jamf from the Type dropdown menu.

4. Select a Remote Collector from the drop-down.

5. Enter the URL the job will use, including the port if necessary.

6. Enter your Basic credentials for the Jamf account.
   

Step 2: Configure device and metadata options

1. Optionally, add a Service Level for the discovered devices.

2. In Device vendor metadata drop-down, select one of the following:

   • Tags

   • Custom Fields

   • Do Nothing (Default)

3. Optionally, include Tags for discovered devices to categorize items for searching and filtering.

4. Select a Customer for discovered devices to add another specialized classification or create a new by using the Add new Cost Center option.

5. In the Debug level dropdown, select the logging level. Normal Debug is the default; you can also select No Debug or Extended Debug.
   

Step 3: Schedule and run the discovery job

1. In the Discovery Schedule section, click Add new to create an autodiscovery for the job. You can create multiple schedules.

2. Click Save, then click Run Now to start the discovery.

Note: Newly created jobs will not run on the first day of creation to prevent a high volume of simultaneous tasks.  To start the discovery immediately, click Run Now on the Discovery Jobs page or from the Job details view page.