Resolving auth checker configuration issue in AEM Cloud Services Dispatcher
This article addresses a validation error encountered when deploying dispatcher code with the auth_checker configuration in Adobe Experience Manager (AEM) Cloud Services Dispatcher. The error occurs due to incorrect placement of the /auth_checker directive within the farm file. This guide provides steps to correctly position the auth_checker directive, ensuring successful deployment and enabling secured caching in AEM Cloud Services Dispatcher.
Description description
Environment
Adobe Experience Manager (AEM) as a Cloud Service - Sites
Issue/Symptoms
When deploying dispatcher code with the auth_checker configuration for Permission Sensitive Caching, the deployment fails with a validation error. The error message is:
Dispatcher configuration validation failed:entry not recognized: 'auth_checker'
This error occurs because the /auth_checker directive is incorrectly placed within the farm file, causing validation failure during deployment.
Resolution resolution
To resolve this issue, ensure the /auth_checker directive is placed correctly in your dispatcher farm file. Follow these steps:
- Open your dispatcher farm file where
auth_checkeris configured. - Verify that
/auth_checkeris not nested within cache-related sections or directives. - Move
/auth_checkeroutside of any caching configurations if it is incorrectly placed. - Save and validate your updated farm file locally before deploying.
- Deploy your updated dispatcher configuration through the Cloud Manager pipeline.
After making these adjustments, validate that the build passes without errors during deployment and that the auth_checker functionality works as intended in your environment.
By ensuring proper placement of /auth_checker, you can avoid validation errors and enable secured caching successfully in AEM Cloud Services Dispatcher.