add hash cracker tutorial

Author: x4nth055

README.md

@@ -40,6 +40,7 @@ This is a repository of all the tutorials of [The Python Code](https://www.thepy
     - [How to Make a Ransomware in Python](https://www.thepythoncode.com/article/make-a-ransomware-in-python). ([code](ethical-hacking/ransomware))
     - [How to Perform DNS Enumeration in Python](https://www.thepythoncode.com/article/dns-enumeration-with-python). ([code](ethical-hacking/dns-enumeration))
     - [How to Geolocate IP addresses in Python](https://www.thepythoncode.com/article/geolocate-ip-addresses-with-ipinfo-in-python). ([code](ethical-hacking/geolocating-ip-addresses))
+    - [How to Crack Hashes in Python](https://thepythoncode.com/article/crack-hashes-in-python). ([code](ethical-hacking/hash-cracker))
 
 - ### [Machine Learning](https://www.thepythoncode.com/topic/machine-learning)
     - ### [Natural Language Processing](https://www.thepythoncode.com/topic/nlp)

ethical-hacking/hash-cracker/README.md

@@ -0,0 +1,14 @@
+# [How to Crack Hashes in Python](https://thepythoncode.com/article/crack-hashes-in-python)
+To run this:
+- `pip install -r requirements.txt`
+- Get usage: `python crack_hashes.py --help`
+- Crack a SHA-256 hash using `wordlist.txt`:
+    ```bash
+    $ python crack_hashes.py 6ca13d52ca70c883e0f0bb101e425a89e8624de51db2d2392593af6a84118090 wordlist.txt --hash-type sha256
+    ```
+    **Output:**
+    ```
+    [*] Cracking hash 6ca13d52ca70c883e0f0bb101e425a89e8624de51db2d2392593af6a84118090 using sha256 with a list of 14344394 words.
+    Cracking hash:  96%|███████████████████████████████████████████████████████████████████████████████████████████▉    | 13735317/14344394 [00:20<00:00, 664400.58it/s]
+    [+] Found password: abc123
+    ```

ethical-hacking/hash-cracker/crack_hashes.py

@@ -0,0 +1,53 @@
+import hashlib
+from tqdm import tqdm
+
+# List of supported hash types
+hash_names = [
+    'blake2b', 
+    'blake2s', 
+    'md5', 
+    'sha1', 
+    'sha224', 
+    'sha256', 
+    'sha384', 
+    'sha3_224', 
+    'sha3_256', 
+    'sha3_384', 
+    'sha3_512', 
+    'sha512',
+]
+
+def crack_hash(hash, wordlist, hash_type=None):
+    """Crack a hash using a wordlist.
+
+    Args:
+        hash (str): The hash to crack.
+        wordlist (str): The path to the wordlist.
+
+    Returns:
+        str: The cracked hash.
+    """
+    hash_fn = getattr(hashlib, hash_type, None)
+    if hash_fn is None or hash_type not in hash_names:
+        # not supported hash type
+        raise ValueError(f'[!] Invalid hash type: {hash_type}, supported are {hash_names}')
+    # Count the number of lines in the wordlist to set the total
+    total_lines = sum(1 for line in open(wordlist, 'r'))
+    print(f"[*] Cracking hash {hash} using {hash_type} with a list of {total_lines} words.")
+    # open the wordlist
+    with open(wordlist, 'r') as f:
+        # iterate over each line
+        for line in tqdm(f, desc='Cracking hash', total=total_lines):
+            if hash_fn(line.strip().encode()).hexdigest() == hash:
+                return line
+    
+    
+if __name__ == "__main__":
+    import argparse
+    parser = argparse.ArgumentParser(description='Crack a hash using a wordlist.')
+    parser.add_argument('hash', help='The hash to crack.')
+    parser.add_argument('wordlist', help='The path to the wordlist.')
+    parser.add_argument('--hash-type', help='The hash type to use.', default='md5')
+    args = parser.parse_args()
+    print()
+    print("[+] Found password:", crack_hash(args.hash, args.wordlist, args.hash_type))

ethical-hacking/hash-cracker/requirements.txt

@@ -0,0 +1 @@
+tqdm