Adding Kaspersky Sandbox servers to the Kaspersky Endpoint Agent list

If you have enabled the integration with Kaspersky Sandbox, you can add Kaspersky Sandbox servers to the Kaspersky Endpoint Agent list.

You can add multiple Kaspersky Sandbox servers.

For a particular policy, add servers that are part of the same cluster. If servers belong to different clusters, the outcome is unpredictable.

All servers in the cluster are peers regardless of which server was used as the base for creating the cluster. Processing the same object on any server in the cluster will yield the same result.

The Kaspersky Sandbox application balances load among the servers. Objects that Kaspersky Endpoint Agent sends for processing in Kaspersky Sandbox are processed on the least busy server.

To let the Kaspersky Sandbox cluster process objects from Kaspersky Endpoint Agent, you must add at least one server from the cluster to Kaspersky Endpoint Agent when integrating Kaspersky Endpoint Agent with Kaspersky Sandbox.

Kaspersky Endpoint Agent application's list of Kaspersky Sandbox servers only displays the servers that you have added to the list. Nevertheless, objects can be processed by any server in the cluster thanks to load balancing. The current list of servers in the cluster is displayed in the web interface of Kaspersky Sandbox.

It is recommended to add all servers of the cluster to Kaspersky Endpoint Agent.

Kaspersky Endpoint Agent can connect to a different Kaspersky Sandbox server in the list if one of the following errors occurs:

• Kaspersky Sandbox response timeout (connection timeout).
• Kaspersky Sandbox unavailable (error code 503 or 504).
• Self-diagnosis problem other than a license problem (error code 500).

When you delete a server from a cluster, the following object processing scenarios are possible:

• If there is still at least one server from the cluster with a current IP address or FQDN in the list of Kaspersky Sandbox servers in the Kaspersky Endpoint Agent application, Kaspersky Sandbox continues to process objects from Kaspersky Endpoint Agent.
• If no servers from the cluster remain in the list of Kaspersky Sandbox servers in the Kaspersky Endpoint Agent application, or if IP addresses or FQDNs of cluster servers are not current, Kaspersky Sandbox cannot receive and process objects from Kaspersky Endpoint Agent.

  For correct processing of objects, at least one server from the Kaspersky Sandbox cluster must be added to Kaspersky Endpoint Agent.

To add Kaspersky Sandbox servers to the Kaspersky Endpoint Agent list:

1. Open the Kaspersky Security Center Administration Console.
2. In the console tree, select the Policies folder.
3. Select Kaspersky Endpoint Agent policy and open its properties window in one of the following ways:
   • Double-click the policy name.
   • Select Properties in the policy context menu.
   • Select the Configure policy settings item in the right part of the window.
4. In the Kaspersky Sandbox integration section select the Kaspersky Sandbox integration settings subsection.
5. In the Kaspersky Sandbox integration settings group of settings, enable the Enable Kaspersky Sandbox integration setting.
6. Under Kaspersky Sandbox integration settings, turn on or off the Connect using the proxy server option if this is configured in general settings.

   This setting is disabled by default. The application connects to Kaspersky Sandbox only directly and does not use the general proxy server connection settings. You can enable this option if you want the application to use the general proxy server connection settings when connecting to Kaspersky Sandbox server.

7. Under List of Kaspersky Sandbox servers, click Add.

   The Server properties window opens.

8. Enter the IP address or fully qualified domain name of the Kaspersky Sandbox server and the port used for connecting to the server.
9. Click Add.

   The added server is listed in the server table.

10. Repeat the steps to add each Kaspersky Sandbox server to the list.
11. In the upper right corner of the settings group, change the switch from Unaffected by policy to Under policy.
12. Click Apply button and then click OK.

Kaspersky Sandbox servers are added to the Kaspersky Endpoint Agent list.