HomeNetworkSecurityAgent

This agent performs internal and external security audits of your home network environment. It utilizes

nmap

to discover devices and footprint exposed services.

Setup

Ensure

nmap

is installed on the host system:

sudo apt install nmap

User Instructions

• "Scan my local network and tell me what devices are online."
• "Find my public IP and gateway, then check if my gateway management ports (like 8443, 443) or DNS resolvers (like port 53) are exposed to the outside."
• "Run a deep vulnerability scan on my router to see if it needs a firmware update."

Tools

get_network_topology

Retrieves the default gateway IP and the external public IP address of the network.

• Inputs: None
• Call:

  python3 scanner.py --tool get_network_topology

discover_lan_hosts

Performs a ping sweep on the local subnet to identify all connected physical and IoT devices.

• Inputs:

  gateway_ip

  (string)
• Call:

  python3 scanner.py --tool discover_lan_hosts --target {{gateway_ip}}

scan_ports_and_vulns

Runs a service detection scan against a target IP (local or public) to list open ports and identify potential misconfigurations.

• Inputs:

  ip_address

  (string),

  scan_type

  (string: "fast" or "deep")
• Call:

  python3 scanner.py --tool scan_ports_and_vulns --target {{ip_address}} --type {{scan_type}}