A command line helper to generate Terraform files based on data found in an Okta tenant.
This gem installs a okta-terraform-generator bin, to install it:
gem install okta-terraform-generator
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.
The following resource generators are available:
- 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
We welcome contributed improvements and bug fixes via the usual work flow:
- Fork this repository
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new pull request
- Author: Stephen Hoekstra (shoekstra@schubergphilis.com)
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.
Everyone interacting in the this project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.