{"id":13538799,"url":"https://github.com/HASecuritySolutions/VulnWhisperer","last_synced_at":"2025-04-02T05:31:50.528Z","repository":{"id":27883523,"uuid":"94469200","full_name":"HASecuritySolutions/VulnWhisperer","owner":"HASecuritySolutions","description":"Create actionable data from your Vulnerability Scans","archived":false,"fork":false,"pushed_at":"2022-12-27T15:35:19.000Z","size":2557,"stargazers_count":1339,"open_issues_count":52,"forks_count":270,"subscribers_count":116,"default_branch":"master","last_synced_at":"2024-05-18T22:22:26.041Z","etag":null,"topics":["elasticsearch","elasticstack","logstash","nessus","python","qualys","vulnerability"],"latest_commit_sha":null,"homepage":"https://twitter.com/VulnWhisperer","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"austin-taylor/VulnWhisperer","license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HASecuritySolutions.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-15T18:48:48.000Z","updated_at":"2024-05-18T22:22:26.042Z","dependencies_parsed_at":"2023-01-14T07:40:20.812Z","dependency_job_id":null,"html_url":"https://github.com/HASecuritySolutions/VulnWhisperer","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HASecuritySolutions%2FVulnWhisperer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HASecuritySolutions%2FVulnWhisperer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HASecuritySolutions%2FVulnWhisperer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HASecuritySolutions%2FVulnWhisperer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HASecuritySolutions","download_url":"https://codeload.github.com/HASecuritySolutions/VulnWhisperer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246763805,"owners_count":20829795,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["elasticsearch","elasticstack","logstash","nessus","python","qualys","vulnerability"],"created_at":"2024-08-01T09:01:16.288Z","updated_at":"2025-04-02T05:31:48.262Z","avatar_url":"https://github.com/HASecuritySolutions.png","language":"Python","funding_links":[],"categories":["Python (1887)","Python","\u003ca id=\"683b645c2162a1fce5f24ac2abfa1973\"\u003e\u003c/a\u003e漏洞\u0026\u0026漏洞管理\u0026\u0026漏洞发现/挖掘\u0026\u0026漏洞开发\u0026\u0026漏洞利用\u0026\u0026Fuzzing"],"sub_categories":["\u003ca id=\"c0bec2b143739028ff4ec439e077aa63\"\u003e\u003c/a\u003e漏洞扫描\u0026\u0026挖掘\u0026\u0026发现"],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://github.com/austin-taylor/vulnwhisperer/blob/master/docs/source/vuln_whisperer_logo_s.png\" width=\"400px\"\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003e \u003ci\u003eCreate \u003cu\u003e\u003cb\u003eactionable data\u003c/b\u003e\u003c/u\u003e from your vulnerability scans \u003c/i\u003e \u003c/p\u003e \n\n\u003cp align=\"center\" style=\"width:400px\"\u003e\u003cimg src=\"https://github.com/austin-taylor/vulnwhisperer/blob/master/docs/source/vulnWhispererWebApplications.png\" style=\"width:400px\"\u003e\u003c/p\u003e\n\n\nVulnWhisperer is a vulnerability management tool and report aggregator. VulnWhisperer will pull all the reports from the different Vulnerability scanners and create a file with a unique filename for each one, using that data later to sync with Jira and feed Logstash. Jira does a closed cycle full Sync with the data provided by the Scanners, while Logstash indexes and tags all of the information inside the report (see logstash files at /resources/elk6/pipeline/). Data is then shipped to ElasticSearch to be indexed, and ends up in a visual and searchable format in Kibana with already defined dashboards.\n\nVulnWhisperer is an open-source community funded project. VulnWhisperer currently works but is due for a documentation overhaul and code review. This is on the roadmap for the next month or two (February or March of 2022 - hopefully). Please note, crowd funding is an option. If you would like help getting VulnWhisperer up and running, are interested in new features, or are looking for paid support (for those of you that require commercial support contracts to implement open-source solutions), please reach out to **info@hasecuritysolutions.com**.\n\n[![Build Status](https://travis-ci.org/HASecuritySolutions/VulnWhisperer.svg?branch=master)](https://travis-ci.org/HASecuritySolutions/VulnWhisperer)\n[![GitHub license](https://img.shields.io/github/license/HASecuritySolutions/VulnWhisperer)](https://github.com/HASecuritySolutions/VulnWhisperer/blob/master/LICENSE)\n[![Twitter](https://img.shields.io/twitter/follow/VulnWhisperer.svg?style=social\u0026label=Follow)](https://twitter.com/VulnWhisperer)\n\nCurrently Supports\n-----------------\n\n### Vulnerability Frameworks\n\n- [X] [Nessus (**v6**/**v7**/**v8**)](https://www.tenable.com/products/nessus/nessus-professional)\n- [X] [Qualys Web Applications](https://www.qualys.com/apps/web-app-scanning/)\n- [X] [Qualys Vulnerability Management](https://www.qualys.com/apps/vulnerability-management/)\n- [X] [OpenVAS (**v7**/**v8**/**v9**)](http://www.openvas.org/)\n- [X] [Tenable.io](https://www.tenable.com/products/tenable-io)\n- [ ] [Detectify](https://detectify.com/)\n- [ ] [Nexpose](https://www.rapid7.com/products/nexpose/)\n- [ ] [Insight VM](https://www.rapid7.com/products/insightvm/)\n- [ ] [NMAP](https://nmap.org/)\n- [ ] [Burp Suite](https://portswigger.net/burp)\n- [ ] [OWASP ZAP](https://www.zaproxy.org/)\n- [ ] More to come\n\n### Reporting Frameworks\n\n- [X] [Elastic Stack (**v6**/**v7**)](https://www.elastic.co/elk-stack)\n- [ ] [OpenSearch - Being considered for next update](https://opensearch.org/)\n- [X] [Jira](https://www.atlassian.com/software/jira)\n- [ ] [Splunk](https://www.splunk.com/)\n\nGetting Started\n===============\n\n1) Follow the [install requirements](#installreq)\n2) Fill out the section you want to process in \u003ca href=\"https://github.com/HASecuritySolutions/VulnWhisperer/blob/master/configs/frameworks_example.ini\"\u003eframeworks_example.ini file\u003c/a\u003e\n3) [JIRA] If using Jira, fill Jira config in the config file mentioned above.\n3) [ELK] Modify the IP settings in the \u003ca href=\"https://github.com/HASecuritySolutions/VulnWhisperer/tree/master/resources/elk6/pipeline\"\u003eLogstash files to accommodate your environment\u003c/a\u003e and import them to your logstash conf directory (default is /etc/logstash/conf.d/)\n4) [ELK] Import the \u003ca href=\"https://github.com/HASecuritySolutions/VulnWhisperer/blob/master/resources/elk6/kibana.json\"\u003eKibana visualizations\u003c/a\u003e\n5) [Run Vulnwhisperer](#run)\n\nNeed assistance or just want to chat? Join our [slack channel](https://join.slack.com/t/vulnwhisperer/shared_invite/enQtNDQ5MzE4OTIyODU0LWQxZTcxYTY0MWUwYzA4MTlmMWZlYWY2Y2ZmM2EzNDFmNWVlOTM4MzNjYzI0YzdkMDA0YmQyYWRhZGI2NGUxNGI)\n\nRequirements\n-------------\n####\n*   Python 2.7\n*   Vulnerability Scanner\n*   Reporting System: Jira / ElasticStack 6.6\n\n\u003ca id=\"installreq\"\u003eInstall Requirements-VulnWhisperer(may require sudo)\u003c/a\u003e\n--------------------\n**Install OS packages requirement dependencies** (Debian-based distros, CentOS don't need it)\n```shell\n\nsudo apt-get install  zlib1g-dev libxml2-dev libxslt1-dev \n```\n\n**(Optional) Use a python virtualenv to not mess with host python libraries**\n```shell\nvirtualenv venv (will create the python 2.7 virtualenv)\nsource venv/bin/activate (start the virtualenv, now pip will run there and should install libraries without sudo)\n\ndeactivate (for quitting the virtualenv once you are done)\n```\n\n**Install python libraries requirements**\n\n```python\npip install -r /path/to/VulnWhisperer/requirements.txt\ncd /path/to/VulnWhisperer\npython setup.py install\n```\n\n**(Optional) If using a proxy, add proxy URL as environment variable to PATH**\n```shell\nexport HTTP_PROXY=http://example.com:8080\nexport HTTPS_PROXY=http://example.com:8080\n```\n\nNow you're ready to pull down scans. (see \u003ca href=\"#run\"\u003erun section\u003c/a\u003e)\n\nConfiguration\n-----\n\nThere are a few configuration steps to setting up VulnWhisperer:\n*   Configure Ini file\n*   Setup Logstash File\n*   Import ElasticSearch Templates\n*   Import Kibana Dashboards\n\n\u003ca href=\"https://github.com/austin-taylor/VulnWhisperer/blob/master/configs/frameworks_example.ini\"\u003eframeworks_example.ini file\u003c/a\u003e\n\u003cp align=\"left\" style=\"width:200px\"\u003e\u003cimg src=\"https://github.com/austin-taylor/vulnwhisperer/blob/master/docs/source/config_example.png\" style=\"width:200px\"\u003e\u003c/p\u003e\n\n\n\u003ca id=\"run\"\u003eRun\u003c/a\u003e\n-----\nTo run, fill out the configuration file with your vulnerability scanner settings. Then you can execute from the command line.\n```python\n(optional flag: -F -\u003e provides \"Fancy\" log colouring, good for comprehension when manually executing VulnWhisperer)\nvuln_whisperer -c configs/frameworks_example.ini -s nessus \nor\nvuln_whisperer -c configs/frameworks_example.ini -s qualys\n\n```\nIf no section is specified (e.g. -s nessus), vulnwhisperer will check on the config file for the modules that have the property `enabled=true` and run them sequentially.\n\n\u003cp align=\"center\" style=\"width:300px\"\u003e\u003cimg src=\"https://github.com/austin-taylor/vulnwhisperer/blob/master/docs/source/running_vuln_whisperer.png\" style=\"width:400px\"\u003e\u003c/p\u003e\nNext you'll need to import the visualizations into Kibana and setup your logstash config. You can either follow the sample setup instructions [here](https://github.com/HASecuritySolutions/VulnWhisperer/wiki/Sample-Guide-ELK-Deployment) or go for the `docker-compose` solution we offer.\n\n\nDocker-compose\n-----\nELK is a whole world by itself, and for newcomers to the platform, it requires basic Linux skills and usually a bit of troubleshooting until it is deployed and working as expected. As we are not able to provide support for each users ELK problems, we put together a docker-compose which includes:\n\n- VulnWhisperer\n- Logstash 6.6\n- ElasticSearch 6.6\n- Kibana 6.6\n\nThe docker-compose just requires specifying the paths where the VulnWhisperer data will be saved, and where the config files reside. If ran directly after `git clone`, with just adding the Scanner config to the VulnWhisperer config file ([/resources/elk6/vulnwhisperer.ini](https://github.com/HASecuritySolutions/VulnWhisperer/blob/master/resources/elk6/vulnwhisperer.ini)), it will work out of the box.\n\nIt also takes care to load the Kibana Dashboards and Visualizations automatically through the API, which needs to be done manually otherwise at Kibana's startup.\n\nFor more info about the docker-compose, check on the [docker-compose wiki](https://github.com/HASecuritySolutions/VulnWhisperer/wiki/docker-compose-Instructions) or the [FAQ](https://github.com/HASecuritySolutions/VulnWhisperer/wiki).\n\nGetting Started\n===============\n\nOur current Roadmap is as follows:\n- [ ] Create a Vulnerability Standard\n- [ ] Map every scanner results to the standard \n- [ ] Create Scanner module guidelines for easy integration of new scanners (consistency will allow #14)\n- [ ] Refactor the code to reuse functions and enable full compatibility among modules\n- [ ] Change Nessus CSV to JSON (Consistency and Fix #82)\n- [ ] Adapt single Logstash to standard and Kibana Dashboards\n- [ ] Implement Detectify Scanner\n- [ ] Implement Splunk Reporting/Dashboards\n\nOn top of this, we try to focus on fixing bugs as soon as possible, which might delay the development. We also very welcome PR's, and once we have the new standard implemented, it will be very easy to add compatibility with new scanners. \n\nThe Vulnerability Standard will initially be a new simple one level JSON with all the information that matches from the different scanners having standardized variable names, while maintaining the rest of the variables as they are. In the future, once everything is implemented, we will evaluate moving to an existing standard like ECS or AWS Vulnerability Schema; we prioritize functionality over perfection.\n\nVideo Walkthrough -- Featured on ElasticWebinar\n----------------------------------------------\n\u003ca href=\"http://www.youtube.com/watch?feature=player_embedded\u0026v=zrEuTtRUfNw?start=30\n\" target=\"_blank\"\u003e\u003cimg src=\"https://github.com/austin-taylor/vulnwhisperer/blob/master/docs/source/elastic_webinar.png\" \nalt=\"Elastic presentation on VulnWhisperer\" border=\"10\" /\u003e\u003c/a\u003e\n\nAuthors\n------\n   - [Austin Taylor (@HuntOperator)](https://github.com/austin-taylor)\n   - [Justin Henderson (@smapper)](https://github.com/SMAPPER)\n   \nContributors\n------------\n   - [Quim Montal (@qmontal)](https://github.com/qmontal)\n   - [@pemontto](https://github.com/pemontto)\n   - [@cybergoof](https://github.com/cybergoof)\n\nAS SEEN ON TV\n-------------\n\u003cp align=\"center\" style=\"width:400px\"\u003e\u003ca href=\"https://twitter.com/MalwareJake/status/935654519471353856\"\u003e\u003cimg src=\"https://github.com/austin-taylor/vulnwhisperer/blob/master/docs/source/as_seen_on_tv.png\" style=\"width:400px\"\u003e\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHASecuritySolutions%2FVulnWhisperer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHASecuritySolutions%2FVulnWhisperer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHASecuritySolutions%2FVulnWhisperer/lists"}