Setup

###Super quickstart if you already have Vultr setup and you just want to load the most current functions, run this oneliner (and don't forget to update your API key).

wget https://raw.githubusercontent.com/royharoush/DistributedScanning/master/bashFunction.sh -O bashFunction.sh && source bashFunction.sh && export VULTRAPIKEY="YOURAPIKEY"

Vultr

1. setup an account on Vultr and add some funds to it(for testing, even 5 dollars should be enough)

2. grab your API key from the account page and make sure you allow your IP address access to the API https://my.vultr.com/settings/#settingsapi

3. create a new startup script in this page

   https://my.vultr.com/startup/ the startup script should contain this script

   https://github.com/royharoush/DistributedScanning/blob/master/vultrScannerStartupScript.sh

   Mind the values of the dnmap_server IP and port, as you might want to change these later.

   Take a note of your startup script ID

   

4. add your SSH public key in this page

   https://my.vultr.com/sshkeys/

   take a note of your SSH key ID.

   

All done !

Modifying the script

in order to have your scanners boot up automatically, setup dnmap and nmap and be accessible remotely using your private key, we need to modify the following values in the script.

1. git clone the project

2. go into the bashFunction.sh file

   2.1. modify the API key to match your API key at the beginning of the script

   2.2. modify the startup script ID and SSH key ID on line 173 to match your own values.

   for i in $(seq 1 $number); do curl -H "API-Key: "$VULTRAPIKEY"" https://api.vultr.com/v1/server/create --data 'VPSPLANID=29' --data 'OSID=193' --data 'SCRIPTID=**YOURSTARTUPSCRIPTID**' --data 'SSHKEYID=**YOURSSHKEYID**' --data "DCID="$dcid"" --data "label=scanmachine1"; done;

All done !