Permissions
To connect your Atomicwork and Jamf accounts, you need:
Atomicwork admin access: You need org admin access in Atomicwork.
Jamf Pro access: You need access to a Jamf Pro account with API access.
Jamf Pro API URL and credentials
Setup
Step 1: Create an API role and client for Atomicwork in Jamf
To enable Atomicwork to access the Jamf Pro API, create an API role with the required permissions and generate a client ID and secret.
Refer to Jamf's article on creating API roles and clients for detailed instructions. When creating the API role, select the following permissions under Jamf Pro API role privileges:
Role privilege | Corresponding endpoint | Purpose |
Read Computers | /computers-inventory, /computers-inventory-detail/{id} | Read inventory data for all computers as well as detailed info for a specific computer. |
Read Mobile Devices | /mobile-devices, /mobile-devices/{id} | List mobile devices in inventory and read detailed info for a specific mobile device. |
View MDM command information in Jamf Pro API | /mdm/commands | Execute or view MDM commands such as reset or restarting devices. |
Once you've created the API client, copy the client ID and secret to use in the next step.
Step 2: Connect Jamf with Atomicwork
As an Atomicwork admin, navigate to Settings > App Store > Jamf, and click on Connect.
In the Jamf integration setup page, enter the following details:
Jamf API URL
Client ID
Client Secret
Click on Test to ensure Atomicwork can successfully authenticate with Jamf.
If the authentication is succesful, click on Connect to complete the process.
Step 3: Configure attribute mapping
You can map Jamf attributes to Atomicwork attributes to ensure device data syncs correctly between the two platforms.
On successfully connecting Jamf, you will be taken to Map attributes page. By default, the following attribute mappings are included:
Jamf attribute | Atomicwork attribute |
Name | Display name |
Serial number | Serial number |
Assigned to | Assigned to |
Status | Status |
Click on + Add attribute and select the Jamf attribute to map.Atomicwork will automatically recommend the appropriate Atomicwork attribute for mapping.
You can choose other attributes or create a new attribute in Atomicwork for mapping.
Click on Save to confirm all configurations.
Step 4: Enable asset sync
On the Jamf app page, click on Enable against Sync assets automatically sync Jamf data to Atomicwork.
After the initial sync, Atomicwork will sync asset info from Jamf every 24 hours.