Set up SSO with Okta

In this article, we cover the steps you need to complete in Okta. For an end-to-end guide on enabling SSO for your Airwallex organisation see Enable SSO for your organisation. 

Create an Airwalex app in Okta

The following are the steps you’ll need to complete directly in Okta. 

Step 1: Create a custom OIDC application.

1. In the Okta Admin Console, navigate to Applications → Applications.
2. Click Create App Integration.

3. In the dialog, choose:

   

   • Sign-in method: OIDC – OpenID Connect
   • Application type: Web Application
4. Click Next.

Step 2: Configure the basic settings

The following are the required fields to enable the connection. Leave all other fields blank, or configure them according to your internal security requirements.

1. App name: enter a descriptive name (for example, Airwallex (SSO)).
2. Sign-in redirect URIs: copy the following Redirect URIs and paste them here.
   • https://www.airwallex.com/app/login/sso/callback
   • https://www.airwallex.com/app/integrations/home/oktasecurity/setup/domain/config
3. Click Save.

Step 3: Assign users or groups

1. Open the Assignments tab.
2. Click Assign → Assign to People or Assign to Groups.
3. Select the users or groups in your Okta tenant who should be able to sign in to Airwallex via SSO.
4. Click Assign, then Done.

Only users assigned to the app in Okta will be able to authenticate to Airwallex via SSO.

Step 4: Copy the OIDC credentials

From the app's General tab, copy:

1. Client ID
2. Client secret
3. Your Issuer URL (e.g. https://your-domain.okta.com)

Configure the Okta connection in Airwallex

After completing the steps above, return to Airwallex to finish setting up the connection. For detailed step-by-step instructions, see Enable SSO for your organisation.