-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
0ff17a8
commit 62fbb36
Showing
1 changed file
with
76 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1 +1,76 @@ | ||
| # OwnBucket | ||
|
|
||
| # OwnBucket | ||
| [](https://www.python.org/) <a href="https://twitter.com/mayank_pandey01"><img alt="Twitter Follow" src="https://img.shields.io/twitter/follow/mayank_pandey01?style=social"></a> | ||
| [](https://pypi.python.org/pypi/ansicolortags/) [](http://makeapullrequest.com) [](https://github.com/MayankPandey01/OwnBucket) [](https://github.com/ellerbrock/open-source-badges/) | ||
|
|
||
| <p align="center"> | ||
| <img width="750" height="350" src="https://user-images.githubusercontent.com/29165227/210492763-1f3e82ba-9a77-470a-be57-e02e12017335.jpg"></p> | ||
|
|
||
| # 🤔 What's OwnBucket? | ||
|
|
||
| OwnBucket is a Python Based Recon tool for Storage Buckets. It scans for AWS S3 Bucket and GCP Buckets by bruteforcing using different permutations. | ||
|
|
||
|
|
||
| # 🚀 Usage | ||
| OwnBucket can be easily used from the command line | ||
| - `python3 ownbucket.py -t {COMPANY}` | ||
|
|
||
|  | ||
|
|
||
| Additional Arguments can be passed to use tool in different way: | ||
|
|
||
| - `-t` : To Provide a Company Name for Scanning | ||
| - `--aws` : Only Check for AWS S3 Buckets (Default) | ||
| - `--gcp` : Only Check for GCP Buckets | ||
| - `--all` : Check for both AWS S3 and GCP Buckets | ||
|
|
||
| Sometimes the tool reaches the rate limit while scanning S3 buckets, to prevent this from happening `no_of_workers` are reduced to 10 , If you increase this it will result in true-negatives or will give no result at all. | ||
| Kepping less numbers of threads may drastically increase the total execution time of the scanner, but gives better results. | ||
|
|
||
|
|
||
| # 🔧Installation | ||
|
|
||
| ## 🔨 Using Git | ||
| - ` git clone https://github.com/MayankPandey01/OwnBucket` | ||
| - `python3 ownbucket.py -h` | ||
|
|
||
| ## 🧪 Recommended Python Version: | ||
| - This Tool Only Supports Python 3. | ||
| - The recommended version for Python 3 is 3.8.x. | ||
|
|
||
| ## ⛳ Dependencies: | ||
|
|
||
| The dependencies can be installed using the requirements file: | ||
|
|
||
| Installation on Windows:  | ||
| - python.exe -m pip3 install -r requirements.txt. | ||
|
|
||
| Installation on Linux:  | ||
| - sudo python3 pip3 install -r requirements.txt. | ||
|
|
||
|
|
||
| ## 🐞 Bug Bounties | ||
|
|
||
| This tool is focused mainly on `Bug Bounty Hunters` and `Security Professionals` . You Can Use OwnBucket to Scan For Different Storage Buckets of the Target Company. | ||
|
|
||
|
|
||
| ## 🎯 Contribution  | ||
| We Love to Get Contribution from the Open Source Community💙. You are Welcome to Provide your Important Suggestions to make this tool more Awesome. Open a PR and we will See to it ASAP. | ||
|
|
||
| **Ways to contribute** | ||
| - Suggest a feature | ||
| - Report a bug | ||
| - Fix something and open a pull request | ||
| - Spread the word | ||
|
|
||
| ## 📚 DISCLAIMER | ||
|
|
||
| This project is a [personal development](https://en.wikipedia.org/wiki/Personal_development). Please respect its philosophy and don't use it for evil purposes. By using OwnBucket, you agree to the MIT license included in the repository. For more details at [The MIT License — OpenSource](https://opensource.org/licenses/MIT). | ||
|
|
||
| Happy Hacking ✨✨ | ||
|
|
||
| > This Tool is Highly Motivated by [LazyS3](https://github.com/nahamsec/lazys3) | ||
| ## 📃 Licensing | ||
|
|
||
| This project is licensed under the MIT license. |