|
1 | | -# scanner-cms-wpscan |
| 1 | +# About |
| 2 | + |
2 | 3 | This repository contains a self contained µService utilizing the WPScan scanner for the secureCodeBox project. |
| 4 | + |
| 5 | +Further Documentation: |
| 6 | + |
| 7 | +- [Project Description][scb-project] |
| 8 | +- [Developer Guide][scb-developer-guide] |
| 9 | +- [User Guide][scb-user-guide] |
| 10 | + |
| 11 | +## Configuration Options |
| 12 | + |
| 13 | +To configure this service specify the following environment variables: |
| 14 | + |
| 15 | +| Environment Variable | Value Example | |
| 16 | +| -------------------------- | ------------- | |
| 17 | +| ENGINE_ADDRESS | http://engine | |
| 18 | +| ENGINE_BASIC_AUTH_USER | username | |
| 19 | +| ENGINE_BASIC_AUTH_PASSWORD | 123456 | |
| 20 | + |
| 21 | +### Local setup |
| 22 | + |
| 23 | +1. Clone the repository |
| 24 | +2. You might need to install some dependencies `gem install sinatra rest-client` |
| 25 | +3. Run locally `ruby src/main.rb` |
| 26 | + |
| 27 | +### Test |
| 28 | + |
| 29 | +To run the testsuite run: |
| 30 | + |
| 31 | +`rake test` |
| 32 | + |
| 33 | +## WpScan Parameters |
| 34 | + |
| 35 | +To hand over supported parameters through api usage, you can set following attributes: |
| 36 | + |
| 37 | +```json |
| 38 | +[ |
| 39 | + { |
| 40 | + "name": "some Name", |
| 41 | + "context": "some Context", |
| 42 | + "target": { |
| 43 | + "name": "targetName", |
| 44 | + "location": "http://your-target.com/", |
| 45 | + "attributes": { |
| 46 | + "WP_STEALTHY": "true", |
| 47 | + "WP_ENUMERATE": "[Options]", |
| 48 | + "WP_MAX_DURATION": "[Seconds]", |
| 49 | + "WP_THROTTLE": "[Milliseconds]", |
| 50 | + "WP_REQUEST_TIMEOUT": "[Seconds]", |
| 51 | + "WP_DETECTION_MODE": "[Options]", |
| 52 | + "WP_USER_AGENT": "[userAgent]", |
| 53 | + "WP_HEADERS": "[headers]" |
| 54 | + } |
| 55 | + } |
| 56 | + } |
| 57 | +] |
| 58 | +``` |
| 59 | + |
| 60 | +Options for enumerate attribute: |
| 61 | + |
| 62 | +```txt |
| 63 | +Enumeration Process |
| 64 | +Available Choices: |
| 65 | + vp | Vulnerable plugins |
| 66 | + ap | All plugins |
| 67 | + p | Plugins |
| 68 | + vt | Vulnerable themes |
| 69 | + at | All themes |
| 70 | + t | Themes |
| 71 | + tt | Timthumbs |
| 72 | + cb | Config backups |
| 73 | + dbe | Db exports |
| 74 | + u | User IDs range. e.g: u1-5 |
| 75 | + Range separator to use: '-' |
| 76 | + Value if no argument supplied: 1-10 |
| 77 | + m | Media IDs range. e.g m1-15 |
| 78 | + Note: Permalink setting must be set to "Plain" for those to be detected |
| 79 | + Range separator to use: '-' |
| 80 | + Value if no argument supplied: 1-100 |
| 81 | +
|
| 82 | +Separator to use between the values: ',' |
| 83 | +Default: All Plugins, Config Backups |
| 84 | +Value if no argument supplied: vp,vt,tt,cb,dbe,u,m |
| 85 | +Incompatible choices (only one of each group/s can be used): |
| 86 | + - vp, ap, p |
| 87 | + - vt, at, t |
| 88 | +``` |
| 89 | + |
| 90 | +## Build with docker |
| 91 | + |
| 92 | +To build the docker container run: |
| 93 | + |
| 94 | +`docker build -t IMAGE_NAME:LABEL .` |
| 95 | + |
| 96 | +[scb-project]: https://github.com/secureCodeBox/secureCodeBox |
| 97 | +[scb-developer-guide]: https://github.com/secureCodeBox/secureCodeBox/blob/develop/docs/developer-guide/README.md |
| 98 | +[scb-developer-guidelines]: https://github.com/secureCodeBox/secureCodeBox/blob/develop/docs/developer-guide/README.md#guidelines |
| 99 | +[scb-user-guide]: https://github.com/secureCodeBox/secureCodeBox/tree/develop/docs/user-guide |
0 commit comments