your processes use a service that connects to a server through a
proxy server, configure Workbench and the AEM forms Server so that
the connection is successful. For example, if your network is configured
such that you must use a proxy server to connect to a server that
hosts a web service, configure Workbench and the AEM forms Server.
Also, when you configure the connection properties of a service
or service operation, use connection parameters, such as service
URLs, that the proxy server is configured to recognize. When the
proxy server receives the service request, it forwards the service
request to the correct server.
For example, the Invoke Web Service operation that the Web Service
service provides requires that you specify the URL of the web service
WSDL. The value of the WSDL URL property must be a value that the
proxy server recognizes as a service request to pass on to another
For details about connection information to use with your proxy
servers, contact the administrator of your proxy server.
To configure Workbench, add the following lines
to the workbench.ini file:
-Dhttp.proxyHost=[name of proxy server]
-Dhttp.proxyPort=[port used by proxy server]
-Dhttp.nonProxyHosts=[Names of servers to connect to directly]
you are connecting to multiple servers through the proxy server,
separate each server name with the pipe character (|).
example, the server named
must be connected through
the proxy server named
by using port 80. However,
the servers on the foo.com domain and localhost can be connected
to directly, without using the proxy server. The following lines
must be added to the workbench.ini file:
file is located in the
/AEM forms Workbench/workbench
is the location where you
Modify the workbench.ini file:
Open the workbench.ini
file in a text editor.
Add the lines that are required for configuring the use of
the proxy server.
Save the workbench.ini file and restart Workbench.
Configuring the AEM forms Server
To configure the AEM forms Server,
configure the following options for Java Virtual Machine (JVM) that
runs the server:
Indicates the name of the proxy server
Indicates the port that the proxy server uses
A list of servers that can be connected to directly, without
using the proxy server
For example, the server named
be connected through the proxy server named
port 80. The servers on the foo.com domain and localhost services
can be connected to directly, without using the proxy server. To
configure a JBoss Application Server that runs the AEM forms Server,
the following line must be added to the run.bat file:
set JAVA_OPTS=%JAVA_OPTS% -Dhttp.proxyHost=proxy1 -Dhttp.proxyPort=80 -Dhttp.nonProxyHosts="*.foo.com|localhost"
following table lists links to AEM forms documentation that provide
tips about how to configure JVM options on your application server.
Digital signatures and proxy servers
In some AEM forms environments, users can access the AEM
forms Server either by using a proxy server or by accessing the
server directly. For processes that use the Signature service, all
of the users must access the AEM forms Server in the same way: either
directly or through the same proxy server.
For example, an external user digitally signs a PDF form and
submits it to the proxy server. The process sends the form to an
internal user who connects to the AEM forms Server directly. When
the internal user opens the form, the digital signature is invalidated
and an error occurs when the user tries to submit the form.