Zscaler
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:
- Log in to your Leena AI workspace
- Navigate to Settings > Integrations
- Click on Add Connector
- Search for "Zscaler" and select it from the list
- Start configuring the connector
- Base URL: Enter your Zscaler API base URL (required) - Example: https://api.zscaler.com
- Username: Your Zscaler admin username (required)
- Password: Your Zscaler admin password (required)
- API Key: Your Zscaler API key (required)
- Once the connection test passes, click Save
- 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
| Name | Description | Example |
|---|---|---|
| Name | User's full name | John Doe |
| User's email address | [email protected] | |
| Groups | Groups the user belongs to | |
| Department Name | Name of the department | Product |
| Password | User's password | Leena@123 |
Optional
| Name | Description |
|---|---|
| Department ID | Unique identifier for the department |
| Department IdP ID | Identity Provider ID for the department |
| Department Comments | Additional information about the department |
| Department Deleted | Whether the department is marked as deleted |
| Comments | Additional information about this user |
| Temporary Authentication Email | Temporary 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
| Name | Description | Example |
|---|---|---|
| Name | User's full name | John Doe |
| User's email address | [email protected] | |
| Groups | Groups the user belongs to | |
| Department Name | Name of the department | Product |
| Password | User's password | Leena@123 |
Optional
| Name | Description |
|---|---|
| Department ID | Unique identifier for the department |
| Department IdP ID | Identity Provider ID for the department |
| Department Comments | Additional information about the department |
| Department Deleted | Whether the department is marked as deleted |
| Comments | Additional information about this user |
| Temporary Authentication Email | Temporary 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
| Name | Description | Example |
|---|---|---|
| Name | Filter by user name | John Doe |
| Dept | Filter by department name | IT |
| Group | Filter by group name | IT-Admins |
| Page | Specify the page offset | 51 |
| Page Size | Specify the page size | 50 |
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
| Name | Description | Example |
|---|---|---|
| User | The 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
| Name | Description | Options |
|---|---|---|
| Search | Search string to match against group name or comments | - |
| Page | Specify the page offset | - |
| Limit Search | Limit search to match only against group name | - |
| Page Size | Specify the page size | - |
| Sort By | Sort groups by specified field | - |
| Sort Order | Sort order | asc, 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
| Name | Description | Options |
|---|---|---|
| Search | Search string to match against group name or comments | - |
| Page | Specify the page offset | - |
| Limit Search | Limit search to match only against group name | - |
| Page Size | Specify the page size | - |
| Sort By | Sort groups by specified field | - |
| Sort Order | Sort order | asc, desc, ruleExecution |
Updated about 19 hours ago
