Skip to main content

WPWatcher - Automating WPScan to scan and report vulnerable Wordpress sites

Project description

WPWatcher - Automating WPScan to scan and report vulnerable Wordpress sites

Documentation Status

Wordpress Watcher is a wrapper for WPScan that manages scans on multiple sites and reports by email and/or syslog. Schedule scans and get notified when vulnerabilities, outdated plugins and other risks are found.

Features

  • Scan multiple sites with WPScan
  • Parse WPScan output and divide the results in "Alerts", "Warnings" and "Informations"
  • Handled VulnDB API limit
  • Define reporting emails addresses for every configured site individually and globally
  • Define false positives strings for every configured site individually and globally
  • Define WPScan arguments for every configured site individually and globally
  • Send WPScan findings to Syslog server
  • Save raw WPScan output into files
  • Log file lists all the findings
  • Speed up scans using several asynchronous workers
  • Follow URL redirection if WPScan fails and propose to ignore main redirect
  • Scan sites continuously at defined interval and configure script as a linux service
  • Additionnal alerts depending of finding type (SQL dump, etc.)
  • Keep track of fixed and unfixed issues

Documentation

Read The Docs.

Usage exemple

Scan two sites, add WPScan arguments, follow URL redirection and email report to recepients. If you reach your API limit, it will wait and continue 24h later.

wpwatcher --url exemple.com exemple1.com \
  --wpscan_args "--force --stealthy --api-token <TOKEN>" \
  --follow_redirect --api_limit_wait \
  --send --infos --email_to you@office.ca me@office.ca

WPWatcher must read a configuration file to send mail reports. This exemple assume you have filled your config file with mail server setings.

Emails

Sample email report.

WPWatcher Report

Authors

Disclamer

Use at your own risks.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wpwatcher-3.0.1.tar.gz (38.5 kB view details)

Uploaded Source

Built Distribution

wpwatcher-3.0.1-py3-none-any.whl (51.0 kB view details)

Uploaded Python 3

File details

Details for the file wpwatcher-3.0.1.tar.gz.

File metadata

  • Download URL: wpwatcher-3.0.1.tar.gz
  • Upload date:
  • Size: 38.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for wpwatcher-3.0.1.tar.gz
Algorithm Hash digest
SHA256 92f91cf35b4896df8a51dd4ba033a5926c51cca16643cef0abeae240b43bf563
MD5 76b4d1eefe90ddeecdc80a846bc0876f
BLAKE2b-256 7a95c7b547863ff02a6819b9512d7966f0447c5cad77cc292d57a819b836f674

See more details on using hashes here.

File details

Details for the file wpwatcher-3.0.1-py3-none-any.whl.

File metadata

  • Download URL: wpwatcher-3.0.1-py3-none-any.whl
  • Upload date:
  • Size: 51.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.2

File hashes

Hashes for wpwatcher-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8dfde2e32d8cfbdca0e0fcaf46a8ff499f309d64cae1f6f02f130ffa3dec9dca
MD5 eab7b7d4a8a97daf03ff8089a21d9f8c
BLAKE2b-256 762ba26d3354aa0bf7b7458c68c3d803c1b659a528e97ec0ed46f3666e87c50a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page