ASADT | Assistive Search And Discovery Tool

Version: 2.1.0 (ALPHA-RELEASE)
Last Update: March 9th, 2024
KaliOS & ParrotOS Compatible

MAJOR UPDATES!

ASADT has undergone a COMPREHENSIVE OVERHAUL. This revision entails a complete reconfiguration of the codebase, introducing a class-based and function-oriented architectural paradigm. Furthermore, we owe our gratitude to the collaborative efforts of the BlackBox Computer Security Research And Development Team, whose valuable insights have driven substantial transformations in the script's structural composition.

Through this extensive revision, we have substantially streamlined the accessibility and modifiability of the project, thereby facilitating active participation and contributions from the open-source community.

With joyous enthusiasm, we introduce Version 2.1.0 of ASADT!

NEW CLI & TOOLS!

Goodbye with ArgParse and hello Typer! ASADT now uses the TypeCLI class to parse user script input, and also provides Rich compatability, so no more TermColor! ASADT has never looked better!

Please note, this change requires the re-installation of the requirements.txt and or PIP packages.

Additionally, we're excited to announce that with this update, the MSFPC tool has been integrated into the ASADT toolbox! The first (and only) tool in the HackTool Module!

PySimpleGUI API Token Update

Before the initial launch of ASADT, PySimpleGUI was freely accessible. However, starting from version 6.0.0 of PSG, users will need an API key (token) to utilize the GUI features of ASADT. While this change might be disappointing, you can follow the recommended steps to install an earlier version and prevent being prompted for this information. If you wish not to pay for this service, please utilize the version identified in the requirements.txt file, and remove or rollback any updated version previously installed.

Project Description

ASADT (Assistive Search And Discovery Tool) is a powerful Python script designed to enhance the usability and functionality of the Kali Linux and Parrot Linux Compatible operating systems. It provides a comprehensive toolkit and graphical user interface (GUI) that simplifies the execution of various programs and scripts.

With ASADT, you no longer need to manually type lengthy commands or remember complex argument structures. The script streamlines the process of interacting with tools and scripts, enabling you to focus on analyzing and attacking your target without getting bogged down by technicalities.

Key features of ASADT:

• NEW: ToolTip Help View: ASADT offers a tooltip view for each input value, viewable by hovering over any text field! Try it out now in release version 1.0.6!

• NEW: Command Generation: ASADT now generates commands based on user input, allowing for a more advanced execution ability! (NOTE: This is a beta feature and may not properly operate. Report any issues here)

• User-Friendly Toolkit: ASADT incorporates a GUI frontend, powered by PySimpleGUI, that guides users through the process of configuring and executing programs and scripts. This intuitive interface eliminates the need for extensive command-line knowledge and enhances overall user experience.

• Flexible Configuration: The script allows users to customize and configure various parameters for each program or script. By interacting with the GUI, users can easily input the required data and tailor the execution according to their specific needs.

• Module-Based Structure: ASADT adopts a modular structure, organizing tools and scripts into different modules. This categorization enhances the organization and accessibility of the available utilities, making it easier for users to find the tools they need.

• Automatic Updates: ASADT includes a built-in update checking mechanism. By downloading the newest ScriptInfo configuration, the script ensures that users always have the latest versions of tools and scripts, providing access to the most up-to-date features and bug fixes.

ASADT is an invaluable asset for both beginner and experienced security professionals. Its user-friendly approach empowers users to leverage the full potential of the tools and scripts within Kali Linux and Parrot Linux, facilitating efficient and effective security assessments.

Requirements

1. Package Installation: Use pip to install the required packages listed in requirements.txt. Run the following command:

sudo pip install -r requirements.txt

Notice: ASADT MK 3 requires APT packages generally found in KaliOS & ParrotOS
If changing your operating system is not an option, We suggest you consider use
of KaliOS's Docker Lightweight Images.

Required APT Packages (As Of Version 2.1.0):
apt, python3, python3-pip, nmap, nikto, msfpc

Usage

To utilize ASADT, please refer to the picture below.

Each command has a help view for input requirements: Ex: sudo ./asadt.py run --help

The command above will display the help menu, which provides a comprehensive list of available options and functionalities. Refer to the help menu for detailed instructions on using ASADT effectively.

Please Note: It is recommended to run ASADT with administrative privileges (sudo) to ensure proper execution of certain tools and scripts. However, it is possible to prevent ASADT from requesting these permissions. If you would like to utilize this option, it is available by executing asadt.py without the sudo flag and following the on-screen instructions. It is worth mentioning that Python modules that are installed using the pip install -r requirements.txt are place in the local account of execution. It is suggested to install these packages both as a root user and as a local user if you chose to utilize the sudo disengage option, due to changes in site-packages area when executing as 2 different parties.

For any issues, feedback, or feature requests, please refer to the GitHub Discussions Channel or the GitHub Issues Channel and create an issue. We welcome contributions and collaboration from the open-source community to enhance ASADT and make it even more robust and user-friendly.