Skip to main content

The client component of the Bug Bounty Reconnaissance Framework (BBRF)

Project description

bbrf-client

Introduction

The client component of the Bug Bounty Reconnaissance Framework (BBRF) is intended to facilitate the workflows of security researchers across multiple devices.

Read the blog post: https://honoki.net/2020/10/08/introducing-bbrf-yet-another-bug-bounty-reconnaissance-framework/

The primary function of the client is providing easy access to information that is stored in a centralized BBRF document store. For example, to quickly create and initialize a new program with a couple of domains, you can try:

# create a new program
bbrf new vzm
bbrf inscope add '*.yahoo.com' '*.yahoo.be'
bbrf domain add www.yahoo.com www.yahoo.be

To add a list of ips from a file or other program, you can pipe into bbrf:

bbrf use vzm
cat ips.txt | bbrf ip add -

Now, to list all known domains belonging to the active program:

bbrf domains

Documentation

  • Install the CouchDB server - Ensure you have set up a BBRF server before using the client;
  • Configure the client - learn how to start using the client on your workstations;
  • AWS Lambda - for more advanced use cases, deploy a bbrf client to AWS Lambda to integrate with bbrf agents and other lambdas;
  • Usage - view a number of more advanced examples, and learn how to set up a listener.

Dashboard

If you like looking at your data in another way than via a terminal window, you can make use of the bbrf dashboard on https://bbrf.me. Just plug in your server URL, username and password, and the dashboard will pull your data and make it searchable. Note that all communication to the server happens via your browser, so your data remains safe!

asciicast

If you're having CORS-related issues, make sure the origin https://bbrf.me is explicitly allowed in your database configuration:

curl -X PUT $COUCHDB"_node/_local/_config/cors/origins" -u admin:password -d '"https://bbrf.me"'

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bbrf-1.0.6.tar.gz (15.7 kB view hashes)

Uploaded Source

Built Distribution

bbrf-1.0.6-py3-none-any.whl (17.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page