Hybrid Auth Troubleshooting

Use this guide to diagnose common Hybrid Auth implementation issues.

• Confirm Hybrid Auth is enabled in Business Manager for the active site.
• Confirm storefront uses the expected SLAS client ID.

• Validate SLAS client scope includes sfcc.session_bridge.
• Confirm headless runtime forwards and accepts required cookies/headers.
• Confirm route ownership does not cause auth loops between origins.

• 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).