Define Communication Settings Between the Agent and the ESM Server

By default, the Traps agent applies a No Connection policy to all unknown executable files upon startup. The policy remains in place until the Traps agent can perform the ESM Server discovery to build a list of available servers in order of shortest path.
After the Traps agent builds the list of available servers and a user opens an unknown executable file, Traps queries the first ESM Server in the list to determine the hash verdict. If that server is unreachable or is unable to respond to the request within the maximum allotted time, the Traps agent stops trying to reach the ESM Server and assigns the executable file a No Connection verdict. If the user opens another unknown executable file before Traps determines that the ESM Server is unavailable, it will also query the first ESM Server in the list to determine the hash verdict. However, if the user opens another unknown executable file after the Traps agent determines that the ESM Server is unavailable, Traps will query the next ESM Server in the list.
The Traps agent also periodically polls the ESM server list to determine which servers are available and, of those available, which servers are closest. Other events, such as an IP address change on the endpoint, can also trigger Traps to rebuild the list of ESM Servers.
Use the following workflow to change the timeout and intervals for establishing communication with the ESM Server.
  1. Create a new agent settings rule.
    Select
    Settings
    Agent
    Settings
    and then
    Add
    a new rule.
  2. Define the communication settings between the Traps agent and the ESM Server.
    Select
    Communication Settings
    and then select one or more of the following options:
    • Set Agent-WildFire Process Verdict Timeout
      —Specify the amount of time (in seconds) that Traps will wait for the ESM Server to respond to a verdict request (default is 10). After the timeout period expires, Traps assigns the process a
      No Connection
      verdict. Traps will attempt to reestablish communication only if a user clicks
      Check-In Now
      on the Traps Console, or if Traps needs to query the ESM Server for unknown hash verdicts.
    If your endpoints frequently lose their connection with the server, consider increasing the timeout value.
    • Set No Connection Refresh Interval
      —Specify the frequency (in minutes) at which the Traps agent checks for available ESM Servers after entering a
      No Connection
      state (default is 1).
    • Set ESM Server Validation Interval
      —Specify the frequency (in hours) at which the agent will verify the integrity of the ESM Server list (default is 1).
  3. (
    Optional
    ) Add Conditions to the rule. By default, a new rule does not contain any conditions.
    To specify a condition, select the
    Conditions
    tab, select the condition in the Conditions list, and then
    Add
    it to the Selected Conditions list. Repeat to add more conditions as needed. To add a condition to the Conditions list, see Define Activation Conditions for a Rule on Windows Endpoints or Define Activation Conditions for a Rule on Mac Endpoints.
  4. (
    Optional
    ) Define the Target Objects to which to apply the agent settings rule. By default, a new rule applies to all objects in your organization.
    To define a subset of target objects, select the
    Objects
    tab, and then enter one or more
    Users
    ,
    Computers
    ,
    Groups
    ,
    Organizational Unit
    , or
    Existing Endpoints
    in the Include or Exclude areas. The Endpoint Security Manager queries Active Directory to verify the users, computers, groups, or organizational units or identifies existing endpoints from previous communication messages.
  5. (
    Optional
    ) Review the rule name and description. The ESM Console automatically generates the rule name and description based on the rule details but permits you to change these fields, if needed.
    To override the autogenerated name, select the
    Name
    tab, clear the
    Activate automatic description
    option, and then enter a rule name and description of your choice.
  6. Save the agent settings rule.
    Do either of the following:
    • Save
      the rule without activating it. This option is only available for inactive, cloned, or new rules. When you are ready to activate the rule, select the rule from the
      Settings
      Agent
      Settings
      page and then click
      Activate
      .
    • Apply
      the rule to activate it immediately.
    After saving or applying a rule, you can return to the
    Settings
    page at any time to
    Delete
    or
    Deactivate
    the rule.

Related Documentation