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 SettingsAgentSettings 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 this step to add more conditions, as needed. You can also define new Conditions.
  4. (Optional) Define the Target Objects to which to apply the rule.
    To define a smaller subset of target objects, select the Objects tab, and then enter one or more AD Users, AD Computers, AD Groups, AD Organizational Unit, Existing Endpoints, or Existing Groups in the Include or Exclude areas. The Endpoint Security Manager queries Active Directory to verify the users, computers, groups, or organizational units. The ESM Console also offers autocompletion as you type for existing endpoints and existing virtual groups.
  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 SettingsAgentSettings 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