Skip to content

Discover the power of Mech, an automated solution designed to supercharge penetration testing workflows.

License

Notifications You must be signed in to change notification settings

testcomputer/mech

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐™ผ๐™ด๐™ฒ๐™ท ๐šŸ๐Ÿท.0.๐Ÿป ๐š‹๐šข @๐š๐šŽ๐šœ๐š๐šŒ๐š˜๐š–p๐šž๐š๐šŽ๐š›

version Language License

Image

๐™ผ๐šŽ๐šŒ๐š‘ ๐๐ž๐ง๐ž๐ญ๐ซ๐š๐ญ๐ข๐จ๐ง ๐šƒ๐šŽ๐šœ๐š๐š’๐š—๐š

the Power of Mech

Mech is an intelligent and automated solution meticulously crafted to simplify the complexities of penetration testing. Its purpose is clear: to equip security professionals with an advanced tool that seamlessly integrates into their workflow, enhancing their capabilities and efficiency. At its core, Kaboom is a multi-faceted tool that excels in two fundamental phases of penetration testing: information gathering and vulnerability assessment. This automated powerhouse streamlines the process, allowing testers to focus on analyzing results rather than grappling with manual tasks.

For assistance on installing, check out our Installation Walkthrough.

๐”๐ฌ๐š๐ ๐ž

Mech with both interactive and non-interactive modes:

  • ๐ˆ๐ง๐ญ๐ž๐ซ๐š๐œ๐ญ๐ข๐ฏ๐ž ๐ฆ๐จ๐๐ž:

Just type kaboom and hit [ENTER], and the script handles the rest

		โ”Œโ”€โ”€(rootใ‰ฟtest-station)-[/home/user1/kaboom/kaboom]
		โ””โ”€# kaboom
		Insert hosts (example 192.168.1.1-5):
		>> 10.10.10.222
		Insert path where to save results (without final /):
		>> /home/user1/Documents
		choice the phases to perform [i=IG, v=VA, d=dictionary]:
		>> iv
		Shutdown pc at the end of script [YES/NO] (default NO):
		>> NO
  • ๐๐จ๐ง-๐ข๐ง๐ญ๐ž๐ซ๐š๐œ๐ญ๐ข๐ฏ๐ž ๐ฆ๐จ๐๐ž:

Use the command kaboom -t <target_ip> -f <report_path> [-p one_or_more_phases] for specific targeting and reporting.

		โ”Œโ”€โ”€(rootใ‰ฟtest-station)-[/home/user1/kaboom]
		โ””โ”€# kaboom -t 10.10.11.579 -f scan-results.txt /home/user1/Documents

๐™ต๐š˜๐š› ๐™ท๐šŽ๐š•๐š™

If you need assistance, run kaboom -h (or kaboom --help) to access the help menu and explore available options.

		โ”Œโ”€โ”€(rootใ‰ฟtest-station)-[/home/user1/kaboom/kaboom]
		โ””โ”€# kaboom --help
		Usage:
		  Interactive mode:
		      kaboom [ENTER]  ...and the script does the rest
		
		  NON-interactive mode:
		      kaboom -t <target_ip> -f <report_path> [-p one_or_more_phases]
		
		      phases:
		          - i == information gathering
		          - v == vulnerability assessment
		          - d == dictionary attack against open services
		
		      example: iv == information gathering + vulnerability assessment
		      dafault: ALL (ivb)

๐„๐ง๐ก๐š๐ง๐œ๐ž ๐˜๐จ๐ฎ๐ซ ๐๐ž๐ง๐ž๐ญ๐ซ๐š๐ญ๐ข๐จ๐ง ๐“๐ž๐ฌ๐ญ๐ข๐ง๐  ๐’๐ญ๐ซ๐š๐ญ๐ž๐ ๐ฒ ๐ฐ๐ข๐ญ๐ก ๐™ผ๐šŽ๐šŒ๐š‘

Revolutionize your penetration testing approach with Kaboom. This powerful tool redefines efficiency and precision in the cybersecurity landscape. Kaboom isn't just a collection of functions โ€“ it's a streamlined solution that enhances your capabilities.

Gone are complex interfaces and scattered data. Kaboom-APT simplifies and streamlines your processes, allowing you to focus on analysis and action. It automates tasks, saving you time and guiding you towards impactful insights.

Kaboom's strength lies in its ability to uncover vulnerabilities that were previously hidden. By integrating tools like Sublist3r and Nmap, it empowers you to navigate your digital landscape with clarity and precision.

