TerraportTerraport Cloud

Documentation

Learn how to use Terraport Cloud to automate importing Okta resources into Terraform and create pull requests with production-ready HCL.

Getting Started

Terraport Cloud helps IT and DevOps engineers import Okta resources into Terraform automatically. Instead of manually writing Terraform configuration, you select resources from your Okta org and we generate production-ready HCL that matches your existing repository's conventions.

Quick Start

  1. 1

    Create an account

    Sign up with email or GitHub. You'll start with a 14-day free trial.

  2. 2

    Connect GitHub

    Authorize Terraport Cloud to access your repositories where Terraform code lives.

  3. 3

    Connect Okta

    Add your Okta API token so we can read your org's resources.

  4. 4

    Create your first import

    Select resources, configure output options, and generate a pull request.

Complete the onboarding checklist to set up your workspace. You can always access settings later to modify your connections.

Connect GitHub

Terraport Cloud needs access to your GitHub repositories to analyze your existing Terraform code structure and create pull requests with generated configuration.

Authorization Steps

  1. 1. Go to Integrations in your dashboard
  2. 2. Click Connect GitHub
  3. 3. Select your GitHub organization or personal account
  4. 4. Choose which repositories to grant access to (you can select all or specific repos)
  5. 5. Confirm the authorization

Required Permissions

  • Read access to repository contents
  • Write access to create branches and pull requests
We never store your repository contents. Code analysis happens in real-time when you create an import, and generated files are only written to new branches.

Connect Okta

To import resources from your Okta organization, you need to provide an API token with read access to your org.

Creating an API Token

  1. 1. Sign in to your Okta Admin Console as a Super Admin
  2. 2. Navigate to Security → API → Tokens
  3. 3. Click Create Token
  4. 4. Name it something like "Terraport Cloud"
  5. 5. Copy the token value immediately (it won't be shown again)

Adding to Terraport Cloud

  1. 1. Go to Integrations in your dashboard
  2. 2. Click Connect Okta
  3. 3. Enter your Okta domain (e.g., your-company.okta.com)
  4. 4. Paste your API token
  5. 5. Click Connect to validate and save
Your API token is encrypted at rest using AES-256-GCM. We only use it to read resources from your Okta org—we never modify anything.

Creating Imports

The import wizard guides you through selecting Okta resources, configuring output options, and generating a pull request with Terraform configuration.

Import Wizard Steps

1. Select Resources

Browse your Okta inventory and select which resources to import. You can filter by type (Users, Groups, Apps, Policies) and search by name.

2. Configure Output

Choose naming conventions, file organization, and import strategy. The wizard analyzes your target repository to suggest conventions that match your existing code.

3. Review & Generate

Preview the resources to be imported, then generate Terraform HCL. Our AI ensures the code follows your repo's style and Terraform best practices.

4. Create Pull Request

Configure the branch name, PR title, and labels. Submit to create a pull request in your GitHub repository with the generated Terraform files.

Supported Resource Types

  • Users
  • Groups
  • Applications
  • Sign-On Policies
  • Authorization Servers
  • Policy Rules

Team Management

Invite team members to collaborate on imports. Each workspace supports unlimited team members with role-based access control.

Roles

Owner

Full access including billing, workspace deletion, and member management. Each workspace has one owner.

Admin

Can manage integrations, create imports, invite members, and access all settings except billing.

Member

Can create imports and view workspace data. Cannot modify integrations or invite others.

Inviting Members

  1. 1. Go to Team in your dashboard
  2. 2. Click Invite Member
  3. 3. Enter their email address and select a role
  4. 4. They'll receive an email with a link to join

Billing

Terraport Cloud uses a simple subscription model. Start with a 14-day free trial, then subscribe to continue using the service.

Standard Plan - $99/month

  • Unlimited imports
  • Unlimited workspaces
  • Unlimited repositories
  • Unlimited team members
  • AI-powered HCL generation
  • Audit log exports
  • Priority support

Managing Your Subscription

Access the billing portal from Billing in your dashboard to:

  • • Update payment method
  • • View invoices and payment history
  • • Cancel subscription

Settings

Configure your workspace preferences, manage integrations, and update account settings.

Workspace Settings

  • • Workspace name - Display name for your workspace
  • • Default repository - Pre-selected repo for new imports
  • • Default branch - Target branch for pull requests

Danger Zone

Deleting a workspace permanently removes all imports, integrations, and team members. This action cannot be undone.

Ready to get started?

Create your account and start importing Okta resources in minutes.

Get Started Free