What syncs
- Devices: Managed computers and managed mobile devices.
- Schedule: every 12 hours, once Asset is selected under the integration’s Sync scopes. Connecting alone doesn’t start it.
- Asset types: Computers get a type named after their platform, for example Jamf Mac. Mobile devices use Jamf’s device type in lowercase, for example Jamf ios, Jamf tvos, Jamf watchos, or Jamf visionos. A computer with no platform is named after its model instead, or lands under Jamf Other. A type is only created for platforms present in your inventory.
How devices match people
Each device’s user is matched from the email on its User and Location record in Jamf. Populate it with the same email the person has in Ravenna. Devices without a matching user sync unassigned.If your organization has more than one email domain, an email on an alias domain also matches the user with the same address on your primary domain.Computers sync with the Read Computers privilege and mobile devices with Read Mobile Devices, both listed in the setup guide. If the Jamf API role has only one of them, that device kind still syncs, the integration shows a warning naming the missing privilege, and the sync status reads Completed with errors. Existing assets of the skipped kind stay as they are until the privilege is granted.
Set up asset sync
1
Connect Jamf Pro
Follow the Jamf Pro setup guide. Connecting doesn’t start asset sync.
2
Turn on asset sync
In Settings > Integrations, open Jamf Pro, select Configure on the connection, add Asset under Sync scopes, and save. Select Resync to run the first sync now, or wait for the next scheduled run.
Sync scopes is in early access (
integration-sync-capability-toggle) and is on by default. If you don’t see Sync scopes under Configure, it isn’t on for your organization yet, and asset sync can’t be turned on. Contact your Ravenna representative.3
Link the synced asset types
Synced asset types start with no linked workspaces, so their assets only appear in Settings > Organization - Assets. Open each type and select the workspaces that should see it. See Asset types.
4
Map fields (optional)
To choose which Jamf Pro fields land in which asset fields, select Configure Asset Mapping on the connection. Each field Ravenna finds on a sample device is listed under External Field; pick a Ravenna Asset Field of the same type for it, or leave it Not mapped, then save. The list comes from a sample device, so it’s empty until Jamf Pro has at least one device.
Field mapping is in early access (
ASSET_FIELD_MAPPING) and is off by default. If you don’t see Configure Asset Mapping on the connection, it isn’t on for your organization yet. Until it is, each sync adds the source’s fields to the asset type automatically, named after the source fields. Once you save a mapping, only the fields you mapped keep syncing.5
Show assets on tickets
Enable the built-in Assets card to show the requester’s assets in the ticket sidebar.
Learn more about what each sync changes