Zscaler User Flow Connector ¶
Introduction ¶
Zscaler User Flow Davinci connector can be used to create and manage user details. This connector allows you to:
- Create User
- Update User
- Get User Details
- Delete User
- Get Group by ID
- Get All Groups
- Get Department by ID
- Get All Departments
Setup ¶
Resources ¶
For information and setup help, see the following sections of the Zscaler documentation:
Requirements ¶
To use the connector, you'll need:
- ZIA Admin Portal Access
Setting up the connector ¶
In Davinci, add a Zscaler User Flow connection via the "Connections" tab in your Davinci Environment. For help, see Adding a connection.
Connector Settings ¶
Once you've added the Zscaler User Flow connection click on it's logo, or click the "···" button and edit. You will see the connector's details pop-up. On the GENERAL tab, enter in your Zscaler admin account details below:
- Zscaler Domain url
- Zscaler Base path
- API Key
- Admin Username
- Admin Password
and click apply. This ensures that whenever you use this connector you will not have to reenter this information and generate the cookie to be used in flow to authenticate and create API sessions.
Using the connector in a flow ¶
Create User Flow ¶
To create user add a Zscaler User Flow Connector in the flow studio. Then choose the Create User - Zscaler capability. Provide the input parameters to be updated from previous nodes in the flow (HTML form) and submit the details.
Update User Flow ¶
To update user attributes saved add a Zscaler User Flow Connector in the flow studio. Then choose the Update User - Zscaler capability. Provide the input parameters to be updated from previous nodes in the flow (HTML form) and submit the details.
Delete User Flow ¶
To inactivate the exsting user add a Zscaler User Flow Connector in the flow studio. Then choose the Update User - Zscaler capability. Provide the username parameters from previous nodes in the flow (HTML form) to delete the existing user.
Get User Flow ¶
To get the lists the existing user details based on search parameter provided add a Zscaler User Flow Connector in the flow studio. Then choose the Get User capability. Provide the parameters from previous nodes in the flow (HTML form) to retrieve the list of users based on filter criteria submitted.
Get All Groups ¶
To get list of Groups add a Zscaler User Flow Connector in the flow studio. Then choose the Get All Groups - Zscaler capability. Provide the parameters from previous nodes in the flow (HTML form) to retrieve the list of Groups available based on search query submitted.
Get Group By ID ¶
To get groups by user ID add a Zscaler User Flow Connector in the flow studio. Then choose the Get Group by ID - Zscaler capability. Provide the parameters from previous nodes in the flow (HTML form) to retrieve the Group details based on Group ID.
Get All Departments ¶
To get list of Departments add a Zscaler User Flow Connector in the flow studio. Then choose the Get All Departments - Zscaler capability. Provide the parameters from previous nodes in the flow (HTML form) to retrieve the list of Departments available based on search query submitted.
Get Department by ID ¶
To get Department by user ID add a Zscaler User Flow Connector in the flow studio. Then choose the Get Department by ID - Zscaler capability. Provide the parameters from previous nodes in the flow (HTML form) to retrieve the Department details based on Department ID.
Capabilities ¶
Create User (createUser) ¶
Adds a new user
User Name textField
required
¶
User Name
Email textField
¶
User email consists of a user name and domain name
Groups ID textField
required
¶
Unique identfier for the group
Groups Name textField
required
¶
Group name
Groups IDPID textField
¶
Unique identfier for the identity provider
Groups Comments textField
¶
Additional information about the group
Department ID textField
required
¶
Department ID
Department Name textField
required
¶
Department name
Department IDPID textField
¶
Identity provider (IdP) ID
Department Comments textField
¶
Additional information about this department
Department Deleted toggleSwitch
¶
default: false
Comments textField
¶
Additional information about this user
Temporary Authentication Email textField
¶
If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
User Password textField
required
¶
User password. Applicable only when authentication type is Hosted DB. Password strength must follow what is defined in the auth settings
adminUser toggleSwitch
¶
default: false
type dropDown
¶
type
- SUPERADMIN
- ADMIN
- AUDITOR
- GUEST
- REPORT_USER
- UNAUTH_TRAFFIC_DEFAULT
Update User (updateUser) ¶
Updates the user information for the specified ID
userID textField
required
¶
userID
User Name textField
required
¶
User Name
Email textField
¶
User email consists of a user name and domain name
Groups ID textField
required
¶
Unique identfier for the group
Groups Name textField
required
¶
Group name
Groups IDPID textField
¶
Unique identfier for the identity provider
Groups Comments textField
¶
Additional information about the group
Department ID textField
required
¶
Department ID
Department Name textField
required
¶
Department name
Department IDPID textField
¶
Identity provider (IdP) ID
Department Comments textField
¶
Additional information about this department
Department Deleted toggleSwitch
¶
default: false
Comments textField
¶
Additional information about this user
Temporary Authentication Email textField
¶
If you enabled one-time tokens or links, enter the email address to which the Zscaler service sends the tokens or links. If this is empty, the service will send the email to the User email.
User Password textField
required
¶
User password. Applicable only when authentication type is Hosted DB. Password strength must follow what is defined in the auth settings
adminUser toggleSwitch
¶
default: false
type dropDown
¶
type
- SUPERADMIN
- ADMIN
- AUDITOR
- GUEST
- REPORT_USER
- UNAUTH_TRAFFIC_DEFAULT
Get User (getUser) ¶
Gets a list of all users and allows user filtering by name, department, or group
User Name textField
required
¶
User Name
Groups Name textField
required
¶
Group name
Department Name textField
required
¶
Department name
Page textField
¶
Specifies the page offset
Page Size textField
¶
Specifies the page size
Delete User (deleteUser) ¶
Delete User
userID textField
required
¶
userID
Get All Department (getAllDepartments) ¶
Gets a list of departments
Page textField
¶
Specifies the page offset
Page Size textField
¶
Specifies the page size
Search textField
¶
The search string used to match against a name or comments
Limit Search textField
¶
Limits the search to match against the department name only
Get Department By ID (getDepartmentByID) ¶
Gets the department for the specified ID
Department ID textField
required
¶
Department ID
Get All groups (getAllGroups) ¶
Gets a list of groups
Search textField
¶
The search string used to match against a name or comments
Page textField
¶
Specifies the page offset
Page Size textField
¶
Specifies the page size
Get Groups By ID (getGroupByID) ¶
Gets the group for the specified ID
Groups ID textField
required
¶
Unique identfier for the group
Limitations ¶
- Use of Zscaler User Flow Connector is limited by the availability of Zscaler API and account access.