Hunt for vulnerable websites as you browse.
JavaScript HTML CSS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dist
src
store_assets
.gitattributes
.gitignore
LICENSE.md
README.md
gulpfile.js
package.json

README.md

Bishop

Bishop is a vulnerability scanner that searches websites in the background while you browse, looking for exposed version control systems, misconfigured administrative tools, and more.

It works by searching for files with a given path on the current URL path and all parent paths, applying given regex to the results to check for proof positive of a vulnerable location. If the path returns 200 and matches the regex, it's flagged as vulnerable and alerts you. All rules are run on all directories in a set of time-staggered background XHR requests, so network throughput remains high at all times.

Bishop comes with a set of rules that hunt for the lowest hanging fruit, but the rule system is entirely extensible - rules are regular expressions that are run on specified directories, so if you can turn it into a regex, Bishop will look for it. Try loading Bishop with the demo ruleset and see how it works. The risk classification allows you to set different tiers of vulnerability so applications can be tested to stricter or looser security guidelines.

Bishop is intended SOLELY for legal use on web servers that you control or are permitted to scan, and the developers are not responsible for how you choose to use this software. Be safe and legal with this tool.

Bishop is MIT licensed and open source; contribute at https://github.com/jkingsman/bishop.

Installation

After either installation method, you'll need to setup your inclusion whitelist (see the introduction on first run for more info).

Automatic

Download from the Chrome Web Store.

Image of Chrome Store Badge

Manual

You'll need node and npm set up on your system (which is beyond the scope of this README), and gulp installed (npm install -g gulp if you don't already have it).

  1. Clone this repo:

git clone git@github.com:jkingsman/bishop.git

  1. Move into it:

cd bishop

  1. Install the gulp dependencies:

npm install

  1. Make sure the build directory is empty:

gulp empty

  1. Build it, using any of the following commands:
gulp command result
gulp Lint the code and build the src directory into the dist directory. dist can be imported as an unpacked extension.
gulp zip Lint the code and build the src directory into the dist directory, then zip the dist directory into bishop.zip in the root bishop folder.
gulp watch Build the src directory into the dist directory and rebuild on changes to src.
gulp hint Lint all non-lib js. Doesn't build anything; done as part of gulp and gulp zip.

Adding Rules to the Code

If you have a general rule that you think others could find helpful, feel free to PR it. The fields are pretty self explanatory and match the GUI rule addition interface. The uid field can be left as is; it's just adding the unique ID for the rule. Risk is intended to describe the relative risk that such a vulnerability would indicate, allowing you to include stricter or looser security requirements for different applications.

Notes

  • Bishop is built on sending background XHR requests, many of which will result in 404's. These will show up in your console log, so be aware of that when browsing. If you feel comfortable ignoring 404's, you can check the "Hide network messages" box at the top of the console window.

  • The import formats are as follows:

    • rules

      • [{"description":"a few words descripting it","enabled":true,"name":"The Rule Name","risk":"low","searchString":"the regex to execut","uid":"random hex ID","url":"what URL addition (if any) to run the regex on"}, {...}]
    • sites

      • [{"rule":"matched rule name","uid":"random hex uid","url":matched URL"}, {...}]

License

MIT.


Flattr this