https://github.com/sergitopereira/zscaler_api_talkers
Zscaler python SDK for ZIA, ZPA, ZCC
https://github.com/sergitopereira/zscaler_api_talkers
zia zpa zscaler zscalersdk
Last synced: 5 months ago
JSON representation
Zscaler python SDK for ZIA, ZPA, ZCC
- Host: GitHub
- URL: https://github.com/sergitopereira/zscaler_api_talkers
- Owner: sergitopereira
- License: mit
- Created: 2022-04-21T19:52:09.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-08-14T03:34:49.000Z (10 months ago)
- Last Synced: 2025-11-29T10:24:06.904Z (6 months ago)
- Topics: zia, zpa, zscaler, zscalersdk
- Language: Python
- Homepage:
- Size: 118 KB
- Stars: 19
- Watchers: 5
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
# Unofficial Zscaler API talkers
## API Talkers
### ZIA API Talker
Python classes to leverage [Zscaler Internet Access API](https://help.zscaler.com/zia/api)
### ZPA API Talker
Python classes to leverage [Zscaler Private Access API](https://help.zscaler.com/zpa/api-reference)
### Client Connector API Talker
A Python class to leverage Zscaler Client Connector API. (Currently in Beta status.)
The Client Connector API talker is accessed via the Class object named: **ClientConnectorTalker**
### ZDX API Talker
A Python class to leverage Zscaler Digital Experience API. (Currently in development.)
This class interacts with ZDX via the URLs presented in the Portal (aka, the ZDX configuration website). It is
named: **ZdxPortalTalker**
### Cloud and Branch Connector API Talker
A Python class to leverage Cloud and Branch Connector API. (Currently in development.)
This class interacts with the Cloud and Branch Connector Portal. The class object is named **CloudConnectorTalker**
(https://help.zscaler.com/cloud-branch-connector/about-zscaler-cloud-branch-connector-api)
## Installation
### Option 1: Run in a Python Virtual Environment
1. Create a virtual Environment: `python3 -m venv .zs_api_talkers`
1. Activate virtual environment:
- Linux: `source .zs_api_talkers/bin/activate`
- Windows: `.\.zs_api_talkers\Scripts\activate`
1. Install Zscaler API talkers: `pip install zscaler-api-talkers`
### Option 2: Run within a Docker Container
We provide two methods to build a Docker container. Either using the code hosted on GitHub or the code published to PyPi.
#### PyPi Method
1. Download Dockerfile
- Linux: `curl -O https://raw.githubusercontent.com/sergitopereira/zscaler_api_talkers/sergiodevelop/Dockerfile`
- Windows: `wget -O Dockerfile https://raw.githubusercontent.com/sergitopereira/zscaler_api_talkers/sergiodevelop/Dockerfile`
1. Build Image and Run Container
1. `docker build -t zscaler_api_talkers .`
1. `docker run -it zscaler_api_talkers bash`
1. Usage (program is in /zscaler_api_talkers/)
- `cd zscaler_api_talkers`
#### GitHub Method
1. Download Dockerfile
- Linux: `curl -O https://raw.githubusercontent.com/sergitopereira/zscaler_api_talkers/sergiodevelop/git_version.Dockerfile`
- Windows: `wget -O Dockerfile https://raw.githubusercontent.com/sergitopereira/zscaler_api_talkers/sergiodevelop/git_version.Dockerfile`
1. Build Image and Run Container
1. `docker build -f git_version.Dockerfile -t zscaler_api_talkers .`
1. `docker run -it zscaler_api_talkers bash`
1. Usage (program is in /zscaler_api_talkers/)
- `cd zscaler_api_talkers`
## Zscaler Secure Internet and SaaS Access SDK
### Usage ZiaTalker
``` python
from zscaler_api_talkers import ZiaTalker
zia=ZiaTalker('')
zia.authenticate(api_key='API_KEY', username='USERNAME', password='PASSWORD')
zia.list_url_categories()
zia.list_users()
# To view all methods available
print(dir(zia))
```
### Usage ZiaTalker with OneAPI
``` python
from zscaler_api_talkers import ZiaTalker
zia=ZiaTalker('')
zia.authenticate_one_api(client_id='CLIENT_ID', client_secret='CLIENT_SECRET', vanity='https://vanity.zslogin.net')
zia.list_url_categories()
zia.list_users()
# To view all methods available
print(dir(zia))
```
### Usage ZiaTalker with OAUTH2.0
``` python
from zscaler_api_talkers import ZiaTalker
zia=ZiaTalker('', '')
zia.list_url_categories()
zia.list_users()
# To view all methods available
print(dir(a))
```
## Zscaler Secure Private Access SDK
### Usage ZpaTalker
``` python
from zscaler_api_talkers import ZpaTalker
a=ZpaTalker('customerID')
a.authenticate(client_id='clientID',client_secret='clientSecret')
# To view all methods available
print(dir(a))
```
### Usage ZpaTalker with OneAPI
``` python
from zscaler_api_talkers import ZpaTalker
a=ZpaTalker('customerID')
a.authenticate_one_api(client_id='clientID',client_secret='clientSecret', vanity=https://vanity.zslogin.net)
# To view all methods available
print(dir(a))
```
## Zscaler Client Connector SDK
### Usage ClientConnectorTalker
``` python
from zscaler_api_talkers import ClientConnectorTalker
a=ClientConnectorTalker('')
a.authenticate(clientid='clientID',secretkey='clientSecret')
a.list_devices('companyID')
a.list_OTP('companyID','user device id')
# To view all methods available
print(dir(a))
```
## Zscaler Cloud & Branch Connector SDK
### Usage CloudConnectorTalker
```python
from zscaler_api_talkers import CloudConnectorTalker
bac=CloudConnectorTalker(cloud_name='', api_key='API_KEY', username='USERNAME', password='PASSWORD')
bac.list_cloud_branch_connector_groups()
bac.delete_cloud_branch_connector_vm(group_id='GROUPID', vm_id='VMID')
print(dir(bac))
```
## Usage examples
- https://github.com/sergitopereira/zscaler_api_talkers#usage-example
- https://github.com/sergitopereira/zscaler_api_talkers/blob/main/example.py
## Bugs and enhancements
Feel free to open an issues using [GitHub Issues](https://github.com/sergitopereira/zscaler_api_talkers)
## Author
Sergio Pereira: Zscaler Professional Services