AWSBucketDump

Security assessment tool for finding and dumping AWS S3 buckets

Cloud & Assets7 commands

#s3#aws#bucket#dump

Installation

1Clone repository

2Install dependencies

3Verify installation

# Clone repository
git clone https://github.com/jordanpotti/AWSBucketDump.git
cd AWSBucketDump

# Install dependencies
pip install -r requirements.txt

# Verify
python3 AWSBucketDump.py -h

Basic Usage

Check a list of S3 bucket names and optionally download their contents

# Check bucket names from file
python3 AWSBucketDump.py -l bucketnames.txt

# Dump contents of open buckets
python3 AWSBucketDump.py -l bucketnames.txt -D

# Check with specific size limit
python3 AWSBucketDump.py -l bucketnames.txt -g 100

# Check single bucket
python3 AWSBucketDump.py -b my-bucket-name

# Output results
python3 AWSBucketDump.py -l bucketnames.txt -o results.txt

Command Reference

7 commands

1File containing bucket names

-l

2Single bucket name to check

-b

3Download contents of open buckets

-D

4Max file size in MB to download

-g

5Output file for results

-o

6AWS region

-r

7Number of threads

-t

When to Use

Large-scale S3 bucket discovery and assessment

Data leak investigations

Cloud security audits

Bug bounty S3 enumeration

Notes & Tips

Can download all files from open buckets (be careful with data)

Use -g to limit file size and avoid downloading massive files

Always confirm you have permission before dumping bucket contents

Common Errors & Solutions

Too many files to download

Use -g flag to limit file size in MB

Bucket not accessible

The bucket may exist but not be publicly accessible

# Check bucket names from file python3 AWSBucketDump.py -l bucketnames.txt # Dump contents of open buckets python3 AWSBucketDump.py -l bucketnames.txt -D # Check with specific size limit python3 AWSBucketDump.py -l bucketnames.txt -g 100 # Check single bucket python3 AWSBucketDump.py -b my-bucket-name # Output results python3 AWSBucketDump.py -l bucketnames.txt -o results.txt