Zscaler Internet Access CLI
This is a CLI for Zscaler Internet Access. This cli (or library package) is designed to support the Zscaler Internet Access (ZIA) API and SD-WAN API (aka "Partner API"). All API referecnes can be found here [LINK]. PLEASE READ THE DOCUMENTATION BEFORE CONTACTING ZSCALER
This CLI has been developed mainly using Python 3.8.5 on Ubuntu 20.04 LTS (Focal Fossa).
NOTE: This repository will experience frequent updates. To minimize breakage, public method names will not change. If you run into any defects, please open issues [HERE.]
Quick Start
-
If you have not verified your credentials, we suggest starting [HERE], unless you are already familar with this API.
-
Set profile
$ mkdir ~/.zscaler
$ cat > ~/.zscaler/profile.yaml <<EOF
default:
url: https://admin.<ZIA-CLOUD>.net
username: <ZIA-ADMIN-USER-ID>
password: <ZIA-ADMIN-USER-PASSWORD>
apikey: <ZIA-API-KEY>
partner:
url: https://admin.<ZIA-CLOUD>.net
username: <ZIA-PARTNER-ADMIN-USER-ID>
password: <ZIA-PARTNER-ADMIN-USER-PASSWORD>
apikey: <PARTNER-API-KEY>
EOF
- Install package
$ pip install zia
- Check out examples
$ zia --help
$ zia policies --help
$ zia policies list
[
{
"id": 463593,
"accessControl": "READ_WRITE",
"name": "URL Filtering Rule-1",
"order": 8,
"protocols": [
"ANY_RULE"
],
"urlCategories": [
"OTHER_ADULT_MATERIAL",
"ADULT_THEMES",
"LINGERIE_BIKINI",
"NUDITY",
"PORNOGRAPHY",
"SEXUALITY",
"ADULT_SEX_EDUCATION",
"K_12_SEX_EDUCATION",
"OTHER_DRUGS",
"OTHER_ILLEGAL_OR_QUESTIONABLE",
"COPYRIGHT_INFRINGEMENT",
"COMPUTER_HACKING",
"QUESTIONABLE",
"PROFANITY",
"MATURE_HUMOR",
"ANONYMIZER"
],
...
API Support
SD-WAN (Partner) API
- VPN Credentials
- Locations
- Activate
Licensing
This work is released under the MIT license, forked from eparra's zscaler-python-sdk v0.5. A copy of the license is provided in the LICENSE file.
Reporting Issues
If you have bugs or other issues specifically pertaining to this library, file them here.
