Create actionable data from your vulnerability scans

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. [![Build Status](https://travis-ci.org/austin-taylor/VulnWhisperer.svg?branch=master)](https://travis-ci.org/austin-taylor/VulnWhisperer) [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](http://choosealicense.com/licenses/mit/) Currently Supports ----------------- ### Vulnerability Frameworks - [X] Nessus (v6 & **v7**) - [X] Qualys Web Applications - [ ] Qualys Vulnerability Management (_in progress_) - [ ] OpenVAS - [ ] Nexpose - [ ] Insight VM - [ ] NMAP - [ ] More to come Getting Started =============== 1) Follow the [install requirements](#installreq) 2) Fill out the section you want to process in example.ini file 3) 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/) 4) Import the kibana visualizations 5) [Run Vulnwhisperer](#run) Requirements ------------- #### * ElasticStack 5.x * Python 2.7 * Vulnerability Scanner * Optional: Message broker such as Kafka or RabbitMQ Install Requirements -------------------- ```python Install dependant modules cd deps/qualysapi python setup.py install Using requirements file: sudo pip install -r /path/to/VulnWhisperer/requirements.txt cd /path/to/VulnWhisperer sudo python setup.py install ``` 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. ```python 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._ Credit ------ Big thank you to Justin Henderson for his contributions to vulnWhisperer! AS SEEN ON TV -------------