Voltar ao ranking

jordanpotti/AWSBucketDump

Python

Security Tool to Look For Interesting Files in S3 Buckets

s3-bucketpenetration-testingbugbountyenumeration
Crescimento de estrelas
Estrelas
1.5k
Forks
245
Crescimento semanal
Issues
3
5001k
jan. de 2023mar. de 2024mai. de 2025jul. de 2026
ArtefatosPyPIpip install awsbucketdump
README

AWSBucketDump

AWSBucketDump is a tool to quickly enumerate AWS S3 buckets to look for loot. It's similar to a subdomain bruteforcer but is made specifically for S3 buckets and also has some extra features that allow you to grep for delicious files as well as download interesting files if you're not afraid to quickly fill up your hard drive.

@ok_bye_now

Pre-Requisites

Non-Standard Python Libraries:

  • xmltodict
  • requests
  • argparse

Created with Python 3.6

Install with virtualenv

source venv/bin/activate
pip install -r requirements.txt

General

This is a tool that enumerates Amazon S3 buckets and looks for interesting files.

I have example wordlists but I haven't put much time into refining them.

https://github.com/danielmiessler/SecLists will have all the word lists you need. If you are targeting a specific company, you will likely want to use jhaddix's enumall tool which leverages recon-ng and Alt-DNS.

https://github.com/jhaddix/domain && https://github.com/infosec-au/altdns

As far as word lists for grepping interesting files, that is completely up to you. The one I provided has some basics and yes, those word lists are based on files that I personally have found with this tool.

Using the download feature might fill your hard drive up, you can provide a max file size for each download at the command line when you run the tool. Keep in mind that it is in bytes.

I honestly don't know if Amazon rate limits this, I am guessing they do to some point but I haven't gotten around to figuring out what that limit is. By default there are two threads for checking buckets and two buckets for downloading.

After building this tool, I did find an interesting article from Rapid7 regarding this research.

Usage:

usage: AWSBucketDump.py [-h] [-D] [-t THREADS] -l HOSTLIST [-g GREPWORDS] [-m MAXSIZE]

optional arguments:
  -h, --help    show this help message and exit
  -D            Download files. This requires significant diskspace
  -d            If set to 1 or True, create directories for each host w/ results
  -t THREADS    number of threads
  -l HOSTLIST
  -g GREPWORDS  Provide a wordlist to grep for
  -m MAXSIZE    Maximum file size to download.

 python AWSBucketDump.py -l BucketNames.txt -g interesting_Keywords.txt -D -m 500000 -d 1

Contributors

jordanpotti

grogsaxle

codingo

aarongorka

BHaFSec

paralax

fzzo

rypb

Repositórios relacionados
kahing/goofys

a high-performance, POSIX-ish Amazon S3 file system written in Go

GoGo ModulesApache License 2.0s3-buckets3
5.6k534
knadh/koanf

Simple, extremely lightweight, extensible, configuration management library for Go. Supports JSON, TOML, YAML, env, command line, file, S3 etc. Alternative to viper.

GoGo ModulesMIT Licenseconfigurationconfiguration-management
4.1k193
minio/mc

Unix like utilities for object store

GoGo ModulesGNU Affero General Public License v3.0storageaws-s3
min.io/download
3.5k682
0x4447/0x4447_product_s3_email

📫 A serverless email server on AWS using S3 and SES

MIT License0x4447s3
0x4447.com
3k162
nsonaniya2010/SubDomainizer

A tool to find subdomains and interesting things hidden inside, external Javascript files of page, folder, and Github.

PythonPyPIMIT Licensepython3security-tools
1.9k235
good-lly/s3mini

⚠️ Moved to Codeberg: https://codeberg.org/thinking_tools/s3mini - Tiny S3 client. Edge computing ready. No-dep. In Typescript.

JavaScriptnpmMIT Licenseaws-s3ceph
npmjs.com/package/s3mini
1.3k22
minio/minio-java

MinIO Client SDK for Java

JavaMavenApache License 2.0librariessdk
docs.min.io/docs/java-client-quickstart-guide.html
1.3k521
0xsha/CloudBrute

Awesome cloud enumerator

GoGo ModulesMIT Licensebugbountycloud
1.1k159
minio/minio-py

MinIO Client SDK for Python

PythonPyPIApache License 2.0miniominio-client
docs.min.io/docs/python-client-quickstart-guide.html
1.1k370
okhosting/awesome-storage

A curated list of storage open source tools. Backups, redundancy, sharing, distribution, encryption, etc.

MIT Licensecurated-listsawesome
okhosting.com
1k71