top of page


This script serves as the central hub for managing tasks, data, and interactions within the S.S.A project.It provides a user-friendly command-line interface and a range of functionalities to streamline your workflow.

This script showcases the integration of various Python libraries to perform database operations, user interaction, and more. Let's break down the key features and how they contribute to the script's overall functionality.

The script begins with the essential imports, setting up a foundation with libraries such as sys, sqlite3, subprocess, and hashlib. It defines a DATABASE_FILE constant that points to the SQLite database file, ensuring all database operations are centralized.

ASCII Art and User Experience

Upon execution, the script displays ASCII art to enhance the user experience. It's not just about functionality; it's about engaging users right from the start.

Package Management

Before diving into the core logic, the script checks for necessary packages and installs them if missing. This proactive approach ensures that users won't run into import errors.

Database Connectivity

The connect_db function is a cornerstone of the script, establishing a connection to the SQLite database. It's a best practice to isolate database connection logic, making it reusable and maintainable.

Database Schema Setup

The create_tables function is responsible for setting up the database schema, creating tables if they don't already exist. This function lays the groundwork for storing information about companies, agents, domains, and more.

Security Considerations

Security is not an afterthought in this script. The hash_password function incorporates a salt, combined with SHA-256 hashing, to securely store passwords.

User Interaction

The script uses the questionary library to interact with users through prompts, gathering inputs in a friendly manner. Whether it's for registering an admin or adding a new target company, questionary makes CLI interactions smooth.

CRUD Operations

The script provides a full suite of CRUD (Create, Read, Update, Delete) operations for managing target companies, agents, and other entities. It's a great example of how Python can be used for practical database management tasks.

Command-Line Interface (CLI)

The main menu and sub-menus leverage a while loop to present users with options, creating an intuitive CLI. Users can navigate through different management options and perform a variety of tasks without leaving the terminal.

Reporting and Data Visualization

While the script primarily operates in the terminal, it includes a function to export reports. This could be extended to integrate with data visualization tools like matplotlib for richer reporting.

Final Thoughts

This script is more than just lines of code; it's a fully-fledged tool for database management with a focus on user experience and security. It's a testament to Python's versatility and the power of its extensive library ecosystem.

## Usage

Once you run the `` script, it will display the main menu with the following options:

Note: This Script/Module is already included in the latest Version of S.S.A

Main Menu

This is the first level of interaction, where the user can navigate to various functionalities of the control panel.

(aes) T-CIPHER Message Menu: A specialized submenu for managing AES encrypted


1. Target Companies: Opens a submenu to manage companies, such as adding, editing, viewing, or deleting company records.

2. Target Agents: Opens a submenu to manage agents with options similar to managing companies.

3. Vulnerable Domains: A submenu to manage domain records, specifically those that are vulnerable, with options to add, edit, view, or delete.

4. Communist Agents: A submenu dedicated to managing records of communist agents.

5. Manage Deployed Shells: A submenu for managing shells (which could refer to s software shells or other entities depending on the application context).

6. Manage Interesting Files: This submenu allows the management of files that have been marked as interesting, presumably for further review or action.

7. Manage Notes: A section for managing textual notes within the application.

8. Export Report: An option to export gathered data or reports into a text file format.

0. Exit: This option exits the main menu and the application.


Submenus provide specific actions related to the selected category from the main menu. For example:

Target Companies Menu

1. Add Target Company: Add a new company record to the database.

2. Edit Target Company: Modify details of an existing company record.

3. Delete Target Company: Remove a company record from the database.

4. View All Target Companies: Display a list of all company records.

0. Back to Main Menu: Return to the main menu.

Target Agents Menu

1. Add Target Agent: Add a new agent record.

2. Edit Target Agent: Change details of an existing agent record.

3. Delete Target Agent: Remove an agent record.

4. View All Target Agents: List all agent records.

0. Back to Main Menu: Go back to the main menu.

Vulnerable Domains Menu

1. Add Vulnerable Domain: Insert a new domain record that is vulnerable.

2. Edit Vulnerable Domain: Update details for a vulnerable domain.

3. Delete Vulnerable Domain: Delete a vulnerable domain record.

4. View All Vulnerable Domains: List all records of vulnerable domains.

0. Back to Main Menu: Return to the main menu.

The pattern continues with the other menus like Communist Agents Menu, Shells Menu, Interesting Files Menu, and Notes Menu which all have options to add, edit, view, and delete their respective records.

Export Report Menu

1. Export to Text File: Save the data into a text file.

0. Back to Main Menu: Return to the main menu.

AES Message Management

1. Add AES Message: Add a new AES encrypted message.

2. View AES Messages: List all AES messages.

3. Back to Main Menu: Go back to the main menu.

In each submenu, the user is prompted to provide necessary information or make selections to perform the desired action.

Project Gallery

bottom of page