Creating workflows for Jamf users

Let Oomnitza be your single source of truth!

You'll get visibility of your users as data from Jamf is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Jamf in minutes

You'll get visibility of your Jamf users by creating configurable workflows to automate tasks such as:

• • Pulling a list of users' from Jamf into Oomnitza
  • Tracking users' for license utilization and role usage from the Oomnitza SaaS module and;
  • Onboarding and offboarding users.

Before you start

Adding your Jamf Subdomain as a global variable

Creating workflows

Create user workflows

Create SaaS user workflows

Before you start

Jamf credentials

For details on how to Add your Jamf credentials to Oomnitza, refer to Adding Jamf credentials.

Privileges 

In order to run user workflows you'll also need Read, Create, Update, and Delete User permissions.

Jamf domain

To save you time when creating multiple integrations and workflows, you can follow these steps to add the Jamf domain as a global variable in Oomnitza:

1. Follow the steps in Adding global settings.
2. In the Key field, input Jamf.Domain
3. In the Value field, enter the full URL of your Jamf Pro instance, such as https://<instance_name>.jamfcloud.com

Alternatively, you can manually enter the full URL of your Jamf Pro instance when creating the workflows.

Creating workflows

Create user workflows

To create a user workflow, you must complete these steps:  

1. Click Configuration > Workflows 
2. Click Add (+).
3. Use search to find and select the Users object.
4. Drag and drop the API block onto the Sandbox.
5. Click Edit on the API block and enter Jamf in the search field. 
6. Select a preset:
   • Jamf Add User
   • Jamf Delete User
   • Jamf Get User Details
   • Jamf Update User
7. Enter the credentials you created in Adding your Jamf credentials to Oomnitza.
8. Your Subdomain is derived from the global variable you created in Adding your Jamf Subdomain as a global variable.
9. Select Advanced Mode.
10. Ensure that the Information tab and Body tab are populated with the required information to run the workflow. 
11. Select the Response tab. You can access the complete response by inserting {{response}} in the Response field, and then selecting the Oomnitza field or variable that you want to map to. See Mapping positive and negative responses.
12. Click Save and connect the blocks
13. Edit the Begin block.
    1. From the Actions dropdown, select when your workflow is triggered. You can trigger workflows to run when a new record is added and when a record is edited or archived. You can also configure the schedule to run at a specific time by selecting Schedule.
    2. Optional. In the Rule criteria section, you can add a rule to trigger the workflow. For example, the Status is set to Active, or the Email address is [e-mail].
14. Validate the workflow and Activate it so that the workflow is live in your system.

Using the Jamf Add User preset

The Jamf Add User preset enables you to add a Jamf user.

The new user information should be supplied in the Advanced Mode > Body tab. Replace the values between the curly braces with the details you want to update

<user>
<name>{{first_name}}</name>
<full_name>{{full_name}}</full_name>
<email>{{email}}</email>
<email_address>{{email}}</email_address>
<phone_number>{{phone_number}}</phone_number>
</user>

For further information, refer to the Jamf API Documentation: Creates a new user.

Using the Jamf Delete user preset

The Jamf Delete User preset enables you to delete a Jamf user, by User ID. 

The user to be deleted is referenced in the Advanced Mode > Information tab in the property{{jamf_user_id}}.

For further information, refer to the Jamf API Documentation: Delete user by ID

Using the Jamf Get User Details preset

The Jamf Get User Details preset enables you to get a Jamf user, by User ID.

The user to be retrieved is referenced in the Advanced Mode > Information tab in the property{{jamf_user_id}}.

For further information, refer to the Jamf API Documentation: Find users by ID

Using the Jamf Update User 

The Jamf Update User preset enables you to update a Jamf user, by User ID.

The user to be updated is referenced in the Advanced Mode > Information tab in the property{{jamf_user_id}}.

The new user information should be supplied in the Advanced Mode > Body tab. Replace the values between the curly braces with the details you want to update

<user>
<name>{{first_name}}</name>
<full_name>{{full_name}}</full_name>
<email>{{email}}</email>
<email_address>{{email}}</email_address>
<phone_number>{{phone_number}}</phone_number>
</user>

For further information, refer to the Jamf API Documentation: Update users by ID.

Reference articles for workflows

• Mapping positive and negative responses
• Troubleshooting workflows 
• Using the API block

Using the Saas User Role presets

Follow these steps to configure the SaaS User Role block for Jamf. This configuration will enable you to capture the Jamf role or privilege set value, which can be one of the following: Administrator, Auditor, Enrollment Only, or Custom. If the role is empty, it should default to 'User'.

Prerequisites

Before you create a SaaS user workflow, you should have already run your extended user integration and selected User plus SaaS User to populate the software entry in the Software > SaaS menu.

To create a Saas User workflow using the Jamf User Role preset, complete the following steps:

1. Click Configuration > Workflows 
2. Click Add (+) and select Software SaaS Users from the list.
3. Enter the name and a description of the workflow. 
4. Edit the Begin block by adding the rules that will trigger the workflow. For further information see SaaS User Roles.
5. Click the Blocks tab, and drag and drop the SaaS User Role retrieval block onto the canvas.
6. Click the Edit icon.
7. Enter Jamf in the search field and choose the Jamf User Role block.
8. Click the right arrow >.
9. Enter your Credentials.
10. In the Domain field, enter the full URL of your Jamf Pro instance, such as https://<instance_name>.jamfcloud.com
11. Select the Deactivate User checkbox to deactivate the SaaS user in SaaS > Jamf > Users if they are not found in your Jamf instance.
12. Click SAVE.
13. Connect the blocks.
14. Save, validate, and activate your workflow.

To view active Jamf users in the SaaS Users UI, complete the following steps:

1. Click Software from the menu.
2. Select the Saas tab, and select your software entry for Jamf.
3. Click Users in the side pane. 
4. The Role column will be populated with user information to confirm that this user has been found in your Jamf SaaS.

Reference articles for creating workflows

• Creating SaaS user workflows.
• Offboarding SaaS users.