v2.74.0

2.74.0 (November 14, 2024)

Notes

• Golang: v1.22

ZIA PAC Files

PR #286 - Added the following new ZIA API Endpoints:

• Added GET /pacFiles to Retrieves the list of all PAC files which are in deployed state.
• Added GET /pacFiles/{pacId}/version to Retrieves all versions of a PAC file based on the specified ID.
• Added GET /pacFiles/{pacId}/version/{pacVersion} to Retrieves a specific version of a PAC file based on the specified ID.
• Added POST /pacFiles to Adds a new custom PAC file.
• Added DELETE /pacFiles/{pacId} to Deletes an existing PAC file including all of its versions based on the specified ID.
• Added PUT /pacFiles/{pacId}/version/{pacVersion}/action/{pacVersionAction} to Performs the specified action on the PAC file version and updates the file status.
• Added POST /pacFiles/validate to send the PAC file content for validation and returns the validation result.
• Added POST /pacFiles/{pacId}/version/{clonedPacVersion} to Adds a new PAC file version by branching an existing version based on the specified ID.

ZPA Additions - SCIM API

The SDK now supports interaction with the dedicated SCIM API Endpoint as described in the Zscaler Help documentation. The SCIM Service Provider Endpoints and references to scim1.private.zscaler.com.
To authenticate to the SCIM Service Provider Endpoint you can authenticate by providing the following information:

The ZPA Cloud is identified by several cloud name prefixes, which determines which API endpoint the requests should be sent to. The following cloud environments are supported:

• PRODUCTION
• ZPATWO
• BETA
• GOV
• GOVUS

Environment variables

You can provide credentials via the ZPA_SCIM_TOKEN, ZPA_IDP_ID, ZPA_SCIM_CLOUD environment variables, representing your ZPA scimToken, idpId, and scimCloud of your ZPA account, respectively.

~> NOTE 1 ZPA_SCIM_CLOUD environment variable is required, and is used to identify the correct API gateway where the API requests should be forwarded to.

~> NOTE 2 All SCIM APIs are rate limited.

Argument	Description	Environment variable
scimToken	(String) The ZPA SCIM Bearer token generated from the ZPA console.	ZPA_SCIM_TOKEN
idpId	(String) The ZPA IdP ID from the onboarded Identity Provider.	ZPA_IDP_ID
scimCloud	(String) The ZPA SCIM Cloud for your ZPA Tenant.	ZPA_SCIM_CLOUD

ZPA SCIM API Endpoints

PR #286 - Added the following ZPA SCIM API Endpoints:

• Added GET /Groups Fetch All Groups with pagination
• Added GET /Groups/{groupId} Fetch a Group By ID
• Added POST /Groups Create a new Group
• Added PUT /Groups/{groupId} Update a new Group
• Added PATCH /Groups/{groupId} Partially Update a Group

PR #286 - Added the following ZPA SCIM API Endpoints:

• Added GET /Users Fetch All Users with pagination
• Added GET /Users/{userID} Fetch a User By ID
• Added POST /Groups Create a new User
• Added PUT /Groups/{userID} Update a new User
• Added PATCH /Groups/{userID} Partially Update a User

v2.732.0

2.732.0 (October 31, 2024)

Notes

• Golang: v1.22

Internal Changes

PR #282 - Fixed update function in all specialized ZPA Application Segments
-applicationsegmentpra - The fix now automatically includes the attributes appId and praAppId in the payload during updates
- applicationsegmentinspection - The fix now automatically includes the attributes appId and inspectAppId in the payload during updates
- applicationsegmentbrowseraccess - The fix now automatically includes the attributes appId and baAppId in the payload during updates

v2.731.0

2.731.0 (October 30, 2024)

Notes

• Golang: v1.22

Enhancements

• Zscaler Cloud Connector (ZCON)
  • Added GET /provUrl endpoint to list provisioning templates.
  • Added GET /provUrl/{id} endpoint to retrieve a specific provisioning template.
  • Added POST /provUrl endpoint to create provisioning template.
  • Added PUT /provUrl/{id} endpoint to update a specific provisioning template.
  • Added DELETE /provUrl/{id} endpoint to delete a specific provisioning template.

Internal Changes

PR #281 - Added new ZPA Attributes:

• Resource: applicationsegment

  • extranetEnabled
  • apiProtectionEnabled
  • zpnErId

• Resource: policysetcontrollerv1 and policysetcontrollerv2

  • disabled
  • extranetEnabled
  • extranetDTO
  • privilegedPortalCapabilities

v2.73.0

2.73.0 (October 30, 2024)

Notes

• Golang: v1.22

Enhancements

• Zscaler Cloud Connector (ZCON)
  • Added GET /provUrl endpoint to list provisioning templates.
  • Added GET /provUrl/{id} endpoint to retrieve a specific provisioning template.
  • Added POST /provUrl endpoint to create provisioning template.
  • Added PUT /provUrl/{id} endpoint to update a specific provisioning template.
  • Added DELETE /provUrl/{id} endpoint to delete a specific provisioning template.

Internal Changes

PR #281 - Added new ZPA Attributes:

• Resource: applicationsegment

  • extranetEnabled
  • apiProtectionEnabled
  • zpnErId

• Resource: policysetcontrollerv1 and policysetcontrollerv2

  • disabled
  • extranetEnabled
  • extranetDTO
  • privilegedPortalCapabilities

v2.72.5

2.72.5 (October 8, 2024)

Notes

• Golang: v1.22

Internal Changes

PR #280 - Added missing attribute sourceCountries to ZIA firewallfilteringrule

v2.72.4

2.72.4 (October 3, 2024)

Notes

• Golang: v1.22

Internal Changes

PR #278 - Consolidated several ZPA common functions for Struct simplication.

v2.72.3

2.72.3 (September 30, 2024)

Notes

• Golang: v1.22

Bug Fixes

PR #277 - Added new attributes to ZPA servicedgegroup and serviceedgecontroller packages.

v2.72.2

2.72.2 (September 11, 2024)

Notes

• Golang: v1.22

Bug Fixes

PR #276 - Fixed removed omitempty from ZPA microtenant_id attribute in policysetcontrollerv2.

v2.72.1

2.72.1 (August 16, 2024)

Notes

• Golang: v1.22

Bug Fixes

PR #274 - Added new ZIA function GetVIPRecommendedList, which will support all optional parameters when retrieving the list of recommended Virtual IP addresses per datacenter. The following optional parameters are now supported:

• routable_ip - (Boolean) The routable IP address.
• within_country_only - (Boolean) Search within country only.
• include_private_service_edge - (Boolean) Include ZIA Private Service Edge VIPs.
• include_current_vips - (Boolean) Include currently assigned VIPs.
• latitude - (Number) The latitude coordinate of the GRE tunnel source.
• longitude - (Number) The longitude coordinate of the GRE tunnel source.
• subcloud - (String) The longitude coordinate of the GRE tunnel source.

v2.72.0

2.72.0 (August 14, 2024)

Notes

• Golang: v1.22

ZPA Additions

Segment Group

• Added new optimized V2 endpoint PUT /segmentGroup/{segmentGroupId} to prevent "payload.size.exceeded" error when updating a segment group with large numbers or application segments attached. PR #273
  NOTE The V1 endpoint PUT /segmentGroup/{segmentGroupId} will eventually be deprecated; however, this change should not affect existing Segment Group configurations.

Bug Fixes

PR #270 - Fixed ports attribute from string to slice of intergers in locationmanagement.