-->

Bucky - An Automatic S3 Bucket Discovery Tool


Bucky is an automatic tool designed to discover S3 bucket misconfiguration, Bucky consists up of two modules Bucky firefox addon and Bucky backend engine. Bucky addon reads the source code of the webpages and uses Regular Expression(Regex) to match the S3 bucket used as Content Delivery Network(CDN) and sends it to the Bucky Backend engine. The backend engine receives the data from addon and checks if the S3 bucket is publicly writeable or not. Bucky automatically uploads a text file as Proof Of Concept(PoC) if the bucket is vulnerable.


Working

Bucky addon sends the details of s3 bucket name discovered from a user visited web pages to backend engine. It uses AWS PHP SDK to discover misconfiguration. Users can also check for S3 bucket misconfiguration manually. All the results from automatic and manuall check are populated to dashboard.

Checkout video https://vimeo.com/444442588


Installation
git clone https://github.com/smaranchand/bucky.gitcd bucky

Requirements: AWS Access Keys and PHP installation

Get AWS Access Keys: https://console.aws.amazon.com/iam/home?#/security_credentials

PHP installation: Install according to your OS, apt install php7.3 / brew install php7.3

Currently, Bucky addon is not published in the Firefox addon store; as soon as the addon will be published, the addon link will be provided.

For now, users can manually load the addon into the browser to do so

  1. Open Firefox browser and visit about:debugging
  2. Click on "This Firefox" > Load Temporary Add-on
  3. Select the addon located at bucky/addon/bucky.js

Add AWS Access keys:

cd bucky/nano config.inc.php Add your AWS Access Key ID and Secret Access Key. (On-Line 57 and 61)

Usage

To use Bucky, load the Bucky addon to the browser and start backend engine.

cd bucky/chmod +x run.sh./run.shThe backend engine runs on http://127.0.0.1:13337Browse websites, Bucky will discover S3 buckets automatically and will be reflected in the dashboard.Visit the above address to access Bucky dashboard.

Screenshots

Running Bucky


Loading Addon


User Interface

All Buckets


Manual Check


POC By Bucky

Note

Bucky is not a perfect tool to discover S3 buckets, it is well known that Bucky lacks many feautres and it may fail to detect the misconfiguration sometimes. Certain changes and development are in pipeline. I really appreciate the feedbacks and contribution.



Disqus Comments