Skip to main content
Easy setup through Okta OIN API Integration Service marketplace
The Client Secret integration method allows you to quickly connect to your Okta organization through the OIN (Okta Integration Network) marketplace. This is the easiest way to set up the integration, though it’s less secure than the Private Key method.

​
Prerequisites

Before you begin, ensure you have:
  • Okta Super Admin or Application Administrator access
  • Your Okta organization domain
  • Permissions to create API Service Integrations

​
Setup guide

​
Install integration from Okta API Integration Store

1

Access Okta API Service Catalog

Login to your Okta Admin Console and navigate to the API Service Catalog
Custom
2

Find integration

Search for “Ravenna” in the API Service Catalog and select it
3

Configure Domain and Client ID

Configure your Okta domain and note the Client ID that will be generated
Custom
4

Get Client Secret

Copy the Client Secret that is generated for your integration
Custom
5

Grant Required Scopes

Ensure the integration has the following Okta API scopes:
  • okta.users.read
  • okta.users.manage
  • okta.groups.read
  • okta.groups.manage
  • okta.apps.read
  • okta.apps.manage

​
Add integration

1

Navigate to integrations

Go to Settings > Integrations
Custom
2

Select Okta Integration

Choose Okta from the available integrations
Custom
3

Choose Client Secret Method

Select Client Secret as your authentication method
4

Enter Integration Details

Provide the following information:
  1. Okta Domain: Your Okta domain (e.g., https://your-org.okta.com)
  2. Client ID: The Client ID from your Okta integration
  3. Client Secret: The Client Secret from your Okta integration
    Custom
5

Complete Setup

Click Add Okta to complete the integration setup

​
Troubleshooting

Cause: Client ID or Client Secret is incorrectSolution:
  • Verify the Client ID and Client Secret are copied correctly
  • Ensure there are no extra spaces or characters
  • Check that the integration still exists in Okta
  • Try creating a new integration if credentials are lost
Cause: Missing required API scopesSolution:
  • Verify all required scopes are granted in Okta
  • Check that the integration has Application Administrator role
  • Ensure Group Administrator role is assigned
  • Try disconnecting and reconnecting with all scopes
Cause: Incorrect Okta domainSolution:
  • Verify the domain matches your Okta organization (e.g., https://your-org.okta.com)
  • Ensure the domain is active and accessible
  • Check for typos in the domain name

​
Features

Once connected, you can use Okta actions in workflows:

Okta Actions

Manage user group memberships, assign applications, and check group membership for access management