Jamf for Jira

Apple device management in Jira – a Jamf Pro integration for Jira

Documentation

This is the documentation for the Atlassian Jira app Jamf for Jira.

Installation

Head to the settings within Jira. Note that administrator privileges are required to access the settings.

In the menu on the left side, navigate to “Find new apps” under the “apps” category. Search for “Jamf”, wait until the entry “Jamf for Jira” is shown and proceed to “Install” the app.

Setting up your connection to Jamf

Create a Jamf Pro User

In your Jamf Pro instance, navigate to “Jamf Pro User Accounts & Groups” within the Settings page.

Create a new standard user with full access enabled and the “Auditor” privilege set. Optional fields like “Full Name” or “Email Address” do not have to be filled. Take note of the password used.

Configure Jamf for Jira

Within Jira, proceed to configure the app either by clicking on the “Configure” button in the app listing or navigating to the Jamf configuration in the Jira app setting menu.

Configure the URL to your Jamf instance and the name and password of the dedicated user you created. Click on “Check connection and Save”. The app will check if it can connect to your Jamf instance and proceed to sync all assets with Jira.

Assets will be synced from Jamf to Jira every hour. You can also start a sync manually by clicking on the “Run manually” button.

Using assets in Jira issues

With our app you can link your Jamf assets to Jira issues. To make the asset field visible in certain Jira issues you need to add an asset (custom) field. Setting up this field varies between next-gen and classic.

Setting up asset field in next-gen service desk projects

  1. Go to Project > Project settings > Request types
  2. Click Show more > Assets in the Create a field section
  3. Enter display name (e.g. Linked assets)
  4. Save changes

 

Setting up asset field in classic projects

By default, a “Linked assets” custom field is created that can be added to any screens where assets are being used.

  1. Go to Jira settings > Issues > Custom fields
  2. Search for “Linked assets”
  3. Click on the  three-dots-menu
  4. Associate the field “Linked assets” to the desired screen(s)

Note: 

  • Sometimes it happens that the custom field was not created automatically. If you can’t find the custom field “Linked assets”, you can create it on your own following these steps:
  1. Got to Jira > Jira settings > Issues > Custom fields
  2. Click Create custom field > Advanced > Assets > Next
  3. Give the custom field an arbitrary name, e.g. “Linked assets”
  4. Click Create
  • You can also add multiple asset custom fields and limit which Jamf asset categories are used within them.
    You can limit the categories by following these steps:
  1. Got to Jira > Jira settings > Issues > Custom fields
  2. Select or create your asset custom field, e.g. “Linked assets”
  3. Click on the three-dots-menu>Contexts and default values
  4. Click Edit Filters 

Support

If you encounter any issues, feel free to contact our support team. We usually reply within one business day.

Thanks for using Jamf for Jira!