HTTP(S) Proxy agent settings

This dialog box enables you to configure the Service Virtualization HTTP(S) Proxy agent. The agent handles communication between a client and a real or virtual service.

To access
  1. From the main menu, select Tools > Options.
  2. Click Agents.
  3. Under HTTP(S) Proxy, select a configuration.
Important information
  • For additional important configuration information, see the task Configure the HTTP(S) Proxy agent.
  • For Java-based clients running on OpenJDK or JDK 6 (or later) with self-signed certificates, you may need to add the “” startup parameter, or the client may reject communication with the HTTPS Agent. For more details, see your Java documentation.

  • You can define multiple configurations for each agent.
Relevant tasks
See also Service Virtualization agents

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element Description
<left pane>

Displays the server configured for your project.

Expand the server to display the available agents and configurations.


Enables you to define additional configurations of the agent.

Delete Deletes the selected configuration.

Creates an additional configuration of the agent by copying the selected configuration. You can then modify the configuration settings.

Note: By default, the configuration is created with a sequential unoccupied port number.


Saves the selected agent configuration as a file. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

Export All Exports all agent configurations on the selected server. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

Enables you to select an exported agent configuration file stored on the file system. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

If the configuration file you are importing contains multiple configurations, you can select which configurations you want to import.

If you choose to import an agent configuration that is identical to a configuration that already exists on your server, you can choose to overwrite your existing configuration, or create a new, additional configuration.

Agent State The current status of the agent. Values include Running, Not Running.
Test Configuration link

Tests the configuration based on the settings you select. If Service Virtualization identifies any problems in your configuration, the details are displayed.

Enable SSL Client Authentication

Changes the SSL handshake between a client and a virtual service. It doesn't have any impact on the SSL handshake between the virtual service and a real service.

When checked, the HTTP agent (which has SSL enabled) requests an SSL client certificate from the client invoking a virtual service. This can be useful where you have multiple SSL client certificates in the Credential Store, and you want a virtual service to authenticate to the real service with the same certificate that the client is using, since this can change the behavior of the real service.

Note: This additional SSL handshake step has some performance overhead and is disabled by default.

Is Enabled Turns the agent on and off.
Name Enter a name for the configuration or accept the default name.
Host The name by which the agent is visible to client applications. It may be left empty.
Timeout The period of time the agent waits before stopping attempts to communicate with the real service.
HTTP Proxy Settings Port: the port for HTTP communication.
HTTPS Proxy Settings Port: the port for HTTPS communication.
CA Certificate File The Certification Authority certificate file used to generate host certificates.
Private Key The private key for the certificate file.

The password for the private key.

Select Show Password to display the password in this dialog box.

Use another proxy server to communicate with real services

Enables you to configure proxy chaining. You can forward the HTTP(S) communication between the HTTP(S) Proxy agent and the real service through an additional proxy.

Click Settings to open the Proxy Settings dialog box. For details, see Proxy Settings dialog box.

Back to top