{"id":22111643,"url":"https://github.com/phx/bucketfinder","last_synced_at":"2025-06-22T12:01:59.744Z","repository":{"id":62461500,"uuid":"560625123","full_name":"phx/bucketfinder","owner":"phx","description":"An updated implementation of bucket_finder.rb","archived":false,"fork":false,"pushed_at":"2022-11-01T23:08:07.000Z","size":6,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-03T07:19:11.264Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-01T22:48:49.000Z","updated_at":"2022-11-01T23:05:22.000Z","dependencies_parsed_at":"2022-11-02T00:46:43.732Z","dependency_job_id":null,"html_url":"https://github.com/phx/bucketfinder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phx%2Fbucketfinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phx%2Fbucketfinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phx%2Fbucketfinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phx%2Fbucketfinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phx","download_url":"https://codeload.github.com/phx/bucketfinder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245211853,"owners_count":20578437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-01T10:49:56.837Z","updated_at":"2025-03-24T04:34:05.862Z","avatar_url":"https://github.com/phx.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bucket Finder\n\n**From Original Author:**\n\nCopyright(c) 2011, Robin Wood \u003crobin@digininja.org\u003e\n\nThis project goes alongside my blog post \"Whats In Amazon's Buckets?\"\nhttp://www.digininja.org/blog/whats_in_amazons_buckets.php , read through that\nfor more information on what is going on behind the scenes.\n\nThis is a fairly simple tool to run, all it requires is a wordlist and it will\ngo off and check each word to see if that bucket name exists in the Amazon's\nS3 system. Any that it finds it will check to see if the bucket is public,\nprivate or a redirect.\n\nPublic buckets are checked for directory indexing being enabled, if it is then\nall files listed will be checked using HEAD to see if they are public or private.\nRedirects are followed and the final destination checked. All this is reported\non so you can later go through and analyse what has been found.\n\n## Version\n1.0 - Release\n1.1 - Added logging to file\n1.2 - Fixed and added support for installation via PyPi (phx)\n\n## Installation\n\nI don't think it needs anything more than the built in modules so you shouldn't\nneed to install any gems. Just grab the file, make it executable and run it.\n\nI've tested it in Ruby 1.8.7 and 1.9.1 so there should be no problems with versions.\n\n## Usage\n\nBasic usage is simple, just start it with a wordlist:\n\n`bucketfinder my_words`\n\nand it will go off and do your bidding.\n\nYou can specify which region you want to run the initial check against by using\nthe `--region` parameter:\n\n`bucketfinder --region ie my_words`\n\nThe script will follow all redirects anyway so even if left at default, US Standard,\neverything will be found that can be found but if most of the buckets you are\nfinding are in a different region then you'll be doing a lot of redirects so doubling\nyour network traffic.\n\nYou can also specify the `--download` option to download all public files found. Be\ncareful with this as there are a lot of large files out there. I'd personally do\nthe general search then only use this option with a select subset of bucket names:\n\n`bucketfinder --download --region ie my_words`\n\nThe files are downloaded into a folder with the bucket name and then the appropriate\nstructure from the bucket. \n\nAs some people are having trouble piping the output to files or other apps I've added\na logging option to send all output to a file. To use this just use the `--log-file` \nparameter:\n\n`bucketfinder --log-file bucket.out my_words`\n\n## Licence\n\nThis project released under the following license:\n\n[Creative Commons Attribution-Share Alike 2.0 UK: England \u0026 Wales (CC BY-SA 2.0 UK)](http://creativecommons.org/licenses/by-sa/2.0/uk/)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphx%2Fbucketfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphx%2Fbucketfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphx%2Fbucketfinder/lists"}