taharah/terraform-provider-okta

Terraform Okta provider

Important note

As you might notice, the latest GitHub version of the provider differs from the one in the registry. The problem is that the official Okta provider has migrated from oktadeveloper to okta namespace and thus we can not publish it to the registry without a new gpg key.

The official answer from Hashicorp states:

We're currently going through an engineering org change. The request to transfer to `okta` namespace will hopefully be possible in just a few weeks.

There is always a possibility to use in-house provider built from source. Basically, you clone the repo and run go install or download a binary from the release page and you can use it as your main provider.

For example, here is my local terraform provider configuration:

├── terraform.d
│   └── plugins
│       └── my-host
│           └── me
│               └── okta
│                   └── 4.0.0                            <- version can be whatever you like
│                       └── darwin_amd64                 <- arch
│                           └── terraform-provider-okta  <- binary 
└── versions.tf

versions.tf file content:

terraform {
  required_providers {
    okta = {
      source  = "my-host/me/okta"                          
      version = "4.0.0"                                               <- version can be whatever you like
    }
  }
  required_version = ">= 0.13"
}

After that, you should run terraform init to make terraform use your custom provider.

Terraform Provider for Okta

The Terraform Okta provider is a plugin for Terraform that allows for the full lifecycle management of Okta resources. This provider is maintained internally by the Okta development team.

Examples

All the resources and data sources has one or more examples to give you an idea of how to use this provider to build your own Okta infrastructure. Provider's official documentation is located in the official terraform registry, or here in form of raw markdown files.

Development Environment Setup

Requirements

• Terraform 0.12.26+ (to run acceptance tests)
• Go 1.15 (to build the provider plugin)

Quick Start

If you wish to work on the provider, you'll first need Go installed on your machine (please check the requirements before proceeding).

Note: This project uses Go Modules making it safe to work with it outside your existing GOPATH. The instructions that follow assume a directory in your home directory outside the standard GOPATH (i.e $HOME/development/terraform-providers/).

Clone repository to: $HOME/development/terraform-providers/

$ mkdir -p $HOME/development/terraform-providers/; cd $HOME/development/terraform-providers/
$ git clone [email protected]:okta/terraform-provider-okta.git
...

Enter the provider directory and run make tools. This will install the needed tools for the provider.

$ make tools

To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.

$ make build
...
$ $GOPATH/bin/terraform-provider-okta
...

Testing the Provider

In order to test the provider, you can run make test.

$ make test

In order to run the full suite of Acceptance tests, run make testacc.

Note: Acceptance tests create real resources, and often cost money to run. Please read Running an Acceptance Test in the contribution guidelines for more information on usage.

$ make testacc

Using the Provider

To use a released provider in your Terraform environment, run terraform init and Terraform will automatically install the provider. To specify a particular provider version when installing released providers, see the Terraform documentation on provider versioning.

To instead use a custom-built provider in your Terraform environment (e.g. the provider binary from the build instructions above), follow the instructions to install it as a plugin. After placing the custom-built provider into your plugins directory, run terraform init to initialize it.

For either installation method, documentation about the provider specific configuration options can be found on the provider's website.

Contributing

Terraform is the work of thousands of contributors. We appreciate your help!

To contribute, please read the contribution guidelines: Contributing to Terraform - Okta Provider

Issues on GitHub are intended to be related to the bugs or feature requests with provider codebase. See Plugin SDK Community for a list of community resources to ask questions about Terraform.