Terraform
- 4 Minutes to read
- Print
- PDF
Terraform
- 4 Minutes to read
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
About this document
This document provides the step-by-step procedure to configure Terraform in SAFE.
Introduction
SAFE integrates with Terraform and fetches the security misconfiguration of the Terraform account in SAFE.
Prerequisites
Access required in SAFE:
SAFE Admin Access
Access required in Terraform:
Terraform Admin
Required User Inputs:
API URL
Access Token
Organization ID
Required Scope:
Admin Access
Generate Connection Details
How to generate an Access Token
Log in to your Terraform account as Admin.
Click on the Settings option from the left panel
.png "1(42).png")
Click on the API Tokens under the Security Section
Click on the Create an organization token button
.png "2(40).png")
Select the Expiration date
Click on the Generate token button
.png "3(38).png")
The system displays the Access Token. Copy and save the Access Token to use it while configuring Terraform in SAFE.
It's important to regularly update the Access Token in SAFE according to its expiration date.
.png "4(38).png")
How to get an Organization ID
Log in to your Terraform account as Admin.
Click on the Settings option from the left panel
.png "5(38).png")
Click on the General under Organization Settings Section
The system displays the Name. Copy and save the Name to use it while configuring Terraform in SAFE.
How to get API URL
Access the Terraform API documentation by clicking on the provided link.
Upon reaching the Terraform API documentation page, locate the section titled as "Get your account details".
In the exhibit provided, find the base URL highlighted as 3. Copy and save this API Base URL to use it while configuring Terraform in SAFE.
.png "6(37).png")
.png "1(42).png")
.png "2(40).png")
.png "3(38).png")
.png "4(38).png")
.png "5(38).png")
.png "6(37).png")
Configure Terraform in SAFE
Log in to your SAFE account as Admin.
Click on the Integrations option from the left navigation.
Scroll to find the Terraform integration card or search for Terraform in the search bar.
.png "7(37).png")
Hover over the Terraform integration card and click on the Configure button.
Enter the following:
API URL
Access Token
Organization ID
Enter the Auto Sync Frequency.
.png "8(40).png")
Click on the Test Connection button.
Once the connection is successful, click on the Save button.
Once the configuration is saved successfully, click on the Sync Now button to trigger an on-demand sync.
.png "9(38).png")
Upon a successful sync, the system pulls the Terraform assets and their findings in SAFE. You can track the status of the sync in the History table.
.png "7(37).png")
.png "8(40).png")
.png "9(38).png")
View Results
Go to the Integration homepage.
Scroll to find the Terraform integration card or search for Terraform in the search bar.
Click on the Terraform integration card for Finding View and Asset View.
Finding View: This tab displays all the findings details pulled from Terraform.
.png "10(31).png")
Asset View: This tab displays all the assets pulled from Terraform.
.png "11(22).png")
.png "10(31).png")
.png "11(22).png")
History
Learn More about Integration History here.
SAFE's Outgoing IP Addresses
Click here to find the outgoing IP addresses of SAFE. All traffic to any integrations in SAFE will see one IP address as the source IP of the incoming connection.
Was this article helpful?