Authorization

Authorize an account from the current Okta org

This procedure explains how to create a new connection for your current Okta org. This is the Okta org you used to launch this Workflows environment.

If you want to create a new connection for a different Okta org, see the section Authorize an account from another Okta org below.

Requirements

To perform this procedure:

  • You must be assigned to the Okta Workflows OAuth app.

  • You must have Super Admin credentials.

You also need the following information for authorizing your Okta account:

  • Domain: Your Okta org domain. If the URL of your Okta org is https://yourcompany.okta.com, then your domain is yourcompany.okta.com.

  • Client ID and Client Secret: The client ID and client secret from your Okta Workflows OAuth app. To find this, go to Okta Admin Console > Applications > Okta Workflows OAuth app > Sign On tab > Sign On Methods.

Procedure

Back in Okta Workflows Console,

  1. Go to Connections.

  2. Click +New Connection. All available connectors appear.

  3. Select the Okta connector. New Connection window appears.

  4. In the New Connection window, enter the Connection Nickname. This is the display name you want to appear in your list of connections.

  5. Enter Domain, Client ID, and Client Secret.

  6. Click Create.

The new connection appears in the Connections list.

Authorize an account from another Okta org

This procedure explains how to create a new connection for an Okta org different from your current org.

If you want to create a new connection for the current Okta org, see the section Authorize an account from the current Okta org.

This task includes the following procedures:

  1. Create an OpenID Connect web app in the target Okta org

  2. Configure the OpenID Connect web app

  3. Authorize an account from the target Okta org

Procedure

1. Create an OpenID Connect web app in the target Okta org

In the Okta Admin console of your target Okta org,

  1. Go to Applications > Applications > Add Application.

  2. Click Create New App. Create New App pop-up window appears.

  3. In the window, select Platform as Web and Sign-on Method as OpenID Connect. Create OpenID Connect Integration page appears.

  4. On the page, enter your Application name. This is the app display name.

  5. Enter the Login Redirect URI for the app.

    • For Preview org, enter https://oauth.workflows.oktapreview.com/oauth/okta/cb.

    • For Production org, enter https://oauth.workflows.okta.com/oauth/okta/cb.

  6. Click Save.

The app is created and appears on the Applications page.

2. Configure the OpenID Connect web app

In the Okta Admin console,

  1. Go to Applications > Applications.

  2. Select your newly created application.

  3. On the General tab, click Edit.

  4. In the Allowed Grant Types list, select Refresh Token.

  5. Click Save.

  6. Select the Assignments tab, and then click Edit.

  7. Assign the app to the appropriate users. You can assign it to individual people or to groups. Note: The user must be a Super Admin.

  8. Save your assignments.

  9. On the Okta API Scopes tab, grant consent for the scopes required for your use cases.

  10. Click Save.

The app is now configured and an assigned user can create a new connection for this org.

3. Authorize an account from the target Okta org

Requirements

To perform this procedure:

  • You must be assigned to the OpenID Connect web app created in the previous procedures.

  • You must have Super Admin credentials.

You also need the following information for authorizing your Okta account:

  • Domain: Your Okta org domain. If the URL of your Okta org is https://yourcompany.okta.com, then your domain is yourcompany.okta.com.

  • Client ID and Client Secret: The client ID and client secret from your OAuth2 app. To find this, go to Okta Admin Console > Applications > Your OpenID Connect web app > Sign On tab > Sign On Methods.

Back in the Okta Workflows Console,

  1. Go to Connections.

  2. Click +New Connection. All available connectors appear.

  3. Select the Okta connector. New Connection window appears.

  4. In the New Connection window, enter the Connection Nickname. This is the display name you want to appear in your list of connections.

  5. Enter Domain, Client ID, and Client Secret.

  6. Click Create.

The new connection appears in the Connections list.

Scopes for the Okta connector

Grant scopes in the Okta Workflows OAuth

In the Okta Workflows Console,

  1. Go to Applications > the Okta Workflows OAuth app > Okta API Scopes. A list of available scopes appears.

  2. Click the Grant button for the scope(s) you want to grant. A success message appears.

List of available scopes in the Okta connector

Scopes with an asterisk are not configurable through the Okta Workflows OAuth app.

  • openid*

  • profile*

  • email*

  • phone*

  • address*

  • groups*

  • offline_access*

  • okta.apps.manage

  • okta.apps.read

  • okta.clients.manage

  • okta.clients.read

  • okta.clients.register

  • okta.eventHooks.manage

  • okta.eventHooks.read

  • okta.events.read

  • okta.factors.manage

  • okta.factors.read

  • okta.groups.manage

  • okta.groups.read

  • okta.idps.manage

  • okta.idps.read

  • okta.inlineHooks.manage

  • okta.inlineHooks.read

  • okta.linkedObjects.manage

  • okta.linkedObjects.read

  • okta.logs.read

  • okta.policies.manage

  • okta.policies.read

  • okta.roles.manage

  • okta.roles.read

  • okta.schemas.manage

  • okta.schemas.read

  • okta.users.manage

  • okta.users.read

To request other scopes for the Okta connector, contact Okta support.