/heroku-portscanner

Primary LanguageLuaMIT LicenseMIT

heroku-portscanner

Deploy

usage

request:

curl -L -H 'Content-Type: application/json' -X POST -d '{ "range": [ "8.8.8.0/24" ], "ports": [ "80" ], "flags": "--datadir=/app/data -oX -" }' https://fathomless-journey-1767.herokuapp.com/api/scan/
  • range can be an array of ranges, CIDR networks, or single hosts
  • ports can be an array or ranges or individual ports
  • flags are extra command-line flags to be passed to nmap

response:

{ "id": "07504c0a-5d40-4f49-be6b-0f5631a3639f",
  "url": "https://fathomless-journey-1767.herokuapp.com/api/scan/07504c0a-5d40-4f49-be6b-0f5631a3639f" }

nmap will run async with a number of jobs equal to the number of cores in the system, if CIDR blocks are provided. Return later to the provided URL to grab results in JSON