Authentication

Terraform authenticates with Verda using OAuth2 credentials. All API requests made by the Verda Terraform provider are authorized using a Client ID and Client Secret associated with your Verda account.

---

Required credentials

To authenticate, you need:

• Client ID

• Client Secret

These credentials are generated in the Verda dashboard and grant Terraform permission to manage your resources.

---

Recommended: environment variables

The recommended way to provide credentials is via environment variables.

Set the following variables in your shell:

export VERDA_CLIENT_ID="your-client-id"
export VERDA_CLIENT_SECRET="your-client-secret"

Then configure the provider with an empty block:

provider "verda" {}

This approach keeps sensitive credentials out of your Terraform configuration files and works well for local development and CI/CD pipelines.

---

Provider configuration (alternative)

You can also configure credentials directly in the provider block:

provider "verda" {
  client_id     = "your-client-id"
  client_secret = "your-client-secret"
}

This method is not recommended for production use, as it risks committing secrets to version control.

---

Using Terraform variables

If you prefer using Terraform variables, define them as sensitive:

variable "verda_client_id" {
  type      = string
  sensitive = true
}

variable "verda_client_secret" {
  type      = string
  sensitive = true
}

Then reference them in the provider configuration:

provider "verda" {
  client_id     = var.verda_client_id
  client_secret = var.verda_client_secret
}

Values can be supplied via terraform.tfvars, environment variables, or a secrets manager.

---

CI/CD considerations

When running Terraform in CI/CD:

• Store credentials in your CI secret manager

• Inject them as environment variables at runtime

• Avoid printing sensitive values in logs

Terraform automatically masks sensitive variables, but extra care should still be taken when debugging pipelines.

---

Troubleshooting authentication

If authentication fails:

• Verify that VERDA_CLIENT_ID and VERDA_CLIENT_SECRET are set

• Confirm the credentials are valid and not expired

• Ensure your environment variables are available to the Terraform process

Authentication errors typically appear during terraform init or terraform plan.

---

Next steps

Once authentication is configured, continue with:

• Provider Configuration – advanced provider settings

• Compute – provisioning GPU instances and related resources

• Storage – managing persistent volumes