Enabling/Disabling Jamf as an External Data Source

Integrating Jamf Pro as an external data source in Josys automates adding and updating devices.

Prerequisites

Before you begin with linking Jamf Pro as an External Data source, make sure that you have integrated the Jamf Pro app. Refer to the Jamf Pro article to learn about the integration process.

Linking Jamf Pro

Step 1: Go to Settings and select External Data Sources. Under Devices, find the Jamf Pro section, then click on Link.

Step 2: On the Match Records screen, choose the fields for Jamf Pro and Josys to create a match, then click Next.

Device details between Jamf Pro and Josys are matched using selected fields (match key). When a field in Jamf Pro matches with a field in Josys, the Josys record is updated with Jamf Pro data. If no match is found, a new record is created in Josys.

Scenario - Matching two Jamf Pro devices with two existing Josys devices using Serial Number

Note: 
1. If multiple records match in Josys, preference is given to the first matched record. 
2. Multiple Jamf Pro integrations require selection of an integration instance.

Step 3: To add a device in Josys, map the Josys Asset Number with Jamf Pro fields manually or auto-generate it. This can be done in the following two ways:

Option 1: Map UUID, Serial Number, or Device Name from Jamf Pro to Josys Asset Number.

• Option 2: Auto-generate Asset Number with a prefix and incremental value.

Note:
1. In case of an asset number conflict (asset number mapped from Jamf Pro already exists in Josys), a new device record will be created with prefix SYS, making SYS1A the asset number for the newly created device.
2. If the asset number mapped from Jamf Pro is blank, Josys will generate an asset number starting from SYS1 for the first device with a blank asset number, SYS2 for the second device with a blank asset number, and so on.

You can use the click here link to learn about the remaining fields that will be mapped automatically. Learn more about the mapping from here.

Step 4: Review and confirm record mapping, then click Link Jamf Pro as External Data Source.

Step 5: After linking Jamf Pro, you will receive a confirmation message. Josys will start syncing device data from Jamf Pro, visible in the Devices section. Click Refresh to update data.

Synchronized devices from Jamf Pro are marked with a Jamf Pro icon. New devices created on the current day are labeled New. Additional fields post-synchronization appear in the Customized Column.

Note: 
1. Configure the Source column if not visible from the Customize Columns.
2. Data refresh may take some time.

After the device data from Jamf Pro is synched with Josys, then the following data is displayed on the Devices screen: 

• Device sync date and time with Jamf Pro
• Disk Storage (GB) in System Configuration
• Additional Jamf Pro Attributes

View Configuration

You can view configuration details of Jamf Pro by following these steps

Step 1: Click  and select View Configuration from the below screen.
  

Step 2: The integration details are displayed, as shown below.
  

Unlinking Jamf Pro

You can unlink Jamf Pro as a Device Data Source to control the devices. To unlink:

Step 1: Click  and select Unlink from the below screen.

Step 2: You will get the following two options:

• Retain all synched devices: This option will keep all synchronized devices to Josys which will change the Source of these devices from Jamf Pro to Josys. These devices will then be considered as manually created devices.
• Delete synced devices:  This option will delete all synchronized Jamf Pro devices, including their associations with user profiles/ device assignments.

Step 3: Click Unlink Josys to confirm your selection.

FAQ

How often does Josys synchronize device information with Jamf Pro?

Josys automatically synchronizes device information with Jamf Pro daily, ensuring data consistency and accuracy.

How does Josys ensure precise device information linkage between Josys and Jamf Pro after the device fields are edited?

Josys uses the UUID obtained from Jamf Pro for subsequent device updates, ensuring precise linkage between the two platforms even when device fields are edited within Josys

What happens to MDM fields during export and import?

While exporting the device records, all MDM fields (like Disk Space, etc.) are included, however, MDM fields are excluded while importing the device records to prevent any import errors.

What happens to Device creation if I have mandatory custom fields?

Device creation will be done with a mandatory device custom field as 'blank'.

What happens when Jamf Pro is unlinked as EDS?

When Jamf Pro is unlinked as the External Data Source (EDS), the following changes occur:

• Device Data Source Localization: Devices synced or fetched from Jamf Pro will remain on the platform, but their data source will be changed to local. 
• Removal of Jamf Pro Columns: Jamf Pro-related columns are deleted from:

• Device detail pages
• Device list (including columns and filters)
  
• CSV exports

• Deletion of Jamf Pro UUIDs: All Jamf Pro UUIDs stored for devices are deleted, initiating a fresh synchronization process for future matches.