https://github.com/elastic/terraform-okta-aws
Terraform modules for configuring Okta SSO in AWS
https://github.com/elastic/terraform-okta-aws
conventions okta okta-aws okta-integration saml terraform-modules
Last synced: 8 months ago
JSON representation
Terraform modules for configuring Okta SSO in AWS
- Host: GitHub
- URL: https://github.com/elastic/terraform-okta-aws
- Owner: elastic
- License: apache-2.0
- Created: 2020-02-28T02:07:19.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-08T19:28:21.000Z (about 1 year ago)
- Last Synced: 2025-01-28T20:58:38.532Z (9 months ago)
- Topics: conventions, okta, okta-aws, okta-integration, saml, terraform-modules
- Language: HCL
- Homepage:
- Size: 321 KB
- Stars: 7
- Watchers: 6
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Okta AWS Terraform Modules
**NOTE**: This module uses Terraform 12 syntax. If you're using Terraform 11, see [Usage](#usage).
This repo contains Terraform modules for setting up/connecting AWS account(s) with an Okta AWS app. A Terraform module refers to a self-contained packages of Terraform configurations that are managed as a group.
Okta's integration with Amazon Web Services (AWS) allows end users to authenticate to one or more AWS accounts and gain access to specific roles using single sign-on with SAML.
For a detailed explanation of Okta SSO setup with AWS, see the [Okta SAML 2.0 AWS Guide](https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Amazon-Web-Service).
This module can be used to setup an account for both scenarios supported by Okta:
* [*"Connect Okta to a single AWS account"*](https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Amazon-Web-Service#scenarioA)
* [*"Connect Okta to multiple AWS accounts"*](https://saml-doc.okta.com/SAML_Docs/How-to-Configure-SAML-2.0-for-Amazon-Web-Service#scenarioB)
# Conventions
This module adheres to [Terraform Module Conventions](https://www.terraform.io/docs/modules/index.html) and has the following folder structure:
* **modules**: This folder contains the reusable code for this Terraform Module, broken down into one or more submodules.
* **examples** : This folder contains examples of how to use the submodules.
# Contributing
* Please create issues for bugs/feature requests.
* Create issues before creating pull requests and reference them in the pull request (so there is proper context and justification for a change).
* Follow the [Terraform Module Conventions](https://www.terraform.io/docs/modules/index.html) when contributing.
# Versioning
This module follows semantic versioning.
# Usage
When using these modules in your own code, you will need to use a Git URL with a ref attribute that pins you to a specific
version of the modules, such as the following example:
***Terraform 11***:
```hcl-terraform
module "okta_master" {
source = "github.com/elastic/terraform-okta-aws.git/modules/master?ref=v0.1.1"
}
module "okta_child" {
source = "github.com/elastic/terraform-okta-aws.git/modules/child?ref=v0.1.1"
}
```
***Terraform 12***:
```hcl-terraform
module "okta_master" {
source = "github.com/elastic/terraform-okta-aws.git/modules/master?ref=v1.1.1"
}
module "okta_child" {
source = "github.com/elastic/terraform-okta-aws.git/modules/child?ref=v1.1.1"
}
```
After completing the setup, AWS roles can be assumed from Okta:
