Terraform

HashiCorp Terraform is an infrastructure as code tool that lets you define both cloud and on-prem resources in human-readable configuration files that you can version, reuse, and share. You can then use a consistent workflow to provision and manage all of your infrastructure throughout its lifecycle. For detailed information refer to the Terraform’s official documentation.

Integration Method: API

Tables: Entity Management (3004)

This integration supports the following events.

This integration supports the following versions.

Note:

Terraform is a continuously updated cloud service.

Prerequisites

• The user should have access to the Terraform dashboard.

• The user should have access to the DataBee console.

Configuration Overview

1. Generate token on the Terraform dashboard to authenticate to the API.

2. Create Terraform Data Feed in the DataBee console with the required Token.

   DataBee Parameter	Proofpoint TAP Parameter
   Token	Token
   Organization Name	Organization Name

Terraform Configuration

1. Log in to Terraform.

2. Select Create organization.
    

3. Under “Create a new organization” window, enter your ‘Organization name’ and click on the Create Organization button.
    

4. Under the sidebar, select Settings.
    

5. Scroll down and select API tokens.
    

6. Under User Tokens, select account settings page.
    

7. Select Create an API token.
    

8. Enter the token ‘Description’ and select the token ‘Expiration’ time (recommended time is 90 days).

   1. Click on the Generate token button.
       

9. Here you can find your token.

   1. Once the Token is generated, Copy the token for the later user.
       
      

      Note:

      Make sure to copy and save token as they will not be shown again.

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    

2. Search for Terraform and click it as shown below.
    

3. Click on the API Ingest option for collection method.
    

4. Enter feed contact information and click Next.
    

5. In the configuration page, confirm the following:

   • Authorization Method: Bearer Token

   • Token: paste the Token that generated earlier.

   • Organization Name: enter the Organization name.

   • Event Types: preselected for all the event types that integration pulls.
      

6. Click Submit.

Troubleshooting Tips

• Ensure the token is pasted correctly without any extra spaces or unexpected characters. Since the token is only visible once at the time of creation, it cannot be viewed again. If necessary, generate a new token and paste it into a text editor to check for formatting errors. Once verified, reconfigure the DataBee feed.