Add existing app integrations

The Okta Integration Network (OIN) contains thousands of prepared app integrations. As an admin, you can add these integrations to your org and assign them to your end users. After end users sign in to their Okta End-User Dashboard, these app integrations appear on their dashboard, giving them one-click access to the applications they need.

This topic covers adding and setting up app integrations that exist in the OIN. They only require the administrator to add the integration and configure it to work with their particular Okta instance and configuration.

About admin roles for this task

The administrator running this task must be a super admin for the Okta org.

After the app integration is added to the Okta org, app admins can configure and assign the app integration to the appropriate users and groups.

Before you begin

The admin must be signed in to the Okta Admin Console.

Add an app integration

To add an existing app integration to your org:

  1. In the Admin Console, go to ApplicationsApplications.
  2. Click Browse App Catalog.
  3. To search for the app integration, perform one of these two options:
    • Type the name of the specific app integration into the Search... bar. You can click the name in the dropdown list or click See All Results to have everything displayed as tiles in the main panel. Click the tile to open the details page for the app integration.
    • Choose a Use Case and optionally select one or more functionalities to filter the results. When you see the desired app integration in the main panel, click it to open the details page for more information about the integration.
  4. Determine if this is the correct app integration for your needs. The Overview tab on the details page shows a detailed description of the app integration and, if available, the Okta verification status:
    • Okta Verified: This integration was created by Okta or by Okta community users, then tested and verified by Okta.
    • Community Created or Unverified: This integration was created by the community and has shown some evidence of quality, such as active usage or multiple community members using it. However, Okta hasn't tested this app integration, and it isn't officially supported.
  5. Click the Capabilities tab on the details page to see the supported Access and Provisioning features of the app integration.
  6. Optional. If you can't find the desired app integration in the OIN App Catalog, click Back to Add Application and click Create New App. This launches the App Integration Wizard (AIW), which allows administrators to create custom app integrations for their org. See Create custom app integrations.
  7. When you find the app integration you want, click Add on the details page.
  8. Enter the required information under General Settings, and then click Next.
  9. On the Sign On Options page, select one of the Sign on methods. The sign-in options available depend on the access protocols supported by the app integration. See Configure Single Sign-On options.

    For SWA app integrations, you can't configure the sign-in options when Sync Password is configured as a provisioning option.

  10. In the Application username format dropdown list, select a format for Okta to use as the default username value when assigning the app integration to users. If you select None and the app integration has password or profile push provisioning features, then Okta prompts you to enter the username manually when you assign the app integration.
  11. In the Update application username on dropdown list, select how you want the app integration to handle any updates to the user's Okta username:
    • Create Only: The Okta username is exchanged with the external application when the admin first assigns the app integration to the user. Any future updates to the Okta username aren't applied to the external account.
    • Create and Update: The Okta username is exchanged with the external application when the admin first assigns the app integration to the user. If their profile is updated later, Okta updates the username with the external application. See Automatically update an app username.
  12. Password reveal: For SWA app integrations, you can allow end users to see the password used to connect to the external application. This feature is helpful if end users need to enter a long, complicated, and randomly generated password into another device. See Reveal the password of an app integration.
  13. Click Done.

Okta adds an instance of the app integration to your org, and you can now assign it to your end users. See Assign app integrations.

If you need to update the settings for your app integration, including changing sign-in options, see Configure settings for app integrations.

When you add an app integration from the OIN, Okta generates an Update application event that appears in the System Log. This event reflects the creation of a new instance of an existing app.

When you create an app using the App Integration Wizard (AIW), Okta generates a Create application event that appears in the System Log. This event reflects the creation of a new app.

Next steps

Configure Single Sign-On options

Assign app integrations

Configure settings for app integrations