Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stormfleet/cloudcat
A script to automate the creation of cloud infrastructure for hash cracking.
https://github.com/stormfleet/cloudcat
ansible-playbook automated-testing aws-ec2 cloud crack-passwords cracking-hashes hashcat infrastructure password-cracker pentest-tool redteam-infrastructure redteaming wordlists
Last synced: about 1 month ago
JSON representation
A script to automate the creation of cloud infrastructure for hash cracking.
- Host: GitHub
- URL: https://github.com/stormfleet/cloudcat
- Owner: stormfleet
- Created: 2019-07-11T20:30:08.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2019-09-04T19:52:43.000Z (about 5 years ago)
- Last Synced: 2024-04-15T09:25:31.935Z (5 months ago)
- Topics: ansible-playbook, automated-testing, aws-ec2, cloud, crack-passwords, cracking-hashes, hashcat, infrastructure, password-cracker, pentest-tool, redteam-infrastructure, redteaming, wordlists
- Language: Python
- Homepage:
- Size: 120 KB
- Stars: 15
- Watchers: 0
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-password-cracking - Cloudcat - A script to automate the creation of cloud infrastructure for hash cracking. (Cloud)
README
# CloudCat
## Contents
- [Introduction](#introduction)
- [Installation](#installation)
- [Usage](#usage)
- [Coming](#coming)
- [Thanks](#thanks)
- [License](#license)
## Introduction
A Python script to create infrastructure to crack passwords for you in the cloud. CloudCat is just a python wrapper over an Ansible substrate to automate the creation and deletion of AWS's GPU EC2 instances, which make for great crackstations.
AWS's GPU instances have really high specification GPU's capable of outputting a lot of hashing power. They're quite costly, but if you need results quickly they're an excellent resource. The idea is to fire off CloudCat and continue working on penetration tests, and gather the results when it's done.
If you can afford your own beefy crackstation then that's no problem - but if you can't justify purchasing a proper one then AWS is a great alternative. Enhanced computing EC2 instances have really fast GPUs, which are unsurprisingly ideal for cracking hashes. Here are some stats for the 3 EC2 instances supported by CloudCat:
| Hashtype | NVIDIA V100 MH/s x1 |
| ------------ | ---------------- |
| NTLM | 77704.4 MH/s |
| NetNTLMv1 | 44172.1 MH/s |
| NetNTLMv2 | 3809.1 MH/s |
| Kerberos 5 AS-REQ | 996.7 MH/s |
| Kerberos 5 TGS-REP | 996.0 MH/S |
[Here](benchmark.md) is a full benchmark for all Hashcat hashtypes on a p3.2xlarge instance. p3.8x and p3.16xlarge instances use 4 and 8 of the NVIDIA V100 GPUs respectively, so the increase in cracking power is linear.
| Instance | # of NVIDIA V100s |
| -------- | ----------------- |
| p3.2xlarge | x1 |
| p3.8xlarge | x4 |
| p3.16xlarge | x8 |
tl;dr: Don't have the money or can't maintain your own crackstation? Have some cash to spare? Want creds quickly? Automate cracking in the cloud and free up time to continue pentesting.
There isn't full support for simultaneous cracking instances at the moment - it's coming though. Also need support for creating your own wordlist snapshots - I've been using my own but I'll buld it into the script.
A word of warning too for the time being - the destroy script doesn't take notice of multiple instances, so you might want to check your AWS Console to be doubly sure the instance has terminated correctly!
## Installation
Cloudcat requires the following Python dependencies:
```
boto
botocore
boto3
ansible
```
In addition to the following linux packages:
```
awscli
ansible
```
## Usage
```
./cloudcat.py --help
usage: cloudcat.py [-h] [-t {p3.2xlarge,p3.8xlarge,p3.16xlarge}] [-f FILE]
[-m MODE] [-i IDENTITY] [-k SSHKEY]
[-l {short,medium,long}] [--guest-ip DOUBLE] [--setup] [-d]
[-v]
Example usage: ./cloudcat.py -t p3.2xlarge -f /path/to/hashes.txt -m 1000 -i
aws-id -k ssh-keyname -l short
optional arguments:
-h, --help show this help message and exit
-t {p3.2xlarge,p3.8xlarge,p3.16xlarge}, --type {p3.2xlarge,p3.8xlarge,p3.16xlarge}
Size of the instance to use. From cheapest to most
expensive: p3.2xlarge, p3.8xlarge and p3.16xlarge.
-f FILE, --file FILE File containing hashes to crack.
-m MODE, --mode MODE Hashtype cracking mode you want to use. This should
correspond to the modes listed on Hashcat's website.
-i IDENTITY, --identity IDENTITY
AWS identity to use (only select this if you're sure
you have the correct key!).
-k SSHKEY, --ssh-key SSHKEY
SSH key-file name. Used to connect to created CloudCat
instances to conduct tasks and launch Hashcat.
-l {short,medium,long}, --length {short,medium,long}
Length of the hash cracking run. Short is just
rockyou.txt, medium is rockyou and fav_wordlist, and
long is those two and crackstation.txt.
--guest-ip DOUBLE Create an Amazon Security Group where your current
pulic IP address and one other public IP address is
allowed through the firewall. This second location
should be somewhere you always have access to (e.g.
home, office).
--setup Perform CloudCat setup to configure AWS API keys and
region.
-d, --destroy Destroy CloudCat AWS P3.X instances.
-v, --verbose Add verbosity to CloudCat execution.
```
Example usage: ./cloudcat.py -t p3.2xlarge -f /tmp/foo.txt -m 1000 -i awscat -k awscat -l short -s
A full list of Hashcat hashtypes is available [here](https://hashcat.net/wiki/doku.php?id=example_hashes).
Currently CloudCat creates an instance, creates a volume from a public snapshot containing the following wordlists. This needs to be improved, as the more wordlists included the better.
```
rockyou.txt
fav_wordlist.lst
crackstation.txt
```
## Coming
Things that will be coming to CloudCat eventually:
- Support for multiple simultaneous CloudCat instances
- Terraform support
- Robust hash detection to confirm whether hashes are correctly formatted before the instances are brought up (to save money).
- Better management of active hosts to facilitate destruction
- Dockerfile support
- ec2_instance module from ansible is not supported by ansible core - need to migrate to a core supported one so that spot requests are supported.
- Support for other cloud providers: Azure, Oracle, etc. Depends on if they have ansible modules!
## Thanks
Obviously massive thanks to the [Hashcat team](https://github.com/hashcat/hashcat) for the work they do.
Inspired to create this by the following blog posts on AWS-based password cracking: [1](https://hackernoon.com/20-hours-18-and-11-million-passwords-cracked-c4513f61fdb1),[2](https://medium.com/@lordsaibat/cracking-passwords-with-terraform-and-aws-3685cc918721),[3](https://medium.com/@iraklis/running-hashcat-v4-0-0-in-amazons-aws-new-p3-16xlarge-instance-e8fab4541e9b).
## License
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
For more information, please refer to