Nmap Nmap

Import your Nmap network scans for discovery and inventory

The Nmap connector allows you to import your Nmap network scan results for network discovery, ports inventory and operating systems detection.

Objective

The Nmap connector allows you to import the following information:

  • Network discovery (active hosts, scanned IP ranges)
  • Open ports and services
  • Detected operating systems

Prerequisites

  • XML files generated by Nmap (format .xml)
  • Nmap scans executed on your infrastructure

Procedure

Generate Nmap Scan Results

  1. Execute a Nmap scan on your network:
nmap -sV -O -oX scan_results.xml <target_range>

Parameters:

  • -sV: Service version detection
  • -O: Operating system detection
  • -oX scan_results.xml: Output in XML format
  • <target_range>: IP range to scan (e.g., 192.168.0.0/24)
  1. Wait for the scan to complete (duration varies based on target size).
  2. The .xml file will be created in the current directory.

Import into OverView

  1. In OverView, go to Data Sources Settings > Sources.
  2. Select Nmap and click Configure.
  3. Upload the .xml file generated by Nmap.
  4. Click Save Configuration.

OverView will automatically parse the XML file and import network discovery data, detected services and operating system information.

Uploading files through DropPoint

Files for the Nmap connector are stored in a dedicated S3 bucket named nmap. Drop your CSV (or JSON) files at the root of s3://nmap/: OverView automatically detects new files and imports them on the next synchronization.

Where do the files go?

Bucket : s3://nmap/

Example : s3://nmap/export.csv

Several ways to send your files

You can populate your bucket in several ways:

  • OverView web interface — import your files, configure the mapping, then click “Replace” to refresh the data without redoing the mapping.
  • AWS CLI — for a one-off or scripted upload.
  • S3 SDK (boto3, etc.) — to fully automate recurring imports.

Using the AWS CLI

# Upload a file to the nmap bucket
aws s3 cp export.csv s3://nmap/export.csv --profile ovs_your_org

# Or sync a whole local folder
aws s3 sync ./exports/ s3://nmap/ --profile ovs_your_org

Automating the import via S3

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.oversoc.com",
    region_name="fr-par",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
)

# Push the export into the nmap bucket
s3.upload_file("export.csv", "nmap", "export.csv")

Pair this script with a scheduled task (cron on Linux, Task Scheduler on Windows) to push your exports automatically at a regular interval. Each upload triggers a new import on the OverView side.

Prerequisite: generate your S3 credentials and configure your client (endpoint, profile) as described in the OverView DropPoint guide. The profile and endpoint used here are explained there.

Official Documentation

For more information on Nmap XML output format, see the Nmap XML Output Documentation

← PreviousLansweeperNext →runZero