DocumentationAEM 6.4Administering Guide

Enabling CRXDE Lite in AEM enabling-crxde-lite-in-aem

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

In order to ensure that AEM installations are as secure as possible, the security checklist recommends disabling WebDAV in production environments.

However, CRXDE Lite depends on the org.apache.sling.jcr.davex bundle to function properly, so disabling WebDAV will effectively disable CRXDE Lite as well.

When this happens, browsing to https://serveraddress:4502/crx/de/index.jsp will display an empty root node, and all HTTP requests to CRXDE Lite resources will fail:

404 Resource at '/crx/server/crx.default/jcr:root/.1.json' not found: No resource found

While this recommendation is intended to reduce attack surfaces as much as possible, system administrators might sometimes need access to CRXDE Lite in order to browse content or debug issues on production instances.

If disabled, you can turn CRXDE Lite on by following the below procedure:

  1. Go to the OSGi Components console at http://localhost:4502/system/console/components

  2. Search for the following component:

    • org.apache.sling.jcr.davex.impl.servlets.SlingDavExServlet

  3. Click the wrench icon next to it in order to see its configuration options:

    chlimage_1-80

  4. Create the following configuration:

    • Root path: /crx/server
    • Tick the box under Use absolute URIs.

  5. When finished using CRXDE Lite, make sure you disable WebDAV again.

You can also enable CRXDE Lite via cURL, by running this command:

curl -u admin:admin -F "jcr:primaryType=sling:OsgiConfig" -F "alias=/crx/server" -F "dav.create-absolute-uri=true" -F "dav.create-absolute-uri@TypeHint=Boolean" http://localhost:4502/apps/system/config/org.apache.sling.jcr.davex.impl.servlets.SlingDavExServlet

Other Resources other-resources

For more information on AEM 6 security features, see the following pages:

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8