Create SWA app integrations using AIW

A SWA app integration provides Single Sign-On (SSO) to external applications that don't support proprietary federated sign-on methods. SWA works with any web-based application.

Before you begin

To prevent issues with inline instructions in your app integrations, open your browser settings and add Okta to your list of sites that can always use cookies. See Allow third-party cookies.

Task 1: Launch the Wizard

  1. In the Admin Console, go to Applications > Applications.
  2. Click Create App Integration.
  3. To create a SWA integration, select SWA - Secure Web Authentication as the Sign-on method.
  4. Click Next.

Task 2: Configure general app settings

The SWA App Wizard has two sections:

  1. General Settings:
    • App name: Specify a name for your integration.


      The name can only consist of UTF-8, 3-byte characters.

    • App's login page URL: Enter the full URL of the sign-in page for your SWA application. This URL may be different from the landing page.
    • Advanced Settings > Redirect URL: Click the Show Advanced Settings link to show the Redirect URL field. This additional field allows you to specify a redirect URL for your application.
    • Optional. App logo: Add a logo to accompany your integration in the Okta org. The logo file must be PNG, JPG, or GIF format and be smaller than 1 MB in size. For best results, use a PNG image with a transparent background and a landscape orientation. Use a minimum resolution of 420 x 120 pixels to prevent upscaling.
    • App visibility: Choose whether to show or hide your integration from your end-users' homepage. Also, choose whether to show or hide your integration from the Okta Mobile app on your end-users devices.
    • App type: If your company created the integration and it is not intended for public use, select This is an internal application that we created.
  2. Configure how your users sign in:
    • Who sets the credentials?: Choose who sets the initial password and username credentials: your end users or your org administrator.
    • Application username: Choose the format for the default username value when assigning the integration to end users.
    • Update application username on: Select how you want the app integration to handle any updates to the user's Okta username.
  3. Click Finish.

Next steps