Plugin Security Scanner vs Site Add-on Watchdog

This plugin determines whether any of your plugins or themes have security vulnerabilities. It does this by looking up details in the WPScan Vulnerability Database. It will run a scan once a day, and e-mail the administrator if any vulnerable plugins or themes are found. Please note: As from version 2.0.0, you will need to register on the WPScan Vulnerability Database site in order to get an API token. This token is required before any security scans can be performed. Once you have your token, it can be added to the Plugin Security Scanner settings page. You can also register a webhook for notifications. The webhook will trigger daily, even if no vulnerabilities found. The webhook is a post request, with JSON payload containing the vulnerabilities. You can enable the webhook under Settings\General tab – see the Plugin Security Scanner settings. It also adds a new menu option to the admin tools menu called “Plugin Security Scanner”. Clicking this runs a scan. If the scan finds any problems, it shows you a list of plugins or themes that have vulnerabilities, along with a description of the issue. The WPScan Vulnerability Database API, which this plugin uses, is free for non-commercial use. However, any commercial usage will require that you purchase a commercial license from WPScan. If you are using the API for your own site then you will not need a commercial license. However, if you are a hosting company and install the plugin systematically across all of your clients sites, then you will need to purchase a commercial license. If you are making heavy use of the API, it is likely that you will need to purchase a commercial license. To enquire about a commercial license, please contact [email protected] Icons made by Alessio Atzeni from www.flaticon.com is licensed by CC BY 3.0

Site Add-on Watchdog keeps an eye on your site’s plugins and warns you when: Your installed version is two or more minor releases behind the directory build. The official changelog mentions security or vulnerability fixes. (Optional) WPScan lists open CVEs for the plugin when you provide your own API key. The plugin runs on a schedule you control—choose daily, weekly, a twenty-minute testing cadence, or rely on manual scans—and stores results locally. To compare public versions and changelogs, Watchdog sends one plugin slug at a time to WordPress.org and caches the response. WPScan lookups and outgoing notifications remain opt-in. Privacy first Risk processing and storage stay on your site; Watchdog does not send telemetry, site content, or user data. WordPress.org receives one request for each installed plugin slug so Watchdog can retrieve public version and changelog data. WPScan receives one plugin-slug lookup at a time only when you add your personal API token. Notification channels are opt-in and send the detected plugin risks to the destinations you configure. External services Watchdog uses the following external services under the stated conditions: WordPress.org Plugin API (required for directory comparisons): During a scan, Watchdog sends each installed plugin slug separately to retrieve its public version and changelog. No site content or user data is included. See the WordPress.org service and privacy policy. WPScan API (optional): When you save a WPScan API token, Watchdog sends that token as authorization and submits one plugin slug at a time to retrieve vulnerability records. See WPScan, its terms, and the applicable Automattic privacy policy. Notification destinations (optional): When you enable Email, Discord, Slack, Microsoft Teams, or a custom webhook, Watchdog sends the alert to the address you configure. Alerts can include plugin names, installed and available versions, risk or vulnerability details, and links back to your WordPress administration area. Those transmissions are governed by your mail provider or destination service; review the applicable policies for Discord (privacy), Slack (privacy), or Microsoft (privacy). Admin tools Focused dashboard with risk summaries, searchable history, delivery health, and manual actions. Ignore list to suppress noisy plugins. Validated notification settings with a save-and-test action for every channel. Notifications Email: send to one or more recipients separated by commas, semicolons, or spaces; site administrators are always included. Discord: post to a channel via webhook. Slack: connect via an incoming webhook to post alerts into any workspace channel. Microsoft Teams: send notices through Teams Workflows or an existing Incoming Webhook connector. Generic webhook: post JSON payload to any endpoint you control, with optional HMAC signatures. Failed deliveries are logged and highlighted on the Watchdog admin screen so you can reconfigure or resend manually. Troubleshooting Scheduled scans are not running Watchdog relies on WP-Cron to trigger scheduled scans and notifications. If you have set DISABLE_WP_CRON to true or your site receives very little traffic (so WP-Cron rarely runs), configure a system cron job to call either wp-cron.php or the plugin’s REST endpoint. The admin Delivery health panel shows the endpoint and generated secret. Send the secret in an HTTP header so it does not appear in access logs; a typical example looks like this: curl -X POST -H "X-Watchdog-Cron-Key: YOUR_GENERATED_SECRET" https://example.com/wp-json/site-add-on-watchdog/v1/cron Testing-mode notifications also rely on this trigger, so be sure your cron job is running when validating delivery. CLI Usage Watchdog bundles a WP-CLI command so you can run scans outside of the WordPress admin. All examples below assume the command is executed from a shell where wp (WP-CLI) is available. wp watchdog scan [--notify= ] --notify (optional): Accepts true or false (defaults to true). When set to false, Watchdog will skip any configured email or webhook notifications and only record the scan locally. Examples: Run a scan and send notifications (default): wp watchdog scan Run a scan silently (skip notifications): wp watchdog scan --notify=false Recommended workflow: on CI/CD platforms, add a job step that boots your WordPress/WP-CLI container, runs pending database migrations if needed, and then calls wp watchdog scan --notify=false to verify the plugin state without spamming production channels. Promote to production by rerunning the same command with notifications enabled when you are ready to alert your team. Development The development repository is available on GitHub: https://github.com/happyloa/site-add-on-watchdog. Clone it locally to review the source or run the test suite.