casperklein / docker-netbox-scanner

10 stars 7 forks source link

docker-netbox-scanner

Dockerized version of netbox-scanner. Scan networks and add them to Netbox.

Build (optional)

make

Setup Netbox 3.x

  1. Goto Others / Tags and create a new tag: nmap.
  2. Goto Profiles & Settings / API Tokens and create a token, for use with netbox-scanner.

Setup Netbox 4.x

  1. Goto Customization / Tags and create a new tag: nmap.
  2. Goto Authentication / API Tokens and create a token, for use with netbox-scanner.

Setup Netbox-Scanner

  1. Configure address and API token in netbox-scanner.conf.
    • address must contain the scheme, e.g. http://192.168.0.10:8000
  2. Configure the networks to scan in networks.txt.

Start scan

# use default DNS server
./scan.sh

# use custom DNS server
# usefull if the host has a public DNS server configured and reverse DNS is not working for scanned hosts on the local network
./scan.sh --dns 192.168.0.1