Overview
By integrating Jamf Pro, you can automate the addition and updating of devices. Device information from Jamf Pro can be imported into Josys's Devices ledger, serving as the master data for your devices.
Key Features
- Imports device information from Jamf Pro into Josys's Devices ledger.
- If a device does not match any existing device in Josys, it will be automatically imported from Jamf Pro as a new device.
Integration Steps
- Go to "Integrations > External Data Sources," open the "Devices" tab, and click the "Link" button for Jamf Pro.
-
In "Match Records," select the fields used as the key to match Jamf Pro and Josys data, then click "Next."
The keys available for mapping are as follows:Jamf Pro Josys Serial Number Serial Number UUID Asset Number Model Name If a Jamf Pro field matches a Josys field, the Josys data will be updated with the Jamf Pro data.
If no match is found, the device will be registered as a new device in Josys.Field Jamf Pro Josys Result Serial Number A A Updates device data Serial Number X No existing device has serial number X Registers as a new device ⚠️ If multiple devices match on the Josys side, the first matching device will take priority.
If multiple Jamf Pro integrations exist, you must select which Jamf Pro to integrate during the External Data Sources setup. - In "Set Asset Number," choose whether to map the Josys asset number to a Jamf Pro field or generate it automatically, then click "Next." This can be done in one of the following two ways:
Option 1: Map the Jamf Pro UUID, Serial Number, or Model Name to the Josys asset number.Option 2: Automatically generate asset numbers using a prefix and sequential numbers.
⚠️If an asset number duplicate occurs (i.e., the asset number mapped from Jamf Pro already exists in Josys), the device will be registered as a new device, and its asset number will be prefixed with "SYS" (e.g., SYS1A). If the asset number mapped from Jamf Pro is blank, Josys will automatically generate an asset number. In this case, sequential numbers will be assigned, starting with SYS1 for the first device, SYS2 for the second, and so on.
- Click "click here" to view the remaining fields that will be mapped automatically.
- In "Assign Devices," choose whether to automatically assign Jamf Pro devices to identities in Josys, then click "Next."
- If you select "Auto-assign Devices to Employees," devices are assigned to identities in Josys based on the value of the "Jamf Pro Field for fetching Email IDs" (Email). This replaces the existing assignees of devices in Josys.
If you leave it unselected, all devices will be imported without an assigned employee. - In "Settings," select the Josys fields that should always be overwritten with Jamf Pro data during synchronization, then click "Next."
Available fields: Device Category, Model Name, Manufacturer, Model Number, Operating System
- In "Confirm & Link," review the settings and click "Link Jamf Pro as an External Data Source."
Post-Integration Screens
Details Screen
Device List Screen
"Source" and the fields listed above will be displayed as display columns and filter options.
Disconnection Steps
-
Go to "Integrations > External Data Sources," open the "Devices" tab, click "…" for Jamf Pro, and select "Unlink."
-
You will see the following two options. Select an option and click "Unlink Jamf Pro."
Retain all synced devices
If you select this option, all devices synced from Jamf Pro will be retained in Josys, and the data source for these devices will change from Jamf Pro to Josys. Going forward, these devices will be treated as manually created devices.
Delete synced devices
If you select this option, all devices synced from Jamf Pro will be deleted, including their associated user profiles and device assignments.
Frequently Asked Questions
Q: How frequently is device information synced between Jamf Pro and Josys?
A: Josys automatically syncs device information with Jamf Pro daily.Q: Is it okay to edit device fields?
A: Josys uses the UUID retrieved from Jamf Pro for subsequent device updates. Therefore, even if device fields are edited, the link between both platforms is maintained.Q: What happens to MDM fields during export and import?
A: When exporting device information, all MDM fields, such as disk capacity, are included. However, during import, MDM fields are excluded to prevent errors.Q: What happens to device creation if there are required Custom Fields?
A: The device will be created with the required device Custom Fields left blank.Q: What happens when Jamf Pro is disconnected from External Data Sources?
A: When Jamf Pro is disconnected from External Data Sources, the following changes occur:
1. Device data source changes to local: Devices synced and retrieved from Jamf Pro will remain in Josys, but their data source will change to local.2. Jamf Pro-related columns are removed: Columns related to Jamf Pro will be removed from the following locations:
- Device details page
- Device list (including columns and filters)
- CSV export
Removal of Jamf Pro UUIDs: All Jamf Pro UUIDs stored on the devices will be deleted, and a new sync process will be initiated for future matching.Q: If you delete a device, will it also be removed from the Josys Devices ledger?
A: No, it will not be deleted from the Josys Devices ledger. The sync with Jamf Pro will be disconnected, and the device will remain in Josys as if it were manually registered.