Adding wpscan

(cherry picked from commit 1000373c95c9de986a58ffffda327cb36be474a4)

tools/wpscan.md

@@ -0,0 +1,114 @@
+# wpscan
+
+Notes
+-------
+
+Help Text
+-------
+```_______________________________________________________________
+        __          _______   _____                  
+        \ \        / /  __ \ / ____|                 
+         \ \  /\  / /| |__) | (___   ___  __ _ _ __  
+          \ \/  \/ / |  ___/ \___ \ / __|/ _` | '_ \ 
+           \  /\  /  | |     ____) | (__| (_| | | | |
+            \/  \/   |_|    |_____/ \___|\__,_|_| |_|
+
+        WordPress Security Scanner by the WPScan Team 
+                        Version v2.3
+     Sponsored by the RandomStorm Open Source Initiative
+   @_WPScan_, @ethicalhack3r, @erwan_lr, pvdl, @_FireFart_
+_______________________________________________________________
+
+Help :
+
+Some values are settable in conf/browser.conf.json :
+  user-agent, proxy, proxy-auth, threads, cache timeout and request timeout
+
+--update   Update to the latest revision
+--url   | -u <target url>  The WordPress URL/domain to scan.
+--force | -f Forces WPScan to not check if the remote site is running WordPress.
+--enumerate | -e [option(s)]  Enumeration.
+  option :
+    u        usernames from id 1 to 10
+    u[10-20] usernames from id 10 to 20 (you must write [] chars)
+    p        plugins
+    vp       only vulnerable plugins
+    ap       all plugins (can take a long time)
+    tt       timthumbs
+    t        themes
+    vt       only vulnerable themes
+    at       all themes (can take a long time)
+  Multiple values are allowed : "-e tt,p" will enumerate timthumbs and plugins
+  If no option is supplied, the default is "vt,tt,u,vp"
+
+--exclude-content-based "<regexp or string>" Used with the enumeration option, will exclude all occurrences based on the regexp or string supplied
+                                             You do not need to provide the regexp delimiters, but you must write the quotes (simple or double)
+--config-file | -c <config file> Use the specified config file
+--follow-redirection  If the target url has a redirection, it will be followed without asking if you wanted to do so or not
+--wp-content-dir <wp content dir>  WPScan try to find the content directory (ie wp-content) by scanning the index page, however you can specified it. Subdirectories are allowed
+--wp-plugins-dir <wp plugins dir>  Same thing than --wp-content-dir but for the plugins directory. If not supplied, WPScan will use wp-content-dir/plugins. Subdirectories are allowed
+--proxy <[protocol://]host:port> Supply a proxy (will override the one from conf/browser.conf.json).
+                                 HTTP, SOCKS4 SOCKS4A and SOCKS5 are supported. If no protocol is given (format host:port), HTTP will be used
+--proxy-auth <username:password>  Supply the proxy login credentials (will override the one from conf/browser.conf.json).
+--basic-auth <username:password>  Set the HTTP Basic authentication
+--wordlist | -w <wordlist>  Supply a wordlist for the password bruter and do the brute.
+--threads  | -t <number of threads>  The number of threads to use when multi-threading requests. (will override the value from conf/browser.conf.json)
+--username | -U <username>  Only brute force the supplied username.
+--help     | -h This help screen.
+--verbose  | -v Verbose output.
+
+
+Examples :
+
+-Further help ...
+ruby ./wpscan.rb --help
+
+-Do 'non-intrusive' checks ...
+ruby ./wpscan.rb --url www.example.com
+
+-Do wordlist password brute force on enumerated users using 50 threads ...
+ruby ./wpscan.rb --url www.example.com --wordlist darkc0de.lst --threads 50
+
+-Do wordlist password brute force on the 'admin' username only ...
+ruby ./wpscan.rb --url www.example.com --wordlist darkc0de.lst --username admin
+
+-Enumerate installed plugins ...
+ruby ./wpscan.rb --url www.example.com --enumerate p
+
+-Enumerate installed themes ...
+ruby ./wpscan.rb --url www.example.com --enumerate t
+
+-Enumerate users ...
+ruby ./wpscan.rb --url www.example.com --enumerate u
+
+-Enumerate installed timthumbs ...
+ruby ./wpscan.rb --url www.example.com --enumerate tt
+
+-Use a HTTP proxy ...
+ruby ./wpscan.rb --url www.example.com --proxy 127.0.0.1:8118
+
+-Use a SOCKS5 proxy ... (cURL >= v7.21.7 needed)
+ruby ./wpscan.rb --url www.example.com --proxy socks5://127.0.0.1:9000
+
+-Use custom content directory ...
+ruby ./wpscan.rb -u www.example.com --wp-content-dir custom-content
+
+-Use custom plugins directory ...
+ruby ./wpscan.rb -u www.example.com --wp-plugins-dir wp-content/custom-plugins
+
+-Update ...
+ruby ./wpscan.rb --update
+
+-Debug output ...
+ruby ./wpscan.rb --url www.example.com --debug-output 2>debug.log
+
+See README for further information.
+
+```
+
+Example Usage
+-------
+
+Links
+-------
+