Embrace Kaboom as your essential companion in the realm of cybersecurity. By doing so, you're amplifying your skills and expertise, ensuring a successful and secure digital journey. Your path to efficiency and proficiency begins with Kaboom-APT โ€“ the ultimate tool for modern penetration testing.

			    _.-^^---....,,--       
			
			 _--                  --_  
			
			<                        >)
			
			|                         | 
			
			 \._                   _./  
			
			    ```--. . , ; .--'''       
			
			          | |   |             
			
			       .-=||  | |=-.   
			
			       `-=#$%&%$#=-'   
			
			          | ;  :|     
			
			 _____.,-#%&$@%#&#~,._____


		โ”Œโ”€โ”€(rootใ‰ฟtest-station)-[/home/user1/kaboom/kaboom]
		โ””โ”€# kaboom
		Insert hosts (example 192.168.1.1-5):
		>> 10.10.10.222
		Insert path where to save results (without final /):
		>> /home/user1/Documents
		choice the phases to perform [i=IG, v=VA, d=dictionary]:
		>> iv
		Shutdown pc at the end of script [YES/NO] (default NO):
		>> NO
		
		[*******************************************************]
		[***]START SCRIPT AT Thu Aug 17 06:55:51 PM MDT 2023[***]
		[*******************************************************]
		
		----------------------------------
		----------------------------------
		ITAREATION:   1
		TARGET:   10.10.10.222
		PROGRESS: [===================>]
		----------------------------------

		[PHASE:]starting IG...
	
	        [+] Network Mapper activated. Connection establishing...
	        [*] Scanning the network...

		Starting Nmap 7.94 ( https://nmap.org ) at 2023-08-17 18:54 MDT
		Illegal character(s) in hostname -- replacing with '*'
		Illegal character(s) in hostname -- replacing with '*'
		Nmap scan report for http:**delivery.htb (10.10.10.222)
		Host is up (0.13s latency).
		
		PORT   STATE SERVICE
		22/tcp open  ssh
		| ssh-hostkey: 
		|   2048 9c:40:fa:85:9b:01:ac:ac:0e:bc:0c:19:51:8a:ee:27 (RSA)
		|   256 5a:0c:c0:3b:9b:76:55:2e:6e:c4:f4:b9:5d:76:17:09 (ECDSA)
		|_  256 b7:9d:f7:48:9d:a2:f2:76:30:fd:42:d3:35:3a:80:8c (ED25519)
		80/tcp open  http
		|_http-title: Welcome
		
		Nmap done: 1 IP address (1 host up) scanned in 5.06 seconds
		
		[PHASE:]starting VA...
		

		==================================================================
		--------โ€ข?((ยฏยฐยท..โ€ข Vulnerability Report โ€ข._.ยทยฐยฏ))ุŸโ€ข --------------
		==================================================================
				   Critical: 0
				   High: 1
				   Medium: 3
				   Low: 1
				   Info: 5
				   Score: 37
		===================================================================
		
		[*****************************************************************]
		[**********] END SCRIPT AT Thu Aug 17 06:54:39 PM MDT 2023 [******]
		[*****************************************************************]

๐‚๐ฎ๐ฌ๐ญ๐จ๐ฆ๐ข๐ณ๐š๐ญ๐ข๐จ๐ง & ๐™ฒ๐š˜๐š—๐š๐š’๐š๐šž๐š›๐šŠ๐š๐š’๐š˜๐š—

To further tailor Kaboom to your needs, you can provide additional arguments and customize its behavior:

  • Configuration Files: Kaboom supports configuration files for fine-tuning its operation.

  • Wordlists: Customize wordlists for dictionary attacks using Hydra and Dirb, enhancing attack efficiency.

  • Output Customization: Personalize output file names and locations to match your preferences.

Kaboom recognizes that each engagement requires a unique approach. Customize the tool to your specific needs:

  • Adjust variables for tailored wordlists and output filenames.

๐„๐ฑ๐š๐ฆ๐ฉ๐ฅ๐ž ๐œ๐ฎ๐ฌ๐ญ๐จ๐ฆ๐ข๐ณ๐š๐ญ๐ข๐จ๐ง๐ฌ

		HYDRA_WORDLIST="custom_hydra_wordlist.txt"
		DIRB_WORDLIST="custom_dirb_wordlist.txt"
	  	OUTPUT_FILENAME="custom_report.txt"

๐€๐๐ฃ๐ฎ๐ฌ๐ญ๐ข๐ง๐  ๐™ผ๐šŽ๐šŒ๐š‘'๐ฌ ๐•๐š๐ซ๐ข๐š๐›๐ฅ๐ž๐ฌ

Kaboom empowers you to customize its behavior by adjusting variables at the script's outset. This allows you to tailor the tool to your specific requirements, whether it's selecting wordlists for Hydra and Dirb, specifying a Metasploit scan script, or refining output file names. Kaboom ushers in a new era of penetration testing, where automation, efficiency, and precision converge to yield unparalleled results. With its advanced features and user-friendly interface, Kaboom is your ally in fortifying digital landscapes against potential threats. Experience the power of Kaboom and elevate your penetration testing game today.

Update to all Mech file path.

		#KABOOM_PATH=''		# THE PATH COULD BE SET HERE INSTEAD OF IN BASHRC FILE
		
		if [[ "$KABOOM_PATH" == '' ]]; then
			KABOOM_PATH='.'
		fi
		
		# USER WORDLISTS
		USERLIST_HYDRA_SSH="$KABOOM_PATH/user_wordlist_short.txt"
		USERLIST_HYDRA_POP3="$KABOOM_PATH/user_wordlist_short.txt"
		USERLIST_HYDRA_IMAP="$KABOOM_PATH/user_wordlist_short.txt"
		USERLIST_HYDRA_RDP="$KABOOM_PATH/user_wordlist_short.txt"
		USERLIST_HYDRA_SMB="$KABOOM_PATH/user_wordlist_short.txt"
		
		# PASSWORD WORDLISTS
		PASSLIST_HYDRA="$KABOOM_PATH/fasttrack.txt"
		PASSLIST_HYDRA_SSH="$PASSLIST_HYDRA"
		PASSLIST_HYDRA_POP3="$PASSLIST_HYDRA"
		PASSLIST_HYDRA_IMAP="$PASSLIST_HYDRA"
		PASSLIST_HYDRA_RDP="$PASSLIST_HYDRA"
		PASSLIST_HYDRA_SMB="$PASSLIST_HYDRA"
		
		# DIRB WORDLISTS
		HTTP_WORDLIST="$KABOOM_PATH/custom_url_wordlist.txt"
		HTTP_EXTENSIONS_FILE="$KABOOM_PATH/custom_extensions_common.txt"
		
		# METASPLOIT SCAN SCRIPT
		METASPLOIT_SCAN_SCRIPT='./metasploit_scan_script'
		
		# NMAP FILES
		SCRIPT_SYN='script-syn'
		UDP='udp'
		SYN='syn'
		```

Here's a brief breakdown of what the script does:

  • Setting Mech Path: The script starts by checking whether the MECH_PATH variable is already set. If it's not set, the script assigns the current directory (.) to the MECH_PATH variable.

  • Defining User Wordlists: The script defines various USERLIST_HYDRA_* variables that point to user wordlists for different protocols like SSH, POP3, IMAP, RDP, and SMB. These wordlists likely contain usernames or accounts for dictionary attacks.

  • Defining Password Wordlists: Similar to user wordlists, the script defines PASSLIST_HYDRA_* variables for different protocols, pointing to password wordlists. These wordlists are used for dictionary attacks to try different passwords for each account.

  • Defining Dirb Wordlists: The script sets the HTTP_WORDLIST variable for custom URL wordlists and HTTP_EXTENSIONS_FILE for common file extensions. These are likely used in the Dirb tool to perform web resource enumeration.

  • Setting Metasploit Scan Script: The METASPLOIT_SCAN_SCRIPT variable is set to the path of a Metasploit scan script. This script might be used by Kaboom to automate Metasploit scans.

  • Defining Nmap Files: The SCRIPT_SYN, UDP, and SYN variables are set to specific Nmap file names. These could be used to customize the Nmap scan behavior within Kaboom.

In summary, this script aims to enhance the customization and flexibility of Kaboom by allowing users to specify different paths, wordlists, and scripts to be used during penetration testing. This level of customization helps security professionals adapt the tool to their specific testing scenarios and requirements.

๐Œ๐ฎ๐ฅ๐ญ๐ข-๐“๐š๐ซ๐ ๐ž๐ญ ๐’๐ฉ๐ž๐œ๐ข๐Ÿ๐ข๐œ๐š๐ญ๐ข๐จ๐ง

Efficiency matters in penetration testing. Kaboom answers this need with multi-target specification:

Efficiently assess multiple targets by defining up to 254 hosts within a C-class network.

    	kaboom -t <target_ip> -f <report_path> -p one_or_more_phases

Elevating Interaction: The New CLI Interface

Interacting with Kaboom is more intuitive than ever:

A revamped Command Line Interface (CLI) simplifies command entry and navigation.

	kaboom -t <target_ip> -f <report_path> -p one_or_more_phases

Precision in Discovery: Enhanced Nmap Scans

Kaboom's Nmap scan functionality has transformed:

Detailed insights into open ports and services facilitate vulnerability identification.

	kaboom -t <target_ip> -f <report_path> -p nmap

Structured Clarity: Streamlined Directory Hierarchy

Managing data across multiple targets made easy:

An optimized directory hierarchy simplifies data organization and analysis.

	# Directory hierarchy
	/home/user1/Documents/kaboom/target1
	/home/user1/Documents/kaboom/target2

Automating Insights: Automatic Metasploit Research

Simplify association of Metasploit modules with CVE codes:

Automate exploit identification during vulnerability assessments.

 	 kaboom -t <target_ip> -f <report_path> -p metasploit

Widening the Scope: Non-Canonical Port Recognition

Modern networks harbor services on non-canonical ports:

Mech's features detects and assesses services on non-standard ports.

          			     __,-~~/~    `---.
		
		                   _/_,---(      ,    )
		
		               __ /        <    /   )  \___
		
		- ------===;;;'====------------------===;;;===----- -  -----
		
		                  \/  ~"~"~"~"~"~\~"~)~"/
		
		                  (_ (   \  (     >    \)
		
		                   \_( _ <         >_>'
		
		                      ~ `-i' ::>|--"
		
		                          I;|.|.|
		
		                         <|i::|i|`.
		
		                        (` ^'"`-' ")
				 _____.,-#%&$@%#&#~,._____				                       

		         
	kaboom -t <target_ip> -f <report_path> -p non_canonical_ports

๐“๐ฐ๐ข๐ง ๐๐ซ๐จ๐ญ๐ก๐ž๐ซ - ๐“๐ซ๐ข๐ ๐ฆ๐š๐ฉ: ๐€ ๐๐š๐ซ๐š๐ฅ๐ฅ๐ž๐ฅ ๐„๐ง๐๐ž๐š๐ฏ๐จ๐ซ

As Kaboom evolved, a parallel project named Trigmap (Trigger Nmap) emerged. Trigmap shares similar objectives with Kaboom but adopts a distinct approach. This sibling tool relies exclusively on Nmap to execute its tasks. The synergy between Kaboom and Trigmap enriches penetration testing endeavors, offering a comprehensive toolkit for varying scenarios. In a world where network security remains paramount, Trigmap emerges as a powerful ally, facilitating network audits, vulnerability assessments, and reconnaissance with efficiency and clarity. Leveraging the strength of Nmap's scripting engine (NSE), Trigmap orchestrates a symphony of tasks to achieve a holistic view of the target network. Its capacity to leverage Nmap's NSE capabilities and translate them into an accessible format makes Trigmap an indispensable asset for security practitioners seeking an advanced yet approachable solution for network analysis.

To delve deeper into Trigmap's capabilities, visit the Trigma repository

๐‘ฌ๐’•๐’‰๐’Š๐’„๐’‚๐’ ๐‘น๐’†๐’”๐’‘๐’๐’๐’”๐’Š๐’ƒ๐’Š๐’๐’Š๐’•๐’š: ๐‘ป๐’‰๐’† ๐‘ซ๐’Š๐’”๐’„๐’๐’‚๐’Š๐’Ž๐’†๐’“

Kaboom-APT is a tool of empowerment, carefully crafted for cybersecurity professionals striving to enhance their capabilities. While the potential it holds is awe-inspiring, it comes hand in hand with a profound responsibility. As you embark on your journey with Kaboom-APT, we emphasize the need for ethical conduct, responsible use, and a steadfast commitment to upholding the principles of cybersecurity.Kaboom is a tool designed to empower cybersecurity professionals, but its power comes with an inherent responsibility. We stress the importance of ethical conduct and responsible use. The authors and contributors behind Kaboom underline several crucial principles:Responsible Usage: Kaboom is intended solely for legitimate and ethical penetration testing. It should never be employed for malicious or unlawful activities, aligning with the highest standards of professional conduct. Authorized Testing: Prior authorization is essential before using Kaboom for penetration testing. Unauthorized use can lead to unintended consequences and legal actions.Informed Consent: Always ensure that you have obtained informed consent from system or network owners before conducting tests. Transparent communication is key.Respect for Privacy: Uphold privacy and confidentiality during testing, refraining from accessing or sharing sensitive information without proper authorization. Limited Scope: Use Kaboom with discretion to avoid disruptions or harm to systems. Excessive scanning should be avoided.

Build and Deploy

About

Discover the power of Mech, an automated solution designed to supercharge penetration testing workflows.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 95.0%
  • Python 5.0%