About Jamf Pro

Jamf Pro is a mobile-device-management (MDM) platform used to deploy, configure and secure macOS, iOS, iPadOS and tvOS devices. Connecting Jamf to Serval lets your IT team trigger remote commands, pull inventory or enforce compliance policies directly from chat.

What the Jamf integration enables

CapabilityDescription
Access ManagementCreate, update, and manage users and their permissions
Automation workflowsStreamline device provisioning and management
Anything defined in the Jamf API can be accessed through Serval.

Jamf configuration (in Jamf Pro)

1. Create or select an API role

  • Log in at <yourdomain>.jamfcloud.com and navigate to the settings. From there, search for “API roles and clients”
Image(46) Pn
  • From the API Roles tab you may now click on the + New button in the top right to begin creating a new API Role. If you already have a role that you wish to use with Serval, you may skip the rest of this section.
Image(47) Pn
  • Create the API Role by choosing a name and selecting the privileges you wish Serval to have and hit Save.
Image(48) Pn

2. Create an API Client

  • From the same settings page, navigate to the API Clients tab and click the + New button once again.
Image(49) Pn
  • From here, begin filling out the details: For the name, we recommend something like Serval Integration. Make sure to include the proper role(s) and set a custom Access token lifetime if you wish to do so. Confirm that the API client is enabled and then hit save.
Image(50) Pn
  • With the client created, next you will need to hit the Generate client secret button to generate the client credentials. Be sure to keep the client ID and the client secret on hand for the next section. Image(51) Pn

3. Configure the integration in Serval

  • In Serval, navigate to Applications and then the Available tab. Find the Jamf integration and press Connect.
Image Pn
  • The Jamf Instance ID should be the subdomain of your jamfcloud URL. For example, if your jamfcloud URL is serval.jamfcloud.com, you should enter serval here.
  • Copy over the client ID and client secret from the previous section.
  • Leave the scopes blank and hit Save. That’s it! Jamf should now be connected.

Serval Configuration

  1. In Serval go to Apps → Available → Jamf → Connect.
  2. Outlined in step 3.3, enter your Jamf Cloud sub-domain, Client ID and Client Secret from the API Client you generated above.
  3. Click Save.
Serval will now use the Jamf OAuth token it generates to run your workflows. Rotate the client secret anytime—just update it in Serval by reconnecting the app.