A tool to enumerate S3 buckets manually or via certstream
Switch branches/tags
Nothing to show
Clone or download
Latest commit e5db4c0 Dec 29, 2017
Permalink
Failed to load latest commit information.
vendor punycode checks Dec 5, 2017
.gitignore build cleanup Dec 3, 2017
LICENSE Update LICENSE Dec 29, 2017
README.md complete sentences pls ;) Dec 29, 2017
build.sh build cleanup Dec 3, 2017
main.go help update Dec 25, 2017
permutations.json Update permutations.json Dec 18, 2017

README.md

slurp

Enumerates S3 buckets manually or via certstream

Overview

Modes

Certstream

certstream

Domain

domain

Keywords

keyword

Features

  • Written in Go:
    • It's faster than python.
    • No dependency hell and version locks (ie python 3 and requirements.txt, etc); easier to deploy, static binary, etc.
    • Better concurrency.
  • Punycode support for internationalized domains (S3 doesn't allow internationalized buckets; so this app just notifies and skips (certstream) or exits (domain mode)).
  • Domain mode so that you can test individual domains.
  • New Keywords mode so that you can attempt enumeration based on keywords. Why is this useful? Sometimes organizations have shorthand names that they go by. If you wanted to test that shorthand name you could not do so previously; now you can by using this mode of enumeration.
  • New Supports a list of domains now.
  • Certstream mode so that you can enumerate s3 buckets in real time.
  • Colorized output for visual grep.
  • Currently generates over 1200 permutations per domain and keyword.
  • Strong copyleft license.

Usage

  • slurp domain <-t|--target> google.com will enumerate the S3 domains for a specific target.
  • slurp keyword <-t|--target> linux,golang,python will enumerate S3 buckets based on those 3 key words.
  • slurp certstream will follow certstream and enumerate S3 buckets from each domain.
  • permutations.json stores the permutations that are used by the program; they are in JSON format and loaded during execution this is required; it assumes a specific format per permutation: anything_you_want.%s; the ending .%s is required otherwise the AWS S3 URL will not be attached to it, and therefore no results will come from S3 enumeration. If you need flexible permutations then see PermutateDomain function.

Installation

  • Download from Releases section, or build yourself with go build or build.sh.
    • Make sure you clone to $GOPATH/src or you will get build errors!

License

  • AGPLv3