Releases

Zscaler Internet Access (ZIA) Ansible Collection Changelog

Version 2.2.4

v2.2.4 (June 2, 2026)

Notes

  • Python Versions: v3.9, v3.10, v3.11

#### Internals

  • (#127) - Added the Red Hat partner certification checker workflow, set license: [MIT] in galaxy.yml, and resolved README link and version-statement issues raised during certification review

Version 2.2.3

v2.2.3 (June 1, 2026)

Notes

  • Python Versions: v3.9, v3.10, v3.11

#### Internals

  • (#123) - Fixed sanity CI so the matrix-pinned ansible-core is installed after poetry install (preventing an unintended upgrade that broke validate-modules), bumped requires_ansible to >=2.16.0, added a 2.16/Python 3.12 sanity job, and corrected README license badge and relative links

  • (#123) - Release v2.2.3

Version 2.2.2

v2.2.2 (June 1, 2026)

Notes

  • Python Versions: v3.9, v3.10, v3.11

#### Internals

  • (#121) - Fixed sanity CI so the matrix-pinned ansible-core is installed after poetry install (preventing an unintended upgrade that broke validate-modules), bumped requires_ansible to >=2.16.0, added a 2.16/Python 3.12 sanity job, and corrected README license badge and relative links

  • (#122) - Release v2.2.3

Version 2.2.1

v2.2.1 (June 1, 2026)

Notes

  • Python Versions: v3.9, v3.10, v3.11

#### Internals

  • (#121) - Fixed sanity CI so the matrix-pinned ansible-core is installed after poetry install (preventing an unintended upgrade that broke validate-modules), bumped requires_ansible to >=2.16.0, added a 2.16/Python 3.12 sanity job, and corrected README license badge and relative links

  • (#122) - Release v2.2.1

Version 2.2.0

v2.2.0 (May 29, 2026)

Notes

  • Python Versions: v3.9, v3.10, v3.11

#### Enhancements

  • (#119) - Added new resources zia_ips_signature_rules and zia_ips_signature_rules_info - Manage IPS Signature Rules

  • (#119) - Added new resources zia_email_profiles and zia_email_profiles_info - Manage Email Recipient Profiles

  • (#119) - Added new resource zia_browser_control_supported_versions_info - Retrieve the list of supported browser versions

  • (#119) - Added local JMESPath query filtering to the info modules zia_user_management_info, zia_user_management_groups_info, zia_user_management_department_info, zia_cloud_applications_info, zia_cloud_app_control_rule_actions_info, and zia_browser_control_supported_versions_info

  • (#119) - Added support for the EXTRANET profile and extranet, extranet_dns, extranet_ip_pool, default_extranet_dns, and default_extranet_ts_pool attributes in zia_location_management

Bug Fixes:

  • (#119) - Fixed zia_location_management idempotency for sublocations so re-runs no longer attempt to recreate existing sublocations

  • (#119) - Fixed zia_location_management drift on the extranet, extranet_dns, and extranet_ip_pool attributes by comparing them by id only

  • (#119) - Updated zia_browser_control_policy and zia_browser_control_policy_info to use the secure_browsing SDK service and persist smart browser isolation settings

Version 2.1.0

v2.1.0 (February 16, 2026)

Notes

  • Python Versions: v3.9, v3.10, v3.11

#### Enhancements

  • (#105) - Added the following new resources: - zia_sub_cloud and zia_sub_cloud_info - Manage Zscaler Sub-Clouds in ZIA - zia_extranet and zia_extranet_info - Manage Extranet configurations in ZIA - zia_dc_exclusions and zia_dc_exclusions_info - Manage Extranet configurations in ZIA - zia_tenant_restriction_profile and zia_tenant_restriction_profile_info, - zia_workload_groups and zia_workload_groups_info - Manages workload group for an organization. - zia_virtual_service_edge_node and zia_virtual_service_edge_node - Retrieves the Virtual Service Edge Nodes (VZEN). This resource can be used to set the corresponding node when configuring the resource zia_vzen_cluster. - zia_vzen_cluster and zia_vzen_cluster_info - Manage Virtual Service Edge cluster - zia_custom_file_types and zia_custom_file_types_info - zia_casb_dlp_rules and - zia_casb_dlp_rules_info - SaaS Security API (Casb DLP Rules) - zia_casb_malware_rules and - zia_casb_malware_rules_info - SaaS Security API (Casb Malware Rules) - file_type_categories_info - This resource can be referenced within the zia_dlp_web_rules in the attribute file_type_categories - zia_cloud_app_control_rule_actions_info - Get available Cloud App Control rule actions by rule type - zia_browser_control_policy and zia_browser_control_policy_info - Browser Control Policy - zia_casb_tombstone_template_info - SaaS Security API (Casb Quarantine Tombstone Template) - zia_casb_email_label_info - SaaS Security API (Casb Quarantine Tombstone Template) - zia_casb_tenant_info - SaaS Security API (Casb Tenant)

  • (#105) - Added new attributes to ZIA: - zia_firewall_ips_rule: is_eun_enabled, and eun_template_id - zia_firewall_dns_rule: is_web_eun_enabled and default_dns_rule_name_used - zia_location_management: sub_loc_scope_enabled, sub_loc_scope, sub_loc_scope_values, sub_loc_acc_ids - zia_dlp_web_rules: eun_template_id

Bug Fixes:

  • (#105) - Improved zia_client to support authentication via both OneAPI and legacy methods.

  • (#105) - Fixed URL Categories update method

v2.0.7 (July 25, 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes:

  • (#88) - Fixed requirements.txt formatting issues.

v2.0.6 (July 21, 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes:

  • (#85) - Fixed zia_atp_settings argument count issue.

v2.0.5 (June 23, 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes:

  • (#81) - Fixed zia_url_categories mandatory attributes

v2.0.4 (June 5, 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes:

  • (#79) - Fixed pagination for the resource zia_cloud_applications_info

v2.0.3 (May, 29 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes:

v2.0.2 (May, 26 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes:

  • (#75) - Added new source_ip_groups attribute to zia_url_filtering_rules

  • (#75) - Added new nw_applications attribute to zia_cloud_firewall_rule and zia_forwarding_control_rule.

  • (#75) - Fixed drift with the attribute ip_addresses within the resource zia_cloud_firewall_ip_source_groups

## v2.0.1 (May, 12 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • (#72) - Fixed all_collect_items pagination argument count

2.0.0 (May, 6 2025) - BREAKING CHANGES

Notes

  • Python Versions: v3.9, v3.10, v3.11

Enhancements - Zscaler OneAPI Support - BREAKING CHANGES

  • (#68): The ZIA Ansible Collection now offers support for (OneAPI) Oauth2 authentication through (Zidentity)

NOTE As of version v2.0.0, this collection offers backwards compatibility to the Zscaler legacy API framework. This is the recommended authentication method for organizations whose tenants are still not migrated to (Zidentity)

⚠️ WARNING: Please refer to the (Authentication Page) for details on authentication requirements prior to upgrading your collection configuration.

⚠️ WARNING: Attention Government customers. OneAPI and Zidentity is not currently supported for the following clouds: zscalergov and zscalerten. Refer to the Legacy API Framework section for more information on how authenticate to these environments using the legacy method.

ENV VARS: ZIA Sandbox Submission - BREAKING CHANGES

  • (#68): Authentication to Zscaler Sandbox service now use the following attributes.

  • sandboxToken - Can also be sourced from the ZSCALER_SANDBOX_TOKEN environment variable.

  • sandboxCloud - Can also be sourced from the ZSCALER_SANDBOX_CLOUD environment variable.

The use of the previous envioronment variables combination ZIA_SANDBOX_TOKEN and ZIA_CLOUD is now deprecated.

  • (#68): The following resources have been renamed:

  • zia_cloud_firewall_filtering_rule.py - Renamed to zia_cloud_firewall_rule

  • zia_cloud_firewall_filtering_rule_info.py.py - Renamed to zia_cloud_firewall_rule_info

  • zia_cloud_firewall_filtering_rule_info.py.py - Renamed to zia_cloud_firewall_rule_info

NEW - RESOURCES

  • (#68): The following new resources and data sources have been introduced:

  • Added resource zia_advanced_settings - (#68) - Manages advanced threat configuration settings

  • Added info resource zia_advanced_settings_info - (#68) - Retrieves advanced threat configuration settings. (Configuring Advanced Settings)

  • Added resource zia_atp_malicious_urls - (#68) - Manages malicious URLs added to the denylist in ATP policy

  • Added info resource zia_atp_malicious_urls_info - (#68) - Retrieves malicious URLs added to the denylist in ATP policy

  • Added resource zia_atp_settings - (#68) - Updates the advanced threat configuration settings

  • Added info resource zia_atp_settings_info - (#68) - Retrieves the advanced threat configuration settings

  • Added resource zia_atp_security_exceptions - (#68) - Manages Security Exceptions (URL Bypass List) for the ATP policy

  • Added info resource zia_atp_security_exceptions_info - (#68) - Retrieves information about the security exceptions configured for the ATP policy

  • Added resource zia_atp_malware_inspection - (#68) - Updates the traffic inspection configurations of Malware Protection policy

  • Added info resource zia_atp_malware_inspection_info - (#68) - Retrieves the traffic inspection configurations of Malware Protection policy. (Malware Protection)

  • Added resource zia_atp_malware_protocols - (#68): Updates the protocol inspection configurations of Malware Protection policy

  • Added info resource zia_atp_malware_protocols_info - (#68) - Retrieves Advanced Threat Protection Malware Protocols configuration. (Malware Protection)

  • Added resource zia_atp_malware_settings - (#68) - Manages Advanced Threat Protection Malware Settings.

  • Added inforesource zia_atp_malware_settings_info - (#68) - Retrieves Advanced Threat Protection Malware Settings. (Malware Protection)

  • Added resource zia_atp_malware_policy - (#68) - Manages Advanced Threat Protection Malware Policy. (Malware Protection)

  • Added info resource zia_atp_malware_policy_info - (#68) - Retrieves Advanced Threat Protection Malware Policy. (Malware Protection)

  • Added resource zia_mobile_advanced_threat_settings - (#68) - Manages Mobile Malware Protection Policy. (Mobile Malware Protection)

  • Added info resource zia_mobile_advanced_threat_settings_info - (#68) - Retrieves Mobile Malware Protection Policy (Mobile Malware Protection)

  • Added resource zia_end_user_notification - (#68) - Manages browser-based end user notification (EUN) configuration details.

  • Added resource zia_end_user_notification_info - (#68) - Manages browser-based end user notification (EUN) configuration details. (Understanding Browser-Based End User Notifications)

  • Added resource zia_ftp_control_policy - (#68) - Updates the FTP Control settings.

  • Added resource zia_ftp_control_policy_info - (#68) - Retrieves the FTP Control status and the list of URL categories for which FTP is allowed. (About FTP Control Policy)

  • Added resource zia_sandbox_rules - (#68) - Manage Sandbox Rules

  • Added info resource zia_sandbox_rules_info - (#68) - Retrieve Sandbox Rules information

  • Added resource zia_cloud_firewall_dns_rule - (#68) - Manage Cloud Firewall DNS Rules

  • Added info resource zia_cloud_firewall_dns_rule_info - (#68) - Manage Cloud Firewall DNS Rules

  • Added info resource zia_cloud_firewall_ips_rules - (#68) - Retrieve Cloud Firewall IPS Rules

  • Added info resource zia_cloud_firewall_ips_rules_info - (#68) - Retrieve Cloud Firewall IPS Rules

  • Added resource zia_file_type_control_rules - (#68) - Manage File Type Control Rules

  • Added info resource zia_file_type_control_rules_info - (#68) - Retrieve File Type Control Rules

  • Added resource zia_ssl_inspection_rules - (#68) - Manages SSL Inspection Rules.

  • Added info resource zia_ssl_inspection_rules_info - (#68) - Retrives SSL Inspection Rules.

  • Added resource zia_nat_control_policy - (#68) - Manages NAT Control Policy.

  • Added info resource zia_nat_control_policy_info - (#68) - Retrives NAT Control Policy.

  • Added and resource zia_url_filtering_and_cloud_app_settings - (#68) - Manages the URL and Cloud App Control advanced policy settings.

  • Added info resource zia_url_filtering_and_cloud_app_settings_info - (#68) - Retrives the URL and Cloud App Control advanced policy settings. (Configuring Advanced Policy Settings)

  • Added info resource zia_cloud_applications_info - (#68) - Retrieves Predefined and User Defined Cloud Applications associated with the DLP rules, Cloud App Control rules, Advanced Settings, Bandwidth Classes, File Type Control rules, and SSL Inspection rules.

  • Added resource zia_dns_gateway - (#68) - Manages DNS Gateway object.

  • Added info resource zia_dns_gateway_info - (#68) - Retrives DNS Gateway object.

  • Added resource zia_third_party_proxy_service - (#68) - Manages third party proxy objects.

  • Added info resource zia_third_party_proxy_service_info - (#68) - Retrives third party proxy objects.

  • Added resource zia_nss_servers - (#68) - Manages NSS Server objects.

  • Added info resource zia_nss_servers_info - (#68) - Retrives NSS Server objects.

  • Added resource zia_cloud_application_instances - (#68) - Manages Cloud Application Instances.

  • Added info resource zia_cloud_application_instances_info - (#68) - Retrives Cloud Application Instances object.

  • Added resource zia_risk_profiles - (#68) - Manages Risk Profiles objects.

  • Added info resource zia_risk_profiles_info - (#68) - Retrives Risk Profiles configuration.

  • Added resource zia_remote_assistance - (#68) - Manages Remote Assistance configuration.

  • Added info resource zia_remote_assistance_info - (#68) - Retrives Remote Assistance configuration.

1.3.5 (March, 20 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • (#62) Added docs/html within the galaxy.yml file under the build_ignore key

1.3.4 (March, 19 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • (#60) Removed ansible.cfg from Ansible Automation Hub and Galaxy GitHub Actions workflow

  • (#60) Fixed Location management drift issues

1.3.3 (March, 19 2025)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • (#56) Removed ansible.cfg from Ansible Automation Hub and Galaxy GitHub Actions workflow

1.3.1 (September, 12 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

New Feature

  • (#47) Fixed DLP Engine tests.

1.3.0 (September, 6 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

New Feature

  • (#46) Added new resource zia_cloud_app_control_rule and zia_cloud_app_control_rule_info for Cloud Application Control rule management.

1.2.0 (July, 22 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

BREAKING CHANGES

  • (#270) All resources previously named with _facts have been moved to _info to comply with Red Hat Ansible best practices as described in the following (Ansible Developer Documentation)

NEW FEATURES

  • (#270) All resources now support check_mode for simulation purposes and for validating configuration management playbooks.

1.1.0 (June, 25 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Enhancements

  • Added Forwarding Control Rule Resource (#37)

1.0.17 (May, 04 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Updated requirements.txt and documentation (#34)

1.0.16 (May, 04 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Fixed IP Destination and IP Source Group Drift (#33)

1.0.15 (May, 04 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Fixed zia authentication method schema (#31)

1.0.14 (April, 24 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Added collection version to user-agent header (#30)

1.0.13 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Fixed release process for automation hub (#27)

1.0.12 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Removed Beta comment from README and fixed galaxy link on index (#e47696c)

1.0.11 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Removed Beta from README page (#658b30b)

1.0.10 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Fixed linter workflow and documentation (#45f0f98)

1.0.9 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Fixed makefile doc generation section (#26024a5)

1.0.8 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Fixed makefile doc generation section (#165756c)

1.0.7 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Removed poetry from release.yml doc generation (#e0feb95)

1.0.6 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

1.0.5 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

1.0.4 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Temporarily disabled Automation Hub Workflow (#77ccd0d)

1.0.3 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Temporarily disabled Automation Hub Workflow (#e1a4b24)

1.0.2 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Temporarily disabled Automation Hub Workflow (#78b77bd)

1.0.1 (April, 23 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

Bug Fixes

  • Temporarily disabled Automation Hub Workflow (#66a363f)

1.0.0 (April, 22 2024)

Notes

  • Python Versions: v3.9, v3.10, v3.11

  • Initial release of Zscaler Internet Access Automation collection, referred to as ziacloud which is part of the Red Hat® Ansible Certified Content.

What’s New

Availability