Need to grep all the large scope domains that you’ve got on your bug bounty platforms? This is the right tool for the job.
What about getting a list of android apps that you are allowed to test? We’ve got you covered as well.
Reverse engineering god? No worries, you can get a list of binaries to analyze too 🙂
Make sure you’ve a recent version of the Go compiler installed on your system. Then just run:
GO111MODULE=on go get -u github.com/sw33tLie/bbscope
bbscope (h1|bc|it) -t <session-token> <other-flags>
How to get the session token:
- HackerOne: login, then grab the
- Bugcrowd: login, then grab the
- Intigriti: login, then intercept a request to api.intigriti.com and look for the
Authentication: Bearer XXXheader. XXX is your token
Remember that you can use the –help flag to get a description for all flags.
Below you’ll find some example commands. Keep in mind that all of them work with Bugcrowd and Intigriti subcommands (
it) as well, not just with
Print all in-scope targets from all your HackerOne programs that offer rewards
bbscope h1 -t <YOUR_TOKEN> -b -o t
The output will look like this:
Print all in-scope targets from all your private HackerOne programs that offer rewards
bbscope h1 -t <YOUR_TOKEN> -b -p -o t
Print all in-scope Android APKs from all your HackerOne programs
bbscope h1 -t <YOUR_TOKEN> -o t -c android
Print all in-scope targets from all your HackerOne programs with extra data
bbscope h1 -t <YOUR_TOKEN> -o tdu -d ", "
This will print a list of in-scope targets from all your HackerOne programs (including public ones and VDPs) but, on the same line, it will also print the target description (when available) and the program’s URL. It might look like this:
something.com, Something's main website, https://hackerone.com/something
*.demo.com, All assets owned by Demo are in scope, https://hackerone.com/demo
Get program URLs for your HackerOne private programs
bbscope h1 -t <YOUR_TOKEN> -o u -p | sort -u
You’ll get a list like this:
Beware of scope oddities
In an ideal world, all programs use the in-scope table in the same way to clearly show what’s in scope, and make parsing easy. Unfortunately, that’s not always the case.
Sometimes assets are assigned the wrong category. For example, if you’re going after URLs using the
-c url, double checking using
-c all is often a good idea.
Other times, on HackerOne, you will find targets written in the scope description, instead of in the scope title. A few programs that do this are:
If you want to grep those URLs as well, you MUST include
d in the printing options flag (
Human minds are weird and this tool does not attempt to parse nonsense, you’ll have to do that manually (or bother people that can make this change, maybe?).