View authorized OAuth clients

Prerequisites
  • OAuth > Client > Authorize permission

The Authorized Applications view lists the client applications allowed to operate in your organization and the OAuth scopes granted to them. From this view, you can modify what an app is allowed to do (its scopes), or revoke an app so that it can no longer run in your organization.

The Authorized Applications view and OAuth provide another way to authorize. Instead of using the Authorized Organizations feature to authorize users (such as partners) to use your org, the Authorized Applications view allows you to grant a scoped set of permissions and data in your Genesys Cloud organization to applications, integrations, and AppFoundry apps.

View authorized clients

To view your authorized clients, perform the following steps:

  1. Click Admin.
  2. Under Integrations, click Authorized Applications. The Authorized Applications view appears.

The following table lists and explains each column on the Authorized Applications view.

Column Description

App Name

Name of the authorized OAuth client application.

You can click the name of an application to change its scope or revoke its authorization.

Scope

The Scopes that the client is authorized to use. Scopes define what an app is allowed to do in your organization. For more information, see OAuth Scopes in the Genesys Cloud Developer Center.

State

The status of the application displays here. The statuses include:

  • Approved
  • Pending
  • Revoked

Use the selected drop-down to select the applications with a particular status.

Role

The number of roles available in each application displays here.

Actions

Each row offers a menu in the Actions column. To open the menu, click More . Then select a command:

  • To change an application’s scope, select Edit Authorization.
  • To revoke an application’s ability to run in your organization, select Revoke Authorization.

Click each section to view additional information.

To modify the scopes assigned to an application, perform the following steps:

  1. Locate the row for the application you want to manage.
  2. In the Actions column, click More .
  3. Select Edit Authorization. Application details appear.
    Tip: Clicking the app’s name is another way to open its application details.
  4. Select or unselect scopes listed for the app.
  5. Click Save.

Revoke authorization if a security flaw becomes known, or if an app should no longer be used in your org.

To disallow an app from running in your organization, perform the following steps:

  1. Locate the row for the application you want to revoke.
  2. In the Actions column, click More .
  3. Select Revoke Authorization. A dialog appears, prompting you to confirm this action.
  4. Click Revoke to revoke the application’s right to run in your organization.
  5. Click Cancel to dismiss the dialog without revoking its access.
    Note: Once you revoke an application, you cannot undo it. A revoked application won’t be able to get an access token anymore. To revoke an application again, you need to reauthorize it.