andrew.rioux/sparse
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

docs: added better documentation

Browse Source
This commit is contained in:
Andrew Rioux 2023-04-28 18:25:40 -04:00
parent 82dd4acd6b
commit 9f974a81d6
2 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.org
View File

@ -7,3 +7,5 @@ Developed using libpcap to enable evading local firewalls and with an eye toward
* Development * Development
To develop or compile this project, open it in GitHub Codespaces or using Visual Studio Code's Dev Container extension (requires Docker to be installed) and run ~git submodule update~ To develop or compile this project, open it in GitHub Codespaces or using Visual Studio Code's Dev Container extension (requires Docker to be installed) and run ~git submodule update~
* [[./examples/bind-shell/README.org][Example bind shell implementation]]

13
examples/bind-shell/README.org Normal file
View File

@ -0,0 +1,13 @@
#+TITLE: Example bind shell proof of concept
This bind shell works through local host firewalls on Linux systems using UDP to receive messages, verify them against a public key, run the commands specified, and return the results and display it over the network.
* Setup
** libpcap
Follow the directions in the main README in order to pull in the libpcap dependency
** Generate keys
In order to build the example backdoor/client, generate public and private keys by going into ~/workspaces/sparse/examples/bind-shell/key-generator~ and run ~cargo run~
** Build the code
Once the previous steps are completed, open two shells. In one, run ~docker-compose up examples_bindshell_target~, and in the other run ~docker-compose run examples_bindshell_client~. It will be possible to type in commands to examples_bindshell_client and run them in the target container