The following document will capture the available integration points with Jamf and how to configure them.
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:
- OAuth 2.0. You'll need your Jamf OAuth 2.0 authentication credentials. For further information see Adding Jamf (OAuth 2.0) credentials.
- Basic authentication. You'll need your Jamf username and password. For further information see Adding Jamf (Basic Auth) credentials.
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:
- Select the API block, and then click the Advanced Mode button located in the upper right of the window.
- Select the Body tab.
- Replace the values between the curly braces with the details you want to update
- first_name
- full_name
- 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:
- Select the API block, and then click the Advanced Mode button located in the upper right of the window.
- Select the Information tab.
- 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
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
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:
- Select the API block, and then click the Advanced Mode button located in the upper right of the window.
- Select the Information tab.
- Replace the jamf_user_id variable with the id of the user you wish to update.
- Select the Body tab.
- Replace the values between the curly braces with the details you want to update
- first_name
- full_name
- 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.
Comments
0 comments
Please sign in to leave a comment.