pendora-box/README.md

53 lines
1.4 KiB
Markdown

# Pendora Box
This too has several functions:
* Keep your pentesting scripts, binaries hosted on Github up-to-date.
* Listen on HTTP or SMB to easily share your files to the victims
## To-Do
* Add chisel x64
* Integrate msfvenom
* Add Webshells sync
* Ability to add comments or description
* Prettier code
* Adding more services to listen to ?
## Pre-requisites
* requests python module
* rpmfile python module
* impacket smbserver.py must be in PATH
## Usage
[Create a Github personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token), and create the file `credz.json`:
```json
{
"username": "DwightSchrute",
"token": "ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
```
```
user@wow$ python pendora-box.py -h
usage: pendora-box.py [-h] [-u]
Sync your files and starts a listener on HTTP, SMB or SMB2.
options:
-h, --help show this help message and exit
-u, --update update your files (described in config.json)
```
## Adding a file to track
Simply add the informations to [config.json](./config.json), for a release set "local_version" to a random value and run the script.
The file is gonna be automatically downloaded.
## Share a file temporarly
You can add a file you wish to share once in `files/tmp`.
Every time you start the script, you will be asked if you want to clear the folder (if not empty).