When attempting to configure Client Initiated Backchannel Authentication (CIBA) for a Single Page Application (SPA), the option to enable the CIBA flow is not visible in the Okta Admin Console. Customers seeking to implement this flow will find that the toggle or configuration settings are missing from the application settings. Additionally, users may be unaware that CIBA requires the use of a Custom Authenticator App to process out-of-band authorization requests.
- Okta Identity Engine (OIE)
- Single Page Applications (SPA)
- Client Initiated Backchannel Authentication (CIBA)
- Application Configuration
- Custom Authenticator Apps (SDK-based)
Okta currently only supports the CIBA flow for the Web Application type. Single Page Applications (SPA) do not have the architectural requirements or internal configuration options to support the CIBA flow at this time. Furthermore, CIBA requires a backchannel communication path to a Custom Authenticator App built with the Okta Devices SDK to prompt the user for approval.
To use the CIBA flow, the application must be configured as a Web Application. Additionally, a Custom Authenticator must be developed and configured to handle the push challenges.
Part 1: Configure the Web Application
- Log in to the Okta Admin Console.
- Navigate to Applications > Applications.
- Click Create App Integration.
- Select OIDC - OpenID Connect as the Sign-in method.
- Select Web Application as the Application type.
- NOTE: CIBA is not supported if the Single-Page Application option is selected.
- Click Next and configure the application settings.
- Once created, navigate to the General tab of the new Web App.
- In the Client Protocol section, click Edit.
- Under Allowed grant types, select Client Initiated Backchannel Authentication.
- Click Save.
Part 2: Enable Custom Authenticator App
Because CIBA relies on a "consumption" device to approve the login initiated by the "instruction" device, the following must be done:
- Develop a mobile application using the Okta Devices SDK.
- Register this app as a Custom Authenticator in the Okta Admin Console under Security > Authenticators.
- Ensure the user is enrolled in this Custom Authenticator to receive the CIBA push notification.
