Previous

Next

WatchGuard Firebox - Overview

WatchGuard Firebox - Firewall

WatchGuard Firebox - Networking Events

WatchGuard Firebox - Proxy Policy

WatchGuard Firebox - VPN

WatchGuard Firebox - Management Activity Monitor

Overview

WatchGuard Firebox is a network security platform offering comprehensive threat protection, including firewall, networking, and other security features, suitable for various network environments, from small offices to large enterprises.

This integration enriches and ingests the following events:

• Firewall Events: Represents log messages generated by your Firebox for events that occur on the Firebox and for traffic managed by packet filter policies. In addition to normal traffic, this can include messages related to feature keys, subscription services, server load balancing, and other features configured on your Firebox.
• Networking Events: Represents log messages generated for traffic related to the connections through your Firebox. This can include events related to interface activity, dynamic routing, PPPoE connections, and DHCP server requests.
• Management Events: Represents log messages generated for activity on your Firebox. This includes when changes are made to the device configuration and Device Management user accounts, for user authentication to the Firebox, and actions related to system settings.
• VPN Events: Represents log messages generated for processes related to the all VPNs configured on your Firebox. This includes changes to the VPN configuration, tunnel status, and daemon activity.
• Proxy Policy Events: Represents log messages generated for traffic managed by the proxy policies configured on your Firebox. This can include events related to traffic through the proxy, proxy actions, and security services.

This integration seamlessly collects all the above listed logs, channeling them into Datadog for analysis. Leveraging the built-in logs pipeline, these logs are parsed and enriched, enabling effortless search and analysis. The integration provides insight into firewall, networking, management, VPN, and proxy policy events through the out-of-the-box dashboards. Additionally, it includes ready-to-use Cloud SIEM detection rules for enhanced monitoring and security.

Setup

Installation

To install the WatchGuard Firebox integration, run the following Agent installation command and the steps below. For more information, see the Integration Management documentation.

Note: This step is not necessary for Agent version >= 7.66.0.

Linux command:

sudo -u dd-agent -- datadog-agent integration install datadog-watchguard-firebox==1.0.0

Configuration

Log collection

1. Collecting logs is disabled by default in the Datadog Agent. Enable it in datadog.yaml:

   logs_enabled: true
   

2. Add this configuration block to your watchguard-firebox.d/conf.yaml file to start collecting your WatchGuard Firebox logs. See the sample watchguard-firebox.d/conf.yaml for available configuration options.

   logs:
    - type: udp
      port: <PORT>
      service: watchguard-firebox
      source: watchguard-firebox
   

   Note:

   • PORT: Port should be identical to the port provided in Configure Syslog Message Forwarding from WatchGuard Firebox Server.
   • It is recommended not to change the service and source values, as these parameters are integral to the pipeline’s operation.

3. Restart the Agent.

Configure Syslog Message Forwarding from WatchGuard Firebox Server

1. Log in to Fireware Web UI with an administrator account.
2. Select System > Logging.
3. Select the Syslog Server tab.
4. Select the Send log messages to these syslog servers check box.
5. Click Add to open the Syslog Server dialog box.
6. In the IP Address text box, enter the IP address of the server on which datadog-agent is installed.
7. In the Port text box, enter the port you configured to receive the Firebox logs.
8. From the Log Format drop-down list, select Syslog.
9. Select The time stamp and The serial number of the device check boxes.
10. Click OK.

Validation

Run the Agent’s status subcommand and look for watchguard-firebox under the Checks section.

Data Collected

Logs

The WatchGuard Firebox integration collects firewall, networking, management, VPN, and proxy policy Events.

Metrics

The WatchGuard Firebox integration does not include any metrics.

Events

The WatchGuard Firebox integration does not include any events.

Troubleshooting

WatchGuard Firebox

Permission denied while port binding:

If you see a Permission denied error while port binding in the Agent logs, see the following instructions:

1. Binding to a port number under 1024 requires elevated permissions. Grant access to the port using the setcap command:

   • Grant access to the port using the setcap command:

     sudo setcap CAP_NET_BIND_SERVICE=+ep /opt/datadog-agent/bin/agent/agent
     

   • Verify the setup is correct by running the getcap command:

     sudo getcap /opt/datadog-agent/bin/agent/agent
     

     With the expected output:

     /opt/datadog-agent/bin/agent/agent = cap_net_bind_service+ep
     

     Note: Re-run this setcap command every time you upgrade the Agent.

2. Restart the Agent.

Data is not being collected:

Make sure that traffic is bypassed from the configured port if the firewall is enabled.

Port already in use:

If you see the Port <PORT_NUMBER> Already in Use error, see the following instructions. The example below is for a PORT_NUMBER equal to 514:

On systems using Syslog, if the Agent listens for events on port 514, the following error can appear in the Agent logs: Can't start UDP forwarder on port 514: listen udp :514: bind: address already in use.

This error occurs because by default, Syslog listens on port 514. To resolve this error, take one of the following steps:

• Disable Syslog.
• Configure the Agent to listen on a different, available port.

For any further assistance, contact Datadog support.