The default application feature automatically redirects a user to a specific application when using the custom domain without any application context. When a custom domain is first created, the default application is the Okta Dashboard. This article shows how to configure a custom OIDC application to be used as the default application on a custom domain.

• SPA or Web OIDC application
• Okta Sign In Widget

Before an OIDC application can be used, it is important that the application is properly configured to authenticate as an application within Okta and has the initiate login URI set up. This can be configured within the General tab. Within the General tab, edit the General settings and perform the following:

1. Update the Login Initiated By setting to "Either Okta or App"
2. Update the Initiate Login URI to the URI where the application login page is.

Once these settings are set up, the application can be set to the default OIDC application for the Sign-In Widget by performing the following:

1. Navigate to the Okta Admin Console.
2. Navigate to Customization > Branding > Pages > Sign In Page > Configure > Settings.
3. Set the Default application for Sign-In Widget to any application within the dropdown menu.
4. Once configured, click Save.

 
After these settings are applied, users who attempt to access Okta using the Custom Domain will be redirected to the Initiate Login URI to authenticate into the OIDC application.
 

Related References

• Set up a default app redirect
• How to Make the OIDC/OAuth App Visible in Okta Dashboard and what Login Flows are Available