Skip to main content

​
HCP Integration

HCP integration allows Annie to connect to HashiCorp Cloud Platform (HCP Terraform / Terraform Enterprise) to retrieve state file data when it is not stored on S3.

​
Setup Guide

  1. Go to the HCP Cloud integration page
  2. Click New token
  3. Fill in the HCP Cloud URL, workspace, and API token as described below

​
1. HCP Cloud URL

Usually https://app.terraform.io. Use your Terraform Enterprise hostname if you are self-hosting.

​
2. Workspace

The HCP Terraform workspace whose state Annie should ingest. Supported formats:
  • Workspace ID: ws-…
  • Organization and name: organization/workspace
Create one Anyshift credential set per workspace you want Annie to read.

​
3. Token

Annie authenticates to HCP Terraform with an API token that can read the workspace and download its current state. A team token (or group token on HCP Europe) is the recommended choice for shared automation. A user token also works if the user can access the workspace. Organization tokens are not recommended for this integration. Prefer a team or user token scoped to the workspaces Annie needs.
  1. Sign in to HCP Terraform (or your Terraform Enterprise instance)
  2. Open Organization Settings → API Tokens → Team Tokens
  3. Choose a team that has access to the target workspace
  4. Create a new team token and copy it immediately (it is only shown once)
  5. Paste the token into Anyshift
For details, see HashiCorp’s Manage API tokens documentation.

​
Option B: User API token

  1. Sign in to HCP Terraform (or your Terraform Enterprise instance)
  2. Click your user icon → Account settings → Tokens
  3. Click Create an API token, add a description, and set an expiration
  4. Copy the token immediately (it is only shown once)
  5. Paste the token into Anyshift
For details, see HashiCorp’s Creating a token documentation.
If you have a single token that can access multiple workspaces, you can reuse it in Anyshift, but you still need a separate credential set per workspace. If that is a blocker, tell us and we will prioritize multi-workspace credentials.