SploitKit

Make a Metasploit-like console.

This toolkit is aimed to easilly build framework consoles in a Metasploit-like style. It provides a comprehensive interface to define CLI commands, modules and models for its storage database.

pip install sploitkit

Usage

From this point, main.py has the following code:

#!/usr/bin/python3
from sploitkit import FrameworkConsole


class MySploitConsole(FrameworkConsole):
    #TODO: set your console attributes
    pass


if __name__ == '__main__':
    MySploitConsole(
        "MySploit",
        #TODO: configure your console settings
    ).start()

And you can run it from the terminal:

Features

Sploitkit provides a base set of entities (consoles, commands, modules, models).

Multiple base console levels already exist (for detailed descriptions, see the console section):

FrameworkConsole: the root console, started through main.py
ProjectConsole: the project console, for limiting the workspace to a single project, invoked through the select [project] command
ModuleConsole: the module console, started when a module is invoked through the use [module] command

This framework provides more than 20 base commands, distributed in sets of functionalities (for detailed descriptions, see the command section):

general: commands for every level (e.g. help, show, set)
module: base module-level commands (e.g. use, run, show)
project: base project-level commands (e.g. select, load, archive)
recording: recording commands, for managing .rc files (record, replay)
root: base root-level commands (help)
utils: utility commands (shell, pydbg, memory)

It also holds some base models for its storage:

users: for user-related data (User, Email, Password)
systems: for system-related data (Host, Port, Service)
organization: for organization-related data (Organization, Unit, Employee)
notes: for linking notes to users, hosts or organizations

No module is provided with the framework as it is case-specific.

Customization

Sploitkit defines multiple types of entities for various purposes. The following entities can be subclassed:

Console: a new console for a new level of interaction (e.g. ProjectConsole) ; the "root" level is owned by the FrameworkConsole, Console shall be used to create new subconsoles, to be called by commands from the root console (see an example here for the module-level commands with ModuleConsole(Console) and Use(Command))
Command: a new command associated with any or defined consoles using the level attribute
Module: a new module associated to a console
Model, BaseModel, StoreExtension: respectively for new models, their association tables and store additional methods (e.g. User(Model), Email(Model), UserEmail(BaseModel), UsersStorage(StoreExtension))

Metadata

Release files for sploitkit 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sploitkit 0.6.0
File	Size	Uploaded
sploitkit-0.6.0.tar.gz	1.8 MB	Jul 7, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for sploitkit 0.6.0
File	Interpreter	ABI	Platform	Reset
sploitkit-0.6.0-py3-none-any.whl 85.0 kB Jul 7, 2024	Python 3	none	any	Details

Total release size: 1.9 MB

Release files / sploitkit-0.6.0.tar.gz

Download URL	sploitkit-0.6.0.tar.gz
Size	1.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`c62a3e95e2c3c2e4af41e9f3ef71e87418c41498526144f27dc95dd491bbb098`
BLAKE2b-256 checksum How to use checksums	`2e4ca982361f45d3979afcf3a9332bce53817b12f913c5ea0fd924710bdbc731`
Upload date	Jul 7, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.12.4`

Release files / sploitkit-0.6.0-py3-none-any.whl

Download URL	sploitkit-0.6.0-py3-none-any.whl
Size	85.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7b4a7ebc8e654bdfe292b080311e48dc94efc85b83cb2e8324b2f45fe70ed327`
BLAKE2b-256 checksum How to use checksums	`dc4f4d40ecb24b56b2becfc5d079ced0fb8206ec9cfa23f9a63fc417b9590825`
Upload date	Jul 7, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.1.0 CPython/3.12.4`