v4.0.0

[willguibr]

4.0.0 (January, 22 2025) - BREAKING CHANGES

Notes

• Release date: (January, 22 2025)
• Supported Terraform version: v1.x

Enhancements - Zscaler OneAPI Support

PR #383: The ZIA Terraform Provider now offers support for OneAPI Oauth2 authentication through Zidentity.

NOTE As of version v4.0.0, this Terraform provider 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 Index Page page for details on authentication requirements prior to upgrading your provider 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.

NEW - RESOURCES, DATA SOURCES, PROPERTIES, ATTRIBUTES, ENV VARS

ENV VARS: ZIA Sandbox Submission - BREAKING CHANGES

PR #383: 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.

NEW - RESOURCES, DATA SOURCES

PR #383: The following new resources and data sources have been introduced:

• Added the datasource and resource zia_sandbox_rules PR #383 🚀 - Manage Sandbox Rules
• Added the datasource and resource zia_firewall_dns_rulePR #383 🚀 - Manage Cloud Firewall DNS Rules
• Added the datasource and resource zia_firewall_ips_rule PR #383 🚀 - Manage Cloud Firewall IPS Rules
• Added the datasource and resource zia_file_type_control_rules PR #383 🚀 - Manage File Type Control Rules
• Added the datasource and resource zia_advanced_threat_settings PR #383 🚀 - Manages advanced threat configuration settings
• Added the datasource and resource zia_atp_malicious_urls PR #383 🚀 - Manages malicious URLs added to the denylist in ATP policy
• Added the datasource and resource zia_atp_security_exceptions PR #383 🚀 - Manages Security Exceptions (URL Bypass List) for the ATP policy
• Added the datasource and resource zia_advanced_settings PR #383 🚀 - Manages Advanced Settings configuration. Configuring Advanced Settings
• Added the datasource and resource zia_atp_malware_inspection PR #383 🚀 - Manages Advanced Threat Protection Malware Inspection configuration. Malware Protection
• Added the datasource and resource zia_atp_malware_protocols PR #383 🚀 - Manages Advanced Threat Protection Malware Protocols configuration. Malware Protection
• Added the datasource and resource zia_atp_malware_settings PR #383 🚀 - Manages Advanced Threat Protection Malware Settings. Malware Protection
• Added the datasource and resource zia_atp_malware_policy PR #383 🚀 - Manages Advanced Threat Protection Malware Policy. Malware Protection
• Added the datasource and resource zia_end_user_notification PR #383 🚀 - Retrieves information of browser-based end user notification (EUN) configuration details.Understanding Browser-Based End User Notifications
• Added the datasource and resource zia_url_filtering_and_cloud_app_settings PR #383 🚀 - Manages the URL and Cloud App Control advanced policy settings.Configuring Advanced Policy Settings
• Added the datasource zia_cloud_applications PR #383 🚀 - 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 the datasource zia_forwarding_control_proxy_gateway PR #383 🚀 - Retrieves information of existing Proxy Gateway configuration.
• Added the datasource and resource zia_ssl_inspection_rules PR #383 🚀 - Manages SSL Inspection Rules.

NEW ATTRIBUTES

• PR #383 - Added new actions values to resource zia_cloud_app_control_rule.
  Please refer to the Cloud Application Control - Rule Types vs Actions Matrix page for details each action per rule_type

---

This discussion was created from the release v4.0.0.