Overview

The Zscaler connector enables your Leena AI Agents to integrate with your organization's Zscaler platform, facilitating automated security operations, user management, and policy enforcement workflows.

Zscaler is a cloud security platform that provides secure access to applications and data. The Zscaler connector allows Leena AI to automate user management, retrieve security information, and interact with Zscaler's security services seamlessly.

API Details

Leena AI integrates with Zscaler via REST APIs.

Documentation link:

Setup

The Zscaler connector uses API Key authentication.

Prerequisites

Before setting up the Zscaler connector, ensure you have:

  • Admin access to your Zscaler account
  • Zscaler API credentials (username, password, and API key)
  • Access to your Leena AI workspace with connector management permissions

Setting up the Zscaler Connector


Get credentials

The Zscaler connector requires API credentials from your Zscaler account. The API Key must be obfuscated according to Zscaler's security requirements. All API calls require a valid JSESSIONID cookie in the request header.

Add connection

Here is how to add a connection on Leena AI:

  1. Log in to your Leena AI workspace
  2. Navigate to Settings > Integrations
  3. Click on Add Connector
  4. Search for "Zscaler" and select it from the list
  5. Start configuring the connector
    1. Base URL: Enter your Zscaler API base URL (required) - Example: https://api.zscaler.com
    2. Username: Your Zscaler admin username (required)
    3. Password: Your Zscaler admin password (required)
    4. API Key: Your Zscaler API key (required)
  6. Once the connection test passes, click Save
  7. The Zscaler connector is now ready to use in your workflows

Actions

The following actions are supported for the Zscaler connector:

Create User

Creates a new user in the Zscaler system. The Agent can leverage this action to create a new user under Zscaler, as a part of automating IT on-boarding tasks.


Input Parameters

Here are the input parameters required to set up this action:

Mandatory

NameDescriptionExample
NameUser's full nameJohn Doe
EmailUser's email address[email protected]
GroupsGroups the user belongs to
Department NameName of the departmentProduct
PasswordUser's passwordLeena@123

Optional

NameDescription
Department IDUnique identifier for the department
Department IdP IDIdentity Provider ID for the department
Department CommentsAdditional information about the department
Department DeletedWhether the department is marked as deleted
CommentsAdditional information about this user
Temporary Authentication EmailTemporary email address for authentication purposes

Update User

Updates the user information under Zscaler. This action is leveraged by Agent to troubleshoot access related issues which are dependent on Zscaler. This action is primarily used to update the mapped groups against a user.


Input Parameters

Here are the input parameters required to set up this action:

Mandatory

NameDescriptionExample
NameUser's full nameJohn Doe
EmailUser's email address[email protected]
GroupsGroups the user belongs to
Department NameName of the departmentProduct
PasswordUser's passwordLeena@123

Optional

NameDescription
Department IDUnique identifier for the department
Department IdP IDIdentity Provider ID for the department
Department CommentsAdditional information about the department
Department DeletedWhether the department is marked as deleted
CommentsAdditional information about this user
Temporary Authentication EmailTemporary email address for authentication purposes

Get Users

Returns a list of users based on specified filters.


Input Parameters

Here are the input parameters required to set up this action:

Mandatory

None

Optional

NameDescriptionExample
NameFilter by user nameJohn Doe
DeptFilter by department nameIT
GroupFilter by group nameIT-Admins
PageSpecify the page offset51
Page SizeSpecify the page size50

Get Individual User

Retrieves information about a specific user by ID.


Input Parameters

Here are the input parameters required to set up this action:

Mandatory

NameDescriptionExample
UserThe user to fetch (select from dropdown)John Doe

Optional

None


Get List of Groups

Retrieves a list of groups based on specified filters. This is a supporting action for Agent to fetch all the groups that exist within the instance.


Input Parameters

Here are the input parameters required to set up this action:

Mandatory

None

Optional

NameDescriptionOptions
SearchSearch string to match against group name or comments-
PageSpecify the page offset-
Limit SearchLimit search to match only against group name-
Page SizeSpecify the page size-
Sort BySort groups by specified field-
Sort OrderSort orderasc, desc, ruleExecutio

Get List of Departments

Retrieves a list of departments based on specified filters.


Input Parameters

Here are the input parameters required to set up this action:

Mandatory

None

Optional

NameDescriptionOptions
SearchSearch string to match against group name or comments-
PageSpecify the page offset-
Limit SearchLimit search to match only against group name-
Page SizeSpecify the page size-
Sort BySort groups by specified field-
Sort OrderSort orderasc, desc, ruleExecution