Manage Terraform policy plugin versions

This topic describes how to add and manage versions of the Terraform policy plugin (tfpolicy-plugin) that Terraform Enterprise uses to evaluate Terraform policy sets.

Overview

The Terraform policy plugin is the binary that evaluates policies written using the Terraform policy framework. Site administrators manage which versions of the plugin are available to policy authors and administrators in the organization.

Requirements

You must have one of the following user roles to access the Terraform policy plugin versions page:

• Site admin
• Configuration
• Support
• Version maintenance

Add a Terraform policy plugin version

Terraform policy plugin binaries are available for download from HashiCorp.

To add a new version of the Terraform policy plugin:

1. Navigate to the Terraform policy plugin versions page in the site administration settings.
2. Click Add Terraform policy plugin version.
3. In the Version field, enter the version number you want to add (for example, 0.4.0).
4. Configure the Availability settings:
   • Enable this version: Allow all users to access this version for policy set evaluation.
   • Disable this version: Prevent this version from being used in any policy set evaluation.
5. Optionally, configure Early access settings
   • Beta: Restrict this version to organizations with beta access. Use only for official pre-release builds (alpha, beta, release candidates).
6. Under OS Architecture & Download details, provide download information for each supported platform:
   • OS Architecture: Select the platform (for example, Linux amd64).
   • Download URL: Enter the URL where the binary can be downloaded (for example, https://releases.hashicorp.com/tfpolicy-plugin/0.4.0/tfpolicy-plugin_0.4.0_linux_amd64.zip).
   • SHA256 Checksum: Enter the 64-character hexadecimal SHA256 checksum for the binary. You can find this in the _SHA256SUMS file on the download page.
7. Click Add another OS Architecture to add support for additional platforms.
8. Click Add Terraform policy plugin version to complete the setup.

The new version is now available for policy authors to use in their policy sets.

Manage existing versions

To modify an existing Terraform policy plugin version:

1. Navigate to the Terraform policy plugin versions page.
2. Click on the version you want to modify.
3. Update the availability settings, deprecation status, or platform binaries as needed.
4. Click Update Terraform policy plugin version to save your changes.