DocumentationExperience Cloud KCS

AEM Forms Workbench connection fails due to SOAP services returning HTTP 503

Last update: October 7, 2026

This article describes how to troubleshoot and resolve situations where AEM Forms Workbench cannot connect to the AEM Forms server because required SOAP services are unavailable and return HTTP 503 errors.

Description description

Environment

Adobe Experience Manager Forms

Issue/Symptoms

  • When connecting AEM Forms Workbench to the AEM Forms server, the connection may fail even if the administrative interface is accessible.

  • Workbench logs may display errors such as:

    • Unable to validate user
    • ALC-DSC-099-000: com.adobe.idp.dsc.DSCRuntimeException: org.apache.axis.AxisFault: (503)Service Unavailable.

This indicates that the SOAP services endpoint, for example, http://<server>:<port>/soap/services, is unavailable.

Cause

The connection fails because the required SOAP services are unavailable and return an HTTP 503 error from the SOAP endpoint.

Resolution resolution

Follow the steps below to resolve the issue:

  1. Ensure that the AEM Forms server has fully completed startup. Check the application server logs for any deployment or service initialization errors.

  2. From the same machine where Workbench is installed, access the SOAP services endpoint, such as http://<server>:<port>/soap/services, using a web browser or a tool such as curl. Confirm that the endpoint responds and does not return an HTTP 503 error.

  3. If a reverse proxy, load balancer, firewall, or web application firewall (WAF) is in use, verify that:

    • Requests to /soap/* are correctly routed to the AEM Forms server.
    • HTTP POST requests are permitted.
    • The proxy or intermediary is not returning the HTTP 503 response.
    • The port, protocol, and context root configured in Workbench match the server configuration.

  4. Review the AEM Forms and application server logs for any errors related to SOAP service deployment or availability at the time of the failure.

  5. After confirming that the SOAP service is available, retry connecting with the existing credentials in Workbench.

To verify resolution, ensure that Workbench can successfully connect and validate the user without returning HTTP 503 errors.

recommendation-more-help
experience-cloud-kcs-help-kbarticles