When attempting to perform the initial setup for an Okta Integration Network (OIN) application using Express Configuration, the process fails to complete. This issue typically manifests as an inability to establish a connection between Okta and the target application (such as Auth0) during the configuration wizard and may result in an HTTP 503 error.

• Okta Integration Network (OIN)
• Express Configuration
• Okta Identity Engine (OIE)
• Application Provisioning

This failure is generally caused by one of the following:

• The administrator performing the setup lacks the specific Express Configuration admin role within the Auth0 tenant.
• A mismatch or corruption in the PEM key exchange between Okta and the Auth0 dashboard.

To resolve this issue, ensure the correct administrative roles are assigned and regenerate the integration keys by following these steps:

Verify Auth0 Permissions

1. Log in to the Auth0 Dashboard.
2. Navigate to User Management > Users.
3. Select the user account attempting to perform the integration.
4. Click the Roles tab.
5. Click Assign Roles.
6. Select Express Configuration admin and click Assign.

Regenerate and Upload PEM Key

1. In the Okta Admin Console, restart the OIN Wizard for the specific application.
2. In the Express Configuration for Auth0 apps window, click Download Key (.pem) to save the certificate to the local device.
3. Open a new tab and log in to the Auth0 Dashboard.
4. Navigate to Applications > [Application Name].
5. Select the Okta Integration Network tab.
6. Click Create OIN Integration.
7. Upload the .pem file downloaded from Okta in Step 2.
8. Complete the configuration in the Okta OIN Wizard.

Related References

• Express Configuration with Okta