Jamf Integrations

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

Authentication

Global Settings

Jamf Delete Computer API block integration

Jamf Edit Computer Extension Attribute API block integration

Jamf Edit Computer Purchasing Attribute API block integration

Jamf Edit Computer Location Attribute API block integration

Jamf Edit Computer General Attribute API block integration

Jamf Delete User API block integration

Jamf SaaS User Role integration

Jamf Remote Device Lock API block integration

Jamf Remote Erase Device API block integration

 

Authentication

Before you can configure any of the available integrations with Jamf, you need to add credentials in the vault. Jamf requires a Basic Auth based authentication with the username and password.  

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 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. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • Select the credentials that you created for Jamf

 

Jamf Edit Computer Extension Attribute API block integration

This workflow block allows you to update extension attributes of a computer in Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • Select the credentials that you created for Jamf
  • 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 Purchasing Attribute API block integration

This workflow block allows you to update purchasing attributes of a computer in Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • Select the credentials that you created for Jamf
  • 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 Edit Computer Location Attribute API block integration

This workflow block allows you to update location attributes of a computer in Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • Select the credentials that you created for Jamf
  • 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 General Attribute API block integration

This workflow block allows you to update general attributes of a computer in Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • Select the credentials that you created for Jamf
  • 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 Delete User API block integration

This workflow block allows you to delete/deactivate a user from Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Select the Credentials that you created for Jamf
  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • 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 SaaS User Role integration

This workflow block allows you to read a user’s role from Jamf. In order to enable this, you need to select this from the list of available SaaS User integrations and then provide the following parameters in configuration:

  • Select the Credentials that you created for Jamf
  • Subdomain - as defined in global settings
  • 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.

Jamf Remote Device Lock API block integration

This workflow block allows you to lock a device from Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Select the Credentials that you created for Jamf
  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • 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 Remote Erase Device API block integration

This workflow block allows you to erase a device from Jamf. In order to enable this, you need to select this Preset from the list of available API block integrations and then provide the following parameters in configuration:

  • Select the Credentials that you created for Jamf
  • Subdomain - can be maintained in Global Settings or overwritten locally by replacing [[Global_settings:Jamf.Subdomain:Shorttext]] in the URL field of the API block
  • 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

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk