Skip to main content

Integrate Okta Oauth 2.0

Last updated on

Overview​

Integrate Okta OAuth 2.0 to enable your users with existing Okta accounts to log in to the AccelByte Development Toolkit (ADT) Web. Okta Oauth 2.0 controls who is authorized to access a protected resource, like your web app, native app, or API service.

note

If you want to grant secure access to your application data, use the OAuth 2.0 protocol.

OAuth 2.0 has four important roles:

  1. The authorization server issues access tokens. In this case, Okta acts as the authorization server.
  2. The resource owner uses an access token to grant access to the resource server. In this case, your application’s Administrator is the resource owner.
  3. The client application requests the access token from Okta and passes it to the resource server.
  4. The resource server accepts and verifies the access token. In this case, the resource server is your application.

This guide will show you how to integrate ADT Web with Okta OAuth 2.0.

Prerequisites​

  • You need access to the Okta Admin console.
  • You need access to ADT Web as an Administrator.
info

Support question? Contact us at blackbox-support@accelbyte.net.

Configure Okta OAuth 2.0 for use with ADT​

Set up the OAuth 2.0 application​

Follow these steps to set up the application:

  1. Log in to Okta.

  2. Select Applications from the side bar.

  3. Click the Create App Integration button.
    Applications panel showing app integration button

  4. In the Sign-in method section, choose OIDC - OpenID Connect.

  5. In the Application type section, choose Web Application.

  6. Click Next.

    Next button

  7. On the New Web App Integration page, type in what you want to name the integration in the App integration name field. In this example, the integratio name is set to Blackbox.

  8. In the Sign-in redirect URIs field, enter your ADT URL in this format <your-blackbox-base-url>/auth.

  9. Leave the Sign-out redirect URIs blank.

    Leave Sign-out redirect URIs blank

  10. Scroll down to the Assignments section at the bottom of the page, choose the controlled access options to apply to your organization.

  11. Click Save.

    Save integration

Configure the ADT Web​

The details of your application integration are displayed on the Okta options screen. You need to note or copy the values for Client ID, Client Secret, and Okta Domain. You will be using these information to configure ADT Web.

To integrate ADT Web with Okta, follow these steps:

  1. In a new browser tab, log in to ADT Web as an Administrator.

  2. Choose your namespace.

  3. On the sidebar, select Integration menu, then select Okta.

    Select Okta

  4. On this page, fill in the values for the Client ID, Client Secret, and Okta Domain from Okta.

    note

    You need to add https:// at the beginning of the Okta domain name.

  5. Click Save changes.

    New web app integration page

Assign the user/group​

In Okta, give certain users or groups access to the OAuth application using the Assignments tab of the application.

Assignments panel

Last updated on