VulnWhisperer is a vulnerability data and report aggregator. VulnWhisperer will pull all the reports and create a file with a unique filename which is then fed into logstash. Logstash extracts data from the filename and tags all of the information inside the report (see logstash_vulnwhisp.conf file). Data is then shipped to elasticsearch to be indexed.

!Twitter

Currently Supports

Vulnerability Frameworks

Nessus (v6 & v7)
Qualys Web Applications
Qualys Vulnerability Management (in progress)
OpenVAS
Nexpose
Insight VM
NMAP
More to come

Getting Started

Follow the install requirements
Fill out the section you want to process in example.ini file
Modify the IP settings in the logstash files to accomodate your environment and import them to your logstash conf directory (default is /etc/logstash/conf.d/)
Import the kibana visualizations
Run Vulnwhisperer

Requirements

ElasticStack 5.x
Python 2.7
Vulnerability Scanner
Optional: Message broker such as Kafka or RabbitMQ

Install Requirements (may require sudo)

First, install dependant modules


cd deps/qualysapi
python setup.py install

Second, install requirements

pip install -r /path/to/VulnWhisperer/requirements.txt
cd /path/to/VulnWhisperer
python setup.py install

Now you're ready to pull down scans. (see run section)

Configuration

There are a few configuration steps to setting up VulnWhisperer:

Configure Ini file
Setup Logstash File
Import ElasticSearch Templates
Import Kibana Dashboards

example.ini file

Run

To run, fill out the configuration file with your vulnerability scanner settings. Then you can execute from the command line.


vuln_whisperer -c configs/example.ini -s nessus
or
vuln_whisperer -c configs/example.ini -s qualys

Next you'll need to import the visualizations into Kibana and setup your logstash config. A more thorough README is underway with setup instructions.

Running Nightly

If you're running linux, be sure to setup a cronjob to remove old files that get stored in the database. Be sure to change .csv if you're using json.

Setup crontab -e with the following config (modify to your environment) - this will run vulnwhisperer each night at 0130:

00 1 * * * /usr/bin/find /opt/vulnwhisp/ -type f -name '*.csv' -ctime +3 -exec rm {} \;

30 1 * * * /usr/local/bin/vuln_whisperer -c /opt/vulnwhisp/configs/example.ini

For windows, you may need to type the full path of the binary in vulnWhisperer located in the bin directory.

Video Walkthrough -- Featured on ElasticWebinar

Credit

Big thank you to Justin Henderson for his contributions to vulnWhisperer!

README.md