Troubleshooting "Missing Auth Code" During OAuth Login

Q: Why do I receive a "Missing Auth Code" error when logging into the digiRunner Admin Console via OAuth?

A: This error typically occurs due to a Callback URL mismatch. If the URL configured in your system settings does not exactly match the one expected by your Identity Provider (IdP), the Admin Console fails to receive the authorization code during the OAuth flow.

To resolve this issue, verify and update the AC_IDP_ACCALLBACK_URL configuration:

1. Locate the Parameter

Navigate to System Configs > Setting in the Admin Console, and find the parameter: AC_IDP_ACCALLBACK_URL.

This parameter is mandatory for OAuth-based Admin Console logins.

2. Apply the Correct Configuration

The value must strictly follow this format (replace placeholders with your actual server info):

https://[your-ip]:[your-port]/dgrv4/ac4/idpsso/accallback

3. Troubleshooting Common Pitfalls

• Incorrect endpoint: Do not use URL patterns ending with /dgrv4/ssotoken/acidp/.../acIdpCallback. This format is not valid for AC_IDP_ACCALLBACK_URL.

• Parameter confusion: Do not confuse AC_IDP_ACCALLBACK_URL with other settings such as dgR Callback URL. These parameters serve different purposes and are not interchangeable.

Keywords: OAuth 2.0, Login Error, Admin Console, Missing Auth Code, AC_IDP_ACCALLBACK_URL