An open API service indexing awesome lists of open source software.

https://github.com/tory1103/cibertoolkit

Automated pentesting framework build in python
https://github.com/tory1103/cibertoolkit

docker framework pentesting python-penetration-testing python-pentesting python3

Last synced: 7 months ago
JSON representation

Automated pentesting framework build in python

Awesome Lists containing this project

README

          



logo

Automated pentesting framework

![GitHub status](https://img.shields.io/badge/status-active-brightgreen)
![GitHub issues](https://img.shields.io/github/issues/tory1103/cibertoolkit?color=yellow)
![GitHub pull requests](https://img.shields.io/github/issues-pr/tory1103/cibertoolkit?color=purple)
![GitHub license](https://img.shields.io/github/license/tory1103/cibertoolkit?color=blue)
![GitHub last commit](https://img.shields.io/github/last-commit/tory1103/cibertoolkit?color=red)
![Python version](https://img.shields.io/badge/Python-3.8+-orange?logo=python")
![Version](https://img.shields.io/badge/version-Alpha-cyan?logo=python")

---

**Ciber-Toolkit** is a framework designed to automate the process of downloading and installing different penetration testing tools . It's based in [ToolKit Framework](https://github.com/AdrMXR/KitHack).
It just support linux for the moment, it is considered that it will be developed in the future for windows, for the moment use Docker alternative.

## 📝 Table of Contents
- [About](#about)
- [Getting Started](#getting_started)
- [Usage](#usage)
- [Built Using](#built_using)
- [TODO](./TODO.md)
- [Contributing](./CONTRIBUTING.md)
- [Authors](#authors)
- [Acknowledgments](#acknowledgement)
- [Useful Links](#links)

## 🧐 About
Ciber-Toolkit is an improved version of [ToolKit Framework](https://github.com/AdrMXR/KitHack). Most important differences are:
- Tested tools - Download and installation is completed on every OS
- Modular tools - The download and install script is not needed to be modified, just .json file
- Docker support - Docker image alternatives

## 🏁 Getting Started

### Prerequisites
```
- Python3 or higher
- Linux OS (Tested on Kali)
- Sudo access
- Windows isn't supported yet
```

```requirements.txt
oh-my-pickledb==0.4
termcolor==1.1.0
```

### Installing
```bash
# Installing using github
$ git clone https://github.com/tory1103/cibertoolkit
$ cd cibertoolkit
$ sudo bash install.sh -y # For automated installation, remove 'y' parameter if wanted

# Installing using docker
$ docker pull adriantoral/cibertoolkit
$ docker run -it --name toolkit adriantoral/cibertoolkit

# If port forwarding is needed, use this one instead
$ docker run -it --name toolkit -p : adriantoral/cibertoolkit

```

## 🎈 Usage

### First steps
```bash
# Once installed, if shortcut created, run:
$ sudo toolkit

# Else, run:
$ cd src/ciber-toolkit && sudo python3 toolkit.py

# If you want to build docker image, run:
$ docker build -t cibertoolkit .
$ docker run -it --name toolkit cibertoolkit

# Or download it from docker hub, run:
$ docker pull adriantoral/cibertoolkit
$ docker run -it --name toolkit adriantoral/cibertoolkit
```

### Introducing to the power of the Terminal
Our goal is to make a fully functional pentesting environment, to achieve that, we need some powerful tools, like a Terminal
It's not perfect yet, but we're trying.

Some things it can do for the moment are:
```
- You can use all bash commands (an status will be returned). Some commands : bash, pwd, echo, apt, ...
- Use installed tools shortcuts : tk-{lowercase tool name}
- Installation arguments : When installing a tool, you can use some arguments such :
- y || yes (for automatic run)
- More in a future...
- Name instead of index for tool selection
- Clear terminal : Typing clear, clean or will clean terminall interface
```

## ⛏️ Built Using
- Python3.8
- Json
- Bash (sh)
- Docker

## ✍️ Authors
- [@tory1103](https://github.com/tory1103) - Idea, Concept & Initial work

See also the list of [contributors](https://github.com/tory1103/cibertoolkit/contributors) who participated in this project.





## 🎉 Acknowledgements
- [json](https://www.json.org/json-en.html)
- [bash](https://es.wikipedia.org/wiki/Bash)
- [docker](https://www.docker.com/)

## ✨ Useful links
- [Docker Hub](https://hub.docker.com/repository/docker/adriantoral/cibertoolkit)