Creating workflows for Zscaler users

Let Oomnitza be your single source of truth!

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

Connect Oomnitza and Zscaler in minutes

Get the information and insights that you need by creating configurable workflows for:

• Onboarding and offboarding users
• Activating and adjusting users as part of a user change or user onboarding workflow

Before you start

Before you can create workflows with Oomnitza, you need to have added your Zscaler credentials to Oomnitza and set your subdomain as a global variable. We recommend that you also create an extended integration for Zscaler users. You can use the information retrieved in this integration to trigger workflows.

Related Links

Adding your Zscaler subdomain as a global variable

Adding your Zscaler credentials to Oomnitza

Creating an extended integration for Zscaler users

Create user workflows

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

1. Click Configuration > Workflows 
2. Click Add (+) and select People from the list.
3. Drag and drop the API block onto the Sandbox.
4. Click Edit on the API block and enter Zscaler in the search field. 
5. Select a preset:
   • Zscaler Create User
   • Zscaler Update User
   • Zscaler Delete User
   • Zscaler Activate Changes
6. To choose a preset, click the forward arrow (>).
7. Select the credentials that you created earlier.
8. Enter any mandatory information when prompted.
9. Select Advanced Mode.
10. Select the Response tab. You can map the entire response by placing {{response}} in the Response field and mapping it to a custom long text Oomnitza field, such as API Response. Once you have the entire response, you can then parse the JSON response values to custom Oomnitza fields, as per the example below.
11. Connect the Blocks. 
12. Save, validate, and activate your workflow.

Using the Create User preset

The Create User preset creates a Zscaler user.

You can also supply values using Jinja syntax, such as {{department_id}} or {{group_id}}. These values can be retrieved beforehand by running the user integration.

Note
 A user can belong to multiple groups, but can only belong to one department.

Next steps

After creating a user, remember to run the Activate Changes preset to apply the changes.

Zscaler ZIA User Management - Create User

Using the Update User preset

The Update User preset updates a specified user. You need to supply the ID of the user that you want to update. This can be entered manually or in the form of Jinja syntax, such as {{zscaler_user_id}}.

In addition to the user ID, you can also supply other values using Jinja syntax, such as {{department_id}} or {{group_id}}. These values can be retrieved beforehand by running the user integration.

Note
You cannot update the email address.

Next steps

After updating a user, remember to run the Activate Changes preset to apply the changes.

Zscaler ZIA User Management - Update User

Using the Delete User preset

The Delete User preset deletes a specified user from Zscaler. You need to supply the ID of the user that you want to delete. This can be entered manually or in the form of Jinja syntax, such as {{zscaler_user_id}}.

Next steps

After deleting a user, remember to run the Activate Changes preset to apply the changes.

Zscaler ZIA User Management - Delete User

Using the Activate Changes preset

Important
After making any changes, such as creating, updating, or deleting a user, remember to run the activate user preset to apply or enforce the changes.

The Activate Changes preset activates the saved confirmation changes. You do not need to supply any details to run this workflow.

Zscaler ZIA User Management - Activate User