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 a 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 with an install of Fireware v12.8.1 or higher
  • Domotz account
  • Domotz Agent Manager

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 at:
    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 allows access to the statistics of a device.
  5. From the SNMP Traps section, from the Version drop-down list, select v2Trap.
  6. From the SNMP Management Stations list, add the IP address of the Domotz Agent. After you install the Domotz Agent, the IP address shows in Domotz Pro.

Screen shot of the configured SNMP settings

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

Add an SNMP Policy

For 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 you install the Domotz agent to 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

You install a Domotz agent on the Firebox trusted or optional network, then configure the community string to be the same as the configuration on the Firebox.

  1. Install Domotz Agent Manager.
  2. Log in to Domotz Pro.

Screen shot of Domotz Pro login page

  1. Select Inventory > Manage > Devices.
  2. Click the Device Name. Note that you can use IP | Mac Address entries to help you find the target Firebox.

Screen shot of the domotz Device page

  1. From Devices Details, select Info > SNMP Communities.

Screen shot of the domotz Device page

  1. From the SNMP Communities Settings Has Been Moved dialog box, click Open Access Manager.

Screen shot of the Open Acess Manager

  1. Click Edit the SNMP Authentication.
    The Edit SNMP Configuration dialog box opens.
  2. For Version, select v2.
  3. In the Community Read and Community Read/Write text boxes, type the value that you used for the SNMP Community String.

Screen shot of modified SNMP Communities

  1. Click Apply.

Test the Integration

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

  1. From Domotz Pro, go to Device Details and click SNMP.
  2. From the SNMP Monitoring section, click Add Sensor to Specific OIDs.

Screen shot of the Device Add sensor to specific OIDs

  1. Click Manually Define an SNMP Sensor.

Screen shot of the Manually define an SNMP Sensor

  1. In the Define the SNMP Sensor to Monitor dialog box, define the sensor configuration. This example uses an OID that returns the version of Fireware installed on the Firebox.
    1. In the Sensor Name text box, type a name for the sensor.
    2. In the Description text box, type a description for the sensor.
    3. In the OID text box, type 1.3.6.1.4.1.3097.6.3.1.0.
    4. For the Output Type, select String.

Screen shot of the Define the SNMP Sensor to monitor

  1. Click Add.
  2. After a few minutes, check that the values for the Firebox Version OID shows in Device Details.

Screen shot of the Firebox version OID value

  1. Repeat Steps 2-5 to add an SNMP Sensor that you name Firebox Name, with OID 1.3.6.1.2.1.1.5.0.

Screen shot of the Firebox version OID value

  1. From Device Details, click the device name.

Screen shot of the Device Details

  1. Click Alerts, then select the Personal Alerts tab and select Custom.

Screen shot of the Alerts settings

  1. From the SNMP Sensors section, click Configure an SNMP Alert.

Screen shot of the settings to configure an SNMP alert

  1. From Firebox Name, select your SNMP Sensor.

Screen shot of the  Choosea Sensor dialog box

  1. In the Alert Configuration dialog box, configure the alert settings.
    1. In the Alert Name text box, type an alert name that describes the behavior that triggers the alert.
    2. From Alert Behaviour, select is different from and type the name of the current Firebox. For this example, the name is WatchGuard-XTM.
    3. From the Communication Channel section, select the Email check box.

Screen shot of the Alert Configuration dialog box

  1. Click Add Alert.
    The alert configuration shows on the Device Details page.

Screen shot of the configured Alert

  1. Log in to Fireware Web UI at:
    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. You receive a notification email from Domotz about the name change.

Screen shot of the notification email