Skip to content

NorskHelsenett/terraform-provider-tss

Repository files navigation

Thycotic Secret Server - Terraform Provider

The Thycotic Secret Server Terraform Provider allows you to access and reference Secrets in your vault for use in Terraform configurations.

This is a fork of Thycotic's own provider, with the following improvements:

  • Incorporates the changes made in newer versions of the TSS SDK for Go to support using the Domain-attribute in the user credentials
  • Rewritten to use Terraform Provider SDK v2

Install via Registry

Preferred way to install

The latest release can be downloaded from the terraform registry. The documentation can be found here.

If wish to install straight from source, follow the steps below.

Install from Source

Terraform 0.12 and earlier

Extract the specific file for your OS and Architecture to the plugins directory of the user's profile. You may have to create the directory.

OS Default Path
Linux ~/.terraform.d/plugins
Windows %APPDATA%\terraform.d\plugins

Terraform 0.13 and later

Terraform 0.13 uses a different file system layout for 3rd party providers. More information on this can be found here. The following folder path will need to be created in the plugins directory of the user's profile.

Windows

%APPDATA%\TERRAFORM.D\PLUGINS
└───terraform.nhn.no
    └───norskhelsenett
        └───tss
            └───0.3.0
                └───windows_amd64

Linux

~/.terraform.d/plugins
└───terraform.nhn.no
    └───norskhelsenett
        └───tss
            └───0.3.0
                ├───linux_amd64

Usage

For Terraform 0.13+, include the terraform block in your configuration, or plan, that specifies the provider:

terraform {
  required_providers {
    tss = {
      source = "norskhelsenett/tss"
      version = "0.3.0"
    }
  }
}

To run the example, create a terraform.tfvars:

tss_username   = "my_app_user"
tss_password   = "Passw0rd."
tss_domain     = "foo.bar"
tss_server_url = "https://example/SecretServer"
tss_secret_id  = "1"