Create a SWA integration using AIW
A SWA integration provides Single Sign-On (SSO) for applications that don't support proprietary federated sign-on methods. SWA works with any web-based application.
Before you begin
Ensure that you add Okta to your browser's allow list for 3rd-party cookies to prevent errors in your integrations. See Allow Third-Party Cookies for detailed instructions.
Task 1: Launch the Wizard
- Verify that you are using the Admin Console. If you are using the Developer Console, you need to switch over to the Admin Console. If you see < > Developer Console in the top left corner of your console, click it, then click Classic UI to switch.
- In the Admin Console, go to Applications > Applications.
- Click Add Application.
- Click Create New App.
- To create a SWA integration, select Web as the Platform and Secure Web Authentication (SWA) for the Sign on method.
- Click Create.
Task 2: Configure general app settings
The SWA App Wizard has two sections:
- General Settings:
- Application name — Specify a name for your integration.
Note
The name can only consist of UTF-8, 3 byte characters
- App 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, a landscape orientation, and use a minimum resolution of 420 x 120 pixels to prevent upscaling.
- App visibility — Choose whether to hide your integration from your end-users' homepage. Choose whether to hide your integration from the Okta Mobile Apps Store 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.
- Application name — Specify a name for your integration.
- 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 — At what point is the username updated in the integration.
- Click Finish.
Next steps
- If your SWA integration is successful, when end users click the tile in their dashboard, the username and password fields are populated and the user signs on to the app automatically.
- Assign applications to users
- Assign an app integration to a group
- If your integration does not behave as expected, contact Okta support at support@okta.com for assistance.