Use the Oomnitza presets for Jamf assets to enrich the data captured in Oomnitza, to edit and update device attributes, and to complete actions in Jamf such as erasing, locking, and deleting Jamf devices.
Before you start
Add your Jamf credentials to Oomnitza. See Adding Jamf credentials.
Ensure you have the appropriate Jamf privileges
To create asset workflows, you must have the following Jamf privileges:
- View disk encryption recovery key
- Send computer remote lock
- Send computer erase device
- Update computers
- Update users
- Delete computers
Add your Jamf domain to Oomnitza
To save time when you create integrations and workflows, add the Jamf domain as a global variable:
Adding global variables
Save time when you create integrations and run workflows by adding connection information as global variables.
- Click Configuration > General > Global Settings.
- Click Add new variable.
- Add the key value, which is the name of the variable.
- Enter the value.
- Save your changes.
Key: Jampf.Domain
Value: The URL of your Jamf Pro instance:
https://<your_instance_name>.jamfcloud.com
Alternatively, you can enter the URL of your Jamf Pro instance when you create each workflow.
Selecting a Jamf preset to create a workflow
- Click Configuration > Workflows
- Click Add
and select Assets.
- Edit the Begin Block and add rules to trigger the workflow. For example, if actions are set to new, the workflow will run when a new asset asset record is added to Oomnitza.
- Click the Blocks tab and drag and drop the API block onto the canvas.
- Edit the API block and enter Jamf in the search field.
- Select the preset you want to use and click the arrow
.
- Select your credentials from the list.
- When prompted, enter the mandatory information.
- Click the Advanced Mode tab.
- Ensure that the Information tab and Body tab are populated with the required information to run the workflow.
- Click the Response tab. You can map the entire response by placing
{{response}}in the Response field and mapping it to a custom Oomnitza field with a data type of long text, such as API Response. Once you have the entire response, you can then parse the JSON response values to custom Oomnitza fields. - Connect the Blocks.
- Save, validate, and activate your workflow.
Jamf presets
- Jamf delete Computer
- Jamf edit computer general attribute
- Jamf edit computer extension attribute
- Jamf edit computer location attribute
- Jamf edit computer purchasing attribute
- Jamf erase device
- Jamf remote lock device
- Jamf get FileVault information for a computer
Screen capture of the API block's response tab
Jamf delete computer
Delete a computer by serial number. The computer to be deleted is referenced on the Advanced Mode > Information tab in the property{{serial_number}}.
See Jamf API Documentation: Delete computer by serial number
Jamf edit computer general attribute
Update a computer by serial number. You must specify the extension attribute on the Advanced Mode > Body tab.
Insert into the tags with the corresponding Oomnitza field exteral_ids inside the double curly brackets. For example, <mac_address>{{mac_address}}</mac_address>.
See Jamf API Documentation: Update computer by serial number
Jamf edit computer extension attribute
Update a computer's extension attributes by serial number.
You must specify the general attributes on the Advanced Mode > Body tab. Enter the Jamf field name inside the “<name></name>” tags and the corresponding Oomnitza field external_id inside the double curly brackets between the “<value></value>“ tags.
See Jamf API Documentation: Update computer by serial number
Jamf edit computer location software
Update a computer's location attributes by serial number.
Important
If you update the department attribute for a computer, ensure that you specify the name of an existing department. If you enter a department that has not been added to Jamf, an error is generated.
Specify the location attributes on the Advanced Mode > Body tab. Insert into the tags the corresponding Oomnitza field exteral_ids inside the double curly brackets. For example, <email_address>{{email}}</email_address>.
See Jamf API Documentation: Update computer by serial number
Jamf edit computer purchasing
Update a computer's purchasing attributes by serial number.
You must specify the purchasing attributes on the Advanced Mode > Body tab. Insert into the tags with the corresponding Oomnitza field exteral_ids inside the double curly brackets. For example, <po_number>{{po_number}}</po_number>.
See Jamf API Documentation: Update computer by Serial Number
Jamf erase device
Delete a device in Jamf.
You must specify the device information on the Advanced Mode > Body tab. The ID field can be mapped to a custom Jamf ID (jamf_id) field. The passcode must be a six character string
<computer_command>
<general>
<command>EraseDevice</command>
<passcode>123456</passcode>
<user_name>administrator</user_name>
</general>
<computers>
<computer>
<id>jamf_id</id>
</computer>
</computers>
</computer_command>See Jamf API Documentation: Create a new computer command using command name
Jamf remote lock device
Lock a Jamf device remotely.
You must specify the device information on the Advanced Mode > Body tab. The ID field can be mapped to a custom Jamf ID (jamf_id) field. The passcode must be a six character string
<computer_command>
<general>
<command>DeviceLock</command>
<passcode>123456</passcode>
<lock_message>sample</lock_message>
<user_name>administrator</user_name>
</general>
<computers>
<computer>
<id>jamf_id</id>
</computer>
</computers>
</computer_command>See Jamf API Documentation: Create a new computer command using command name
Jamf Get FileVault information for a computer
Retrieve the FileVault information for a specific computer.
The computer to be retrieved is referenced on the Advanced Mode > Information tab in the property{{jamf_computer_id}}.
See Jamf API Documentation: Return FileVault information for a specific computer
Comments
0 comments
Please sign in to leave a comment.