No commit activity in last 3 years
No release in over 3 years
This gem installs helper scripts to generate Terraform plans based on user or group data from Okta.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 3.1
~> 4.0
~> 0.2.0
 Project Readme

okta-terraform-generator

Build Status Gem

A command line helper to generate Terraform files based on data found in an Okta tenant.

Installation

This gem installs a okta-terraform-generator bin, to install it:

gem install okta-terraform-generator

Usage

The installed bin writes a file matching the name of the generator used in the current working directory (e.g. github_membership.tf when using the github_membership generator), so you'll want to be in the directory containing your Terraform plans when running okta-terraform-generator.

Running okta-terraform-generator will print available generators, running okta-terraform-generator GENERATOR_NAME will print generator specific usage.

Current Generators

The following resource generators are available:

  • github_membership

github_membership

Usage: okta-terraform-generator github_membership (options)

Options:
    -h, --github-token GITHUB_TOKEN  Specifies the GitHub API token (required)
    -a OKTA_GITHUB_ADMIN_GROUP,      Specifies the Okta group containing GitHub admin users (required)
        --okta-github-admin-group
    -e OKTA_ENDPOINT,                Specifies the Okta API endpoint (e.g. https://myorg.okta.com/api/v1) (required)
        --okta-endpoint
    -g OKTA_GITHUB_USER_GROUP,       Specifies the Okta group containing GitHub users (can be a comma separated list) (required)
        --okta-github-user-group
    -t, --okta-token OKTA_TOKEN      Specifies the Okta API token (required)
        --treat-suspended-as-active  Treat suspended users as active

Contributing

We welcome contributed improvements and bug fixes via the usual work flow:

  1. Fork this repository
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new pull request

License & Authors

Copyright 2018 Stephen Hoekstra <shoekstra@schubergphilis.com>
Copyright 2018 Schuberg Philis

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Code of Conduct

Everyone interacting in the this project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.