Missing Redirect URL
9 min
Issue Summary
Users encounter an authentication error when starting Activate Studio, displaying the message: "A configuration issue is preventing authentication - check the error message from the server for details."
Error Details
- Error Code: AADSTS700218
- Error Message: "The request body must contain the following parameter: 'client_assertion' or 'client_secret'"
- Affected Product: Activate Studio
- Root Cause: Missing redirect URL configuration in Azure AD application registration for Activate Studio
Symptoms
- Activate Studio fails to authenticate during startup
- Authentication dialog displays configuration error
- Users cannot proceed past the login screen in Activate Studio
- Error references trace ID and correlation ID for troubleshooting
Root Cause
The Azure AD application registration for Activate Studio is missing the required redirect URL (http://localhost) for the Mobile and Desktop Application platform configuration. This prevents the authentication flow from completing successfully when users launch Activate Studio.
Resolution Steps
Step 1: Access Azure Portal
- Navigate to the Azure Portal
- Sign in with administrative credentials
- Go to Entra ID > App registrations
- Locate and select your Activate Studio application registration
Step 2: Configure Platform Settings
- In the app registration, select Authentication from the left menu
- Under Platform configurations, look for Mobile and desktop applications
- If the platform doesn't exist, click Add a platform and select Mobile and desktop applications
Step 3: Add Redirect URL
- In the Mobile and desktop applications section, add the following redirect URL:
http://localhost- Ensure the URL is entered exactly as shown (no trailing slash, no port number)
- Click Save to apply the changes
Step 4: Verify Configuration
- Confirm the redirect URL appears in the list
- Check that the platform is properly configured
- Note the Application (client) ID for reference
Step 5: Test Activate Studio Authentication
- Restart Activate Studio
- Attempt to authenticate
- Verify successful login completion
Prevention
- Always include http://localhost as a redirect URL when configuring Azure AD for Activate Studio
- Document platform-specific redirect URLs during initial Activate Studio setup
- Include authentication configuration in Activate Studio deployment checklists
- Test authentication flows in all target environments before deploying Activate Studio
Additional Notes
- This configuration is specifically required for Activate Studio as a native application
- Web applications require different redirect URL formats
- Changes to Azure AD configuration may take a few minutes to propagate
- Always test Activate Studio authentication after making configuration changes
Related Information
Support Information
If this resolution doesn't solve the Activate Studio authentication issue:
- Verify the Application (client) ID matches your Activate Studio configuration
- Check that the user has appropriate permissions to access Activate Studio
- Review Azure AD audit logs for additional error details
- Contact your system administrator or Azure support for further assistance