# Terraform Provider

Manage your StepSecurity configurations as code with our Terraform provider. Automate the setup of notification settings, policy-driven pull requests, user access controls and more across your GitHub organizations.

### Quick Start Guide

Navigate to the Admin Console, then click on Integrations and select Terraform Provider. There, you’ll see the setup instructions — or simply follow the steps outlined below:

#### Step 1: Install Terraform

* Download and install Terraform from [developer.hashicorp.com/terraform/install](https://developer.hashicorp.com/terraform/install)

#### Step 2: Set Environment Variables

* Export the required environment variables to authenticate the Terraform provider:

```bash
export STEP_SECURITY_API_KEY=***************
export STEP_SECURITY_CUSTOMER=<ORGANIZATION NAME>
```

* STEP\_SECURITY\_API\_KEY: Your StepSecurity API key
* STEP\_SECURITY\_CUSTOMER: Your organization name

#### Step 3:  Create Terraform Configuration

Create a `main.tf` file with the following content to define the StepSecurity provider:

```
terraform {
  required_providers {
    stepsecurity = {
      source = "step-security/stepsecurity"
    }
  }
}

provider "stepsecurity" {
  # Configuration will be read from environment variables
  # STEP_SECURITY_API_KEY, STEP_SECURITY_CUSTOMER
}
```

#### Step 4: Add Resources

You can now define Terraform resources to manage your StepSecurity configurations. Here’s an example of creating a GitHub user with organizational access:

```
# Create a GitHub user with organization access
resource "stepsecurity_user" "example_user" {
  user_name = "github-username"
  auth_type = "Github"
  policies = [
    {
      type         = "github"
      role         = "auditor"
      scope        = "organization"
      organization = "your-org-name"
    }
  ]
}
```

This configuration grants the specified GitHub user read-only access to the organization’s StepSecurity-managed GitHub workflows and policies.

#### Step 5: Run Terraform Commands

Use the following commands to deploy your configuration:

```bash
terraform init    # Initialize the working directory
terraform plan    # Preview the changes
terraform apply   # Apply the configuration
```

### Further Reading

* [Terraform Registry Documentation →](https://registry.terraform.io/providers/step-security/stepsecurity/latest/docs)

  Explore the complete resource reference, available data sources, configuration options, and provider versions.
* [GitHub Examples Repository →](https://github.com/step-security/terraform-stepsecurity-examples)

  Browse real-world examples, reusable templates, and best practices to accelerate your setup.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stepsecurity.io/administration/admin-console/integrations/terraform-provider.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.