Domotz Integration Guide

Domotz offers powerful network management software for MSPs, integrators, security professionals, and business owners. It has integrated features such as remote device access, SNMP monitoring, network diagnostics, remote power management, device alerts, team collaboration, network mapping, and multiple VLANs.

Domotz can use SNMP to monitor Firebox status, and can send alerts based on SNMP traps.

This document describes the steps to integrate your WatchGuard Firebox with Domotz.

Platform and Software

The hardware and software used to complete the steps outlined in this document include:

  • Firebox device installed with Fireware v12.5 or higher.
  • Domotz Pro account.
  • Domotz Agent Manager version 1.1.0

Diagram of the test topology

Set Up the Firebox

Before Domotz can discover your Firebox, you must configure SNMP settings on the Firebox and configure an SNMP policy.

Enable SNMP

Domotz only supports SNMPv2. To configure SNMP on the Firebox:

  1. Log in to Fireware Web UI (https://<your Firebox IP address>:8080).
  2. Select System > SNMP.
  3. From the Version drop-down list, select v1/v2c.
  4. In the Community String text box, type the Community String the SNMP server uses when it contacts the device. This example uses 11111111.
    The Community String is used as a user ID or password that alows access to the statistics of a device.
  5. In the SNMP Traps section, from Version drop-down list, select v2Trap.
  6. In the SNMP Management Stations list, add the IP address of the Domotz Agent. After you install the Domotz Agent, the IP address appears in the Domotz webapp portal. For more information, see Domotz Agent IP address, below.

Screen shot of the configured SNMP settings

  1. Keep other settings at default values.
  2. Click Save.

Add an SNMP Policy

To enable the Firebox to receive SNMP polls, you must add an SNMP packet filter policy.

  1. Select Firewall > Firewall Policies.
  2. Add an SNMP packet filter policy that allows SNMP traffic from Any-Trusted to Firebox.
    If the Domotz agent is installed on an optional interface, specify Any-Optional instead of Any-Trusted.

    Screen shot of the Policies page with the SNMP packet filter policy added

Set Up Domotz

Install a Domotz agent on the Firebox trusted or optional network. Then configure the community string to match what you configured on the Firebox.

  1. Install Domotz Agent Manager and activate a Domotz Agent. For more information, see Domotz Pro User Guide.
  2. In Domotz Agent Manager, click Open Domotz Pro.
    The domotz webapp portal appears.

Screen shot of Domotz Agent Manager

  1. To see a list of agents, in the domotz webapp portal, select Agents > All Agents.

Screen shot of the domotz webapp portal

  1. Click the activated agent. In this example, the agent is WG_ECO.
    The agent dashboard appears.

 Screen shot of the domotz webapp portal device list

  1. In the Devices List tile, click All Devices.

Screen shot of the devices list

  1. Click your WatchGuard Firebox to go to the Device Details page.
  2. At the bottom of the Info settings, configure the SNMP Communities settings to match the Community String configured on the Firebox.

Screen shot of modified SNMP Communities

Test the Integration

To test the integration, add SMNP sensors for the Firebox and verify that the expected information appears in domotz. You can also add an alert and verify that you receive email notification when a monitored event occurs on the Firebox.

  1. In the domotz webapp portal, go to the WatchGuard Firebox Device Details page.
  2. Go to the Domotz Eyes table.

Screen shot of the Device Details Eyes table

  1. Click Add an SNMP Sensor.

Screen shot of the Insert OID dialog box

  1. To insert an object identifier (OID), click .
    The Configure SNMP Sensor dialog box appears.
  2. In the Configure SNMP Sensor dialog box, specify the sensor configuration. This example uses the OID that returns the version of Fireware installed onthe Firebox.
    • In the Sensor name text box, type a name for this sensor.
    • From the Sensor Category drop-down list, select Other.
    • In the OID text box, type
    • In the Output Type settings, select String

Screen shot of the Configure SNMP Sensor dialog box

  1. Click Add.
  2. Wait a few minutes. Verify the value for the Firebox version OID appears on the Device Details page.

Screen shot of the Firebox version OID value

  1. Repeat step 2-5 to add SNMP Sensor Firebox name with OID
  2. On the Device Details page, select Info.
    Firebox basic information appears under Device Properties.

Screen shot of the Device Details info page

  1. On the Device Details page, select Alerts. In the Personal Alerts tab select Custom.

Screen shot of the Alerts settings

  1. In the SNMP Sensors section, click Configure an SNMP alert.

Screen shot of the settings to configure an SNMP alert

  1. Select the SNMP Sensor Firebox name.

Screen shot of the  Choosea Sensor dialog box

  1. In the Alert Configuration page, configure the alert settings.
    • In the Alert Name text box, type an alert name that describes what behavior triggers the alert.
    • In the Alert Behaviour settings, select is different from. Then type current Firebox name. In this example, the current name is WatchGuard-XTM
    • In the Communication Channel settings, select Email.

Screen shot of the Alert Configuration dialog box

  1. Click Add Alert

Screen shot of the configured Alert

  1. Log in to Fireware Web UI (https://<your firebox IP address>:8080).
  2. Select System > Information.
  3. Change the Firebox Name.
  4. Click Save.

Screen shot of the Firebox System Information page

  1. Verify that you receive a notification email from domotz about the name change.

Screen shot of the notification email