Hybrid Auth Troubleshooting

Use this guide to diagnose common Hybrid Auth implementation issues.

Hybrid Auth Not Applying

Validate route rules and order in Business Manager.
Verify hostnames and target origin configuration.
Confirm cart/checkout routes still map to intended origin.
Check hybrid route ownership guidance for your architecture: Storefront Next Hybrid Storefront Routing Matrix or PWA Kit Hybrid Storefront Routing Matrix (PWA Kit).

Use proxy routing for localhost, not production eCDN settings.
Confirm ODS/PIG-specific settings align with environment requirements.
Confirm environment-specific setup for your architecture: Storefront Next Set Up Hybrid Proxy Locally or PWA Kit Configure a Hybrid Storefront with Hybrid Auth (PWA Kit).

If session-bridge authentication fails with the error Cannot construct SLAS session-bridge URL: no ACTIVE SCAPI short code found for this organization, the ODS realm has no active SCAPI short code.
Generate a dedicated short code for the realm in Business Manager to resolve the error. No Support ticket is required. The previously shared common short code (kv7kzm78) still works, but a dedicated short code is required for SLAS hybrid authentication.
For instructions, see Base URL and Request Formation and Generate a Short Code and Create an API Client ID.