Skip to main content
Sign in

Configuring Jamf integration points

Caroline Maguire
  • March 16, 2022 13:49
  • Updated

The following document will capture the available integration points with Jamf and how to configure them.

Authentication

Global Settings

Jamf Add User API block integration

Jamf Delete Computer API block integration

Jamf Delete User API block integration

Jamf Edit Computer Extension Attribute API block integration

Jamf Edit Computer General Attribute API block integration

Jamf Edit Computer Location Attribute API block integration

Jamf Edit Computer Purchasing Attribute API block integration

Jamf Get User Details API block integration

Jamf Remote Erase Device API block integration

Jamf Remote Device Lock API block integration

Jamf Update User API block integration

Jamf SaaS User Role integration

Authentication

Before you can configure any of the available integrations with Jamf, you need to add credentials in the vault. You can use one of the following types of authentication to connect Jamf to Oomnitza:

We typically recommend creating a separate user for these integrations rather than reusing an existing named user.

Global Settings

We recommend to set a few items in the Global Settings table that will be used as defaults in all the blocks for Jamf integration rather than having to specify them every single time. These settings are:

  • Jamf.Subdomain - This is the name of your Jamf instance. In case your Jamf URL is https://mycompany.jamfcloud.com , the name of your Jamf instance would be mycompany.

Jamf Add User API block integration

This workflow block allows you to add a user from Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

It is recommended that you adhere to the following steps when using this preset:

  1. Select the API block, and then click the Advanced Mode button located in the upper right of the window.
  2. Select the Body tab.
  3. Replace the values between the curly braces with the details you want to update
    • first_name
    • full_name
    • email
    • phone_number

Jamf Delete Computer API block integration

This workflow block allows you to delete a computer in Jamf. This will help you to keep the assets in Ooomnitza and Jamf in sync, like being able to delete the asset in Jamf when it is flagged as lost or stolen in Oomnitza. This API uses the serial number as the mapping ID between Jamf and Oomnitza. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

Jamf Delete User API block integration

This workflow block allows you to delete/deactivate a user from Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

This API block can be used within SaaS User workflows to delete a user who e.g. has left your organization. It uses the SaaSUser field user_external_id to map to the userId in Jamf.

Jamf Edit Computer Extension Attribute API block integration

This workflow block allows you to update extension attributes of a computer in Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

Specifying the extension attribute will need to be done within the body tab. Please fill in Jamf field name inside the “<name></name>” tags and the corresponding Oomnitza field external_id inside the double curly brackets between “<value></value>“ tags.

Jamf Edit Computer General Attribute API block integration

This workflow block allows you to update general attributes of a computer in Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

  • General attributes within the body tab:

    • We predefined the following general attributes. Please insert into the tags with the corresponding Oomnitza field exteral_ids inside the double curly brackets. For example, <mac_address>{{mac_address}}</mac_address>.

    • The following is the list of predefined general attributes:

      • name

      • mac_address

      • alt_mac_address

      • ip_address

      • serial_number

      • barcode_1

      • barcode_2

      • asset_tag

Jamf Edit Computer Location Attribute API block integration

This workflow block allows you to update location attributes of a computer in Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

  • Location attributes within the body tab:

    • We predefined the following location attributes. Please insert into the tags with the corresponding Oomnitza field exteral_ids inside the double curly brackets. For example, <email_address>{{email}}</email_address>.

    • The following is the list of predefined general attributes:

      • username

      • real_name

      • email_address

      • position

      • phone

      • department

      • building

      • room

Jamf Edit Computer Purchasing Attribute API block integration

This workflow block allows you to update purchasing attributes of a computer in Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

  • Purchasing attributes within the body tab:

    • We predefined the following purchasing attributes. Please insert into the tags with the corresponding Oomnitza field exteral_ids inside the double curly brackets. For example, <po_number>{{po_number}}</po_number>.

    • The following is the list of predefined general attributes:

      • is_purchased

      • is_leased

      • po_number

      • vendor

      • purchase_price

      • purchasing_contract

Jamf Get User Details API block integration

This workflow block allows you to get user details from Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

It is recommended that you adhere to the following steps when using this preset:

  1. Select the API block, and then click the Advanced Mode button located in the upper right of the window.
  2. Select the Information tab.
  3. Replace the jamf_user_id tag to get the details of that user.

Jamf Remote Erase Device API block integration

This workflow block allows you to erase a device from Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

This API block can be used within SaaS User workflows to erase a device which e.g. has been lost or stolen.

Pre-req:

Jamf_id needs to be added as a custom field in the assets module

The ‘ID’ field from Jamf needs to be mapped to this custom field

Notes:

The Passcode must be a 6 character string

https://www.jamf.com/developers/apis/classic/reference/#/computercommands/createComputerCommandByCommand

Jamf Remote Device Lock API block integration

This workflow block allows you to lock a device from Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

This API block can be used within SaaS User workflows to lock a device which e.g. has been lost or stolen.

Pre-req:

Jamf_id needs to be added as a custom field in the assets module

The ‘ID’ field from Jamf needs to be mapped to this custom field

Notes:

The Passcode must be a 6 character string

https://www.jamf.com/developers/apis/classic/reference/#/computercommands/createComputerCommandByCommand

Jamf Update User API block integration

This workflow block allows you to update a user in Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button.

It is recommended that you adhere to the following steps when using this preset:

  1. Select the API block, and then click the Advanced Mode button located in the upper right of the window.
  2. Select the Information tab.
  3. Replace the jamf_user_id variable with the id of the user you wish to update.
  4. Select the Body tab.
  5. Replace the values between the curly braces with the details you want to update
    • first_name
    • full_name
    • email
    • phone_number

Jamf SaaS User Role integration

This workflow block allows you to read a user’s role from Jamf. When you select this present, you will be prompted to enter your Jamf credentials and the Jamf subdomain. The subdomain can be maintained in Global Settings or enterered maually by clicking the Set Manually button. Deactivate User - If it’s checked, the SaaS user will be deactivated in the Oomnitza system if the user was not found in your Jamf instance.

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk