Skip to main content


WPScan Logo

License Apache-2.0GitHub release (latest SemVer)OWASP Incubator ProjectArtifact HUBGitHub Repo starsTwitter Follower

What is WPScan?#

WPScan is a free, for non-commercial use, black box WordPress vulnerability scanner written for security professionals and blog maintainers to test the security of their sites.

NOTE: You need to provide WPSan with an API Token so that it can look up vulnerabilities infos with Without the token WPScan will only identify WordPress Core / Plugin / Theme versions but not if they are actually vulnerable. You can get a free API Token at by registering for an account at Using the secureCodeBox WPScans you can specify the token via the WPVULNDB_API_TOKEN target attribute, see the example below.

To learn more about the WPScan scanner itself visit or


The wpscan chart can be deployed via helm:

# Install HelmChart (use -n to configure another namespace)helm upgrade --install wpscan secureCodeBox/wpscan

Scanner Configuration#

The following security scan configuration example are based on the WPScan Documentation, please take a look at the original documentation for more configuration examples.

  • Scan all plugins with known vulnerabilities: wpscan --url -e vp --plugins-detection mixed --api-token WPVULNDB_API_TOKEN
  • Scan all plugins in our database (could take a very long time): wpscan --url -e ap --plugins-detection mixed --api-token WPVULNDB_API_TOKEN
  • Password brute force attack: wpscan --url -e u --passwords /path/to/password_file.txt
  • WPScan keeps a local database of metadata that is used to output useful information, such as the latest version of a plugin. The local database can be updated with the following command: wpscan --update
  • When enumerating the WordPress version, installed plugins or installed themes, you can use three different "modes", which are:
    • passive
    • aggressive
    • mixed If you want the most results use the "mixed" mode. However, if you are worried that the server may not be able to handle many requests, use the "passive" mode. The default mode is "mixed", except plugin enumeration, which is "passive". You will need to manually override the plugin detection mode, if you want to use anything other than the default, with the --plugins-detection option.
  • WPScan can enumerate various things from a remote WordPress application, such as plugins, themes, usernames, backed up files wp-config.php files, Timthumb files, database exports and more. To use WPScan's enumeration capabilities supply the -e option.
Available Choices:  vp  |  Vulnerable plugins  ap  |  All plugins  p   |  Plugins  vt  |  Vulnerable themes  at  |  All themes  t   |  Themes  tt  |  Timthumbs  cb  |  Config backups  dbe |  Db exports  u   |  User IDs range. e.g: u1-5         Range separator to use: '-'         Value if no argument supplied: 1-10  m   |  Media IDs range. e.g m1-15         Note: Permalink setting must be set to "Plain" for those to be detected         Range separator to use: '-'         Value if no argument supplied: 1-100
Separator to use between the values: ','Default: All Plugins, Config BackupsValue if no argument supplied: vp,vt,tt,cb,dbe,u,mIncompatible choices (only one of each group/s can be used):  - vp, ap, p  - vt, at, t


Kubernetes: >=v1.11.0-0


parser.envlist[]Optional environment variables mapped into each parseJob (see:
parser.image.repositorystring""Parser image repository
parser.image.tagstringdefaults to the charts versionParser image tag
parser.ttlSecondsAfterFinishedstringnilseconds after which the kubernetes job for the parser will be deleted. Requires the Kubernetes TTLAfterFinished controller:
scanner.backoffLimitint3There are situations where you want to fail a scan Job after some amount of retries due to a logical error in configuration etc. To do so, set backoffLimit to specify the number of retries before considering a scan Job as failed. (see:
scanner.envlist[]Optional environment variables mapped into each scanJob (see:
scanner.extraContainerslist[]Optional additional Containers started with each scanJob (see:
scanner.extraVolumeMountslist[]Optional VolumeMounts mapped into each scanJob (see:
scanner.extraVolumeslist[]Optional Volumes mapped into each scanJob (see:
scanner.image.repositorystring"wpscanteam/wpscan"Container Image to run the scan
scanner.image.tagstringnildefaults to the charts appVersion
scanner.nameAppendstringnilappend a string to the default scantype name.
scanner.resourcesobject{}CPU/memory resource requests/limits (see:,
scanner.securityContextobject{}Optional securityContext set on scanner container (see:
scanner.ttlSecondsAfterFinishedstringnilseconds after which the kubernetes job for the scanner will be deleted. Requires the Kubernetes TTLAfterFinished controller:



Code of secureCodeBox is licensed under the Apache License 2.0.



This example is only meant as a guideline for configuring wpscan. The example scan will fail as it uses as a target, which isn't a valid wpscan target.

# SPDX-FileCopyrightText: 2021 iteratec GmbH## SPDX-License-Identifier: Apache-2.0
apiVersion: ""kind: Scanmetadata:  name: ""spec:  scanType: "wpscan"  parameters:    - "--url"    -    - "-e"    - "vp"    - "--plugins-detection"    - "mixed"    - "--api-token"    - "AAAAABBBBBCCCCCDDDDEEEEEEE"



This example scan uses a demo wordpress 4.0 instance. You can deploy it as a demo target into you cluster. The scan assumes that it is installed in the demo-targets namespace. See the installation guide.

# SPDX-FileCopyrightText: 2021 iteratec GmbH## SPDX-License-Identifier: Apache-2.0
apiVersion: ""kind: Scanmetadata:  name: "wpscan-old-wordpress-internal"spec:  scanType: "wpscan"  parameters:    - "--url"    - old-wordpress.demo-targets.svc.cluster.local    - "-e"    - "vp"    - "--plugins-detection"    - "mixed"