Skip to content

Okta

Install Okta integration

The Okta integration can be found here. Please install it in your environments before proceeding with the steps below.

Connecting an Okta account

Warning
  • Admin or Super Admin role is required to use this API

  1. Click on Connect Account Click connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection link Get connection link

  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Okta account. Share connection link

  4. Select Okta Select Okta

  5. Choose how to connect: API Key or OAuth 2.0. Both ask for the Okta Domain (required): the host in your browser URL when you sign in to Okta. If the URL is https://acme.okta.com/, enter acme.okta.com. Enter Okta Domain

Connect with an API key

  1. Sign in to your Okta organization as a user with administrator privileges.
  2. In the Admin Console, select Security → API from the menu and then select the Tokens tab.
  3. Click Create Token, name your token, and click Create Token.
  4. Copy the token into the API Key field in Truto, enter the Okta Domain, and click Connect.

Connect with OAuth 2.0

With this method, the person connecting creates an OAuth app in their own Okta organization and enters its credentials on the connect form.

  1. In the Okta Admin Console, go to Applications → Applications → Create App Integration. Pick OIDC - OpenID Connect and Web Application.

  2. Under Grant type, select Authorization Code and Refresh Token. Set the Sign-in redirect URI to https://api.truto.one/connect/okta/callback.

  3. Save the app, then on its Okta API Scopes tab grant the okta.* scopes for the data you need.

  4. In Truto, enter the Okta Domain, and the app's Client ID and Client Secret (all required). Click Connect, then sign in to Okta and allow access.

  5. You should now see a connection successful message. You can now close this tab.

  6. Go to your Truto account, and you should see the new Okta integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.