Quite a few big additions in 1.6.0.

Zscaler Connector Portal

pyZscaler now supports the Zscaler Connector Portal so this will be very handy for those of you working with Cloud and Branch Connector. Zscaler hasn't published a great deal of endpoints to date for ZCON so hopefully we see more coming in the future.

ZIA Cloud Apps API

Support for the ZIA Cloud Apps API endpoints has been added. While they (Zscaler) refer to this as 'Reports' under their API reference (probably because it originally housed only the Shadow IT Report generation endpoints), I think it makes more sense to call this collection Cloud Apps. There is also the ability to list custom tags, cloud apps and also bulk update the sanction/unsanctioned status (!). I know a lot of people have been asking for this one.

Python 3.12

Python 3.12 is now supported and I will be doing the majority of development work using this latest version. pyZscaler will always support all versions of Python that are under support.

What's Changed

• Adds support for the Zscaler Connector portal (ZCON) #216
• Adds support for ZIA Cloud Apps API Endpoints #213
• Adds support for additional ZIA Traffic Forwarding API Endpoints #214
• Adds support for ZIA AppTotal API Endpoints #215
• Adds support for Python 3.12
• Fix cloud selection being ignored by @jxg81 in #227
• update tests to specify cloud name by @jxg81 in #228

New Contributors

• @jxg81 made their first contribution in #227

What's next?

• Time to hit the issues list and close out all of the issues
• Trawl the product changelogs for any new API endpoints or changes to the API that we may need to incorporate (please raise an Issue on Github if there is something you need urgently)

Full Changelog: 1.5.0...1.6.0

Thanks for everyone's patience on this release, this has taken a fair bit of work to get out as I really wanted to focus on ZDX support and some of the recent bugs posted.

Note

I had some issues with my ZDX tenant that prevented me from fully testing pagination so if you hit any strange behaviour then please log an Issue and I'll look into it.

What's Changed

• Adds support for all ZDX API endpoints
• Fixes #198 - Can not updated Sub-Location options
• Fixes #200 Add location by sending more Model attributes as a body json/dict
• docs: fix zpa.session example code by @alvarogonzalez-packlink in #185
• Fixes #177 Dropped support for Python 3.7 due to EoL in June 2023.
• Updated developer dependencies to latest versions
• Removed deprecated zpa.connector_groups module, which was superseded by zpa.connectors last year
• Updated Sphinx document generation config

New Contributors

• @alvarogonzalez-packlink made their first contribution in #185

Full Changelog: 1.4.1...1.5.0

What's Changed

• Fixes #160 - Sandbox file submittal not functioning
• Fixes #174 - [BUG]: create_token() is hardcoded to post only production URL 'https://config.private.zscaler.com/signin
• Fixes #175 - [BUG] zia.url_categories.delete_urls_from_category will empty urls in "URLs Retaining Parent Category"
• Updates developer dependencies to latest supported versions
• Various minor formatting issues

A general warning that pyZscaler will likely drop support for Python 3.7 in the next upcoming version due to EoL of Python 3.7 in June 2023. In addition to the security considerations for doing so, please consider moving to Python 3.8 if you're currently on 3.7 to take advantage of future pyZscaler versions.

Full Changelog: 1.4.0...1.4.1

What's Changed

• Added support for ZIA Web DLP API Endpoint - big thanks to @daxm for getting this one sorted! via #152
• Resolved #13: Added support for ZIA Advanced Cloud Sandbox file submission.
• Added support for new ZCC API Endpoints:
  • Remove devices
  • Force Remove Devices
  • Download Devices as CSV
• Fixed #155: Broken ZCC List Devices pagination. Only the first page was being returned, which meant you couldn't view the entire list of devices in the Client Connector Portal.
• Clarified documentation for ZPA Policies update method, resolving #134
• Minor optimisations in internal pyZscaler utilities

Full Changelog: 1.3.1...1.4.0

What's Changed

• Fixes #153 - Can't update tcp/udp port ranges in ZPA app segments
• Fixes #143 - Adding URL to blacklist with zia.security.add_urls_to_blacklist returns "AttributeError"
• Resolves #135 - Add Support for ZPA Policy Reorder
• Updated all pyZscaler dependencies (both prod and development) to latest versions

Full Changelog: 1.3.0...1.3.1

What's Changed

• Resolves #112 - Add Support for ZPA Inspection API Endpoints
• Fixes #130 - pyZscaler doesn't support non-production clouds

Full Changelog: 1.2.1...1.3.0

Breaking Changes

• The ZCC module now requires you to specify the cloud for your mobile portal tenant. You will need to include the cloud attribute when instantiating the ZCC class.

Other notes

• All modules (ZIA, ZPA and ZCC) now support an override URL to accommodate any custom URI or future clouds that may be provided by Zscaler. See the documentation for each module for more information on how to employ this feature if required.

What's Changed

• Fixes #122 - Force delete arg for delete app segment
• Updates development dependencies

Full Changelog: 1.2.0...1.2.1

What's Changed

• pyZscaler now supports ZCC Mobile Admin Portal API endpoints! Note that these APIs are currently Limited Access and not available by default. Ensure you read the pyZscaler documentation that details how to obtain your ZCC Mobile Admin Portal companyId.
• Fixes #109 - Add Support for ZIA Rule Labels API Endpoints

Full Changelog: 1.1.1...1.2.0

What's Changed

• Add missing Type Hints by @LetMeR00t in #95
• Fixes #110 - ZIA Update User kwargs overshadowed by named params
• Closes pull requests for dependency updates #101, #102, #103, #104, #105, #107, #108,

Full Changelog: 1.1.0...1.1.1

What's Changed

• Adds support for ZPA LSS Config Controller v2, resolving #81.
• [APP_SEGMENTS] Quick fix regarding "add_segment" function definition by @LetMeR00t in #92

New Contributors

• @LetMeR00t made their first contribution in #92

Full Changelog: 1.0.2...1.1.0