This articles describes the procedure for setting up an automated host-discovery scan in ZeroNorth . Once set up, you can use this procedure to:
- Discover your currently exposed hosts.
- Review the discovered hosts.
- Baseline the initially discovered set.
- Receive notifications about newly discovered hosts.
Part 1: The Initial Scan
We first create the necessary Policy and then perform the initial scan. The basic steps are:
- Ensure that the nmap-host-discovery Scenario is activated.
- Create an Integration of Type “Custom”.
- Define a Target for the desired subnet that is Class C (/24) or smaller.
- Create a Policy that configures scanning the Target subnet with the nmap-host-discovery Scenario.
- Run the scan.
The below sections describe each step in detail.
1) Activate the nmap-host-discovery Scenario
- Go to zn ADM > Scenarios .
- Locate Nmap in the list of Products and then click on +Add Scenario in the bottom right.
- In the Scenario screen, enter a Name .
- Select “nmap-host-discovery” for the Product Configuration .
- Click on Save .
2) Create the Integration (type “Custom”)
If you’ve been using ZeroNorth, you might already have a Custom type Integration that you can use. If not, create a new one:
- Go to zn ADM > Integrations > +Add Integration .
- Enter Name and a Description .
- Leave Scan Execution as “ZeroNorth (hosted, default)”.
- Select Type “Custom”.
- Leave Discovery Subnet blank. This information is used for auto-creation of Targets, which is a different use case.
3) Create the Target Pointing to the Desired Subnet
- Go to zn OPS > Targets > +Add Target .
- Enter a Name .
- Select Target Type “Custom”.
- Select the Integration crated in Step 2.
- Enter the IP address range as x.x.x.x/y. It must specify a Class C or smaller scope.
- Click on Save .
4) Create the Policy
Putting it all together:
- Go to zn OPS > Policies > +Add Policy .
- Enter Name and Description for your policy.
- Select the Target Type “Custom”.
- Select the Integration you created in Step 2.
- Select the Target you created in Step 3.
- Select the nmap-host-discovery Scenario you activated in Step 1.
- Leave Schedule unchecked (we will do this in Part 2).
- Click on Save .
5) Run the Scan for an Initial Scan
- Go to zn OPS > Policies to view the new Policy.
- Click on and then select Run Now to run the initial scan. Depending on the scope of the subnet you specified, it can take seconds to minutes.
Part 2: Set up Alerts and Schedule the Scan
In this section, we review the initial scan results, set up notifications, and then automate the scan. The basic steps are:
- Review/baseline the initial scan results.
- Set up Alerts and Notifications.
- Schedule the Policy.
The below sections describe each step in detail.
1) Review the Initial Results
Go to zn OPS > Policies and locate the Policy. Click on and then select View Scan Issues . ZeroNorth will display a window like:
Review the list of discovered hosts. Take care of any adjustments and corrections you must make to your network. When ready, run the scan again. The new list of discovered hosts is your baseline. The baseline list of hosts is important, because in the next step, we will set up alerts for any changes.
2) Set Up Alerts and Notifications
Because the nmap-host-discovery scanner reports hosts as “Informational”, by default it will not generate Alerts. Therefore, we force Alerts on any new host discoveries.
- Go to zn OPS > Rules > +Add Rulset
- Enter Name and Description .
- Select Action type “alert” (the default).
- For the Rules fields, select “policyId”, “=”, and then the ID of the Policy from above. See this article for instructions on obtaining the Policy ID).
- Click Save Rulset .
The above step forces an Alert to be generated for the Informational issues for host discoveries. We now need to set up one or more Notifications to direct those Alerts.
- Go to zn OPS > Targets , and then click on the Target you created above.
- Select Severity Levels “All:…”.
- Add desired Notifications (see the article " Set Up Notifications About a Target-level Issue " for details).
- Click on Save .
3) Schedule the Policy
The final step is to schedule the host discovery policy:
- Go to znOPS > Policies and locate the Policy.
- Click on and then select Edit .
- In the Policy edit screen, scroll down to the Schedule section.
- Check the Schedule checkbox and then specify the schedule in UTC time zone.
The Policy will run on set schedule and will send notification of new host discoveries, host changes, or hosts down.