diff --git a/monkey/infection_monkey/readme.md b/monkey/infection_monkey/readme.md index cadf1e5d8..6db622eeb 100644 --- a/monkey/infection_monkey/readme.md +++ b/monkey/infection_monkey/readme.md @@ -12,25 +12,27 @@ The monkey is composed of three separate parts. ## Windows -1. Install python 3.7.4 +1. Install python 3.7.4 and choose **ADD to PATH** option when installing. + Download and install from: -2. Add python directories to PATH environment variable - 1. Run the following command on a cmd console (Replace C:\Python37 with your python directory if it's different) + + In case you still need to add python directories to path: + - Run the following command on a cmd console (Replace C:\Python37 with your python directory if it's different) `setx /M PATH "%PATH%;C:\Python37;C:\Python37\Scripts` - 2. Close the console, make sure you execute all commands in a new cmd console from now on. -3. Install further dependencies - 1. if not installed, install Microsoft Visual C++ 2017 SP1 Redistributable Package - 32bit: - 64bit: -4. Download the dependent python packages using - pip install -r requirements_windows.txt -5. Download and extract UPX binary to [source-path]\monkey\infection_monkey\bin\upx.exe: + - Close the console, make sure you execute all commands in a new cmd console from now on. +2. Install further dependencies + - if not installed, install Microsoft Visual C++ 2017 SP1 Redistributable Package + - 32bit: + - 64bit: +3. Download the dependent python packages using + `pip install -r requirements_windows.txt` +4. Download and extract UPX binary to monkey\infection_monkey\bin\upx.exe: -6. Build/Download Sambacry and Mimikatz binaries +5. Build/Download Sambacry and Mimikatz binaries - Build/Download according to sections at the end of this readme. - - Place the binaries under [code location]\infection_monkey\bin -7. To build the final exe: - - `cd [code location]/infection_monkey` + - Place the binaries under monkey\infection_monkey\bin +6. To build the final exe: + - `cd monkey\infection_monkey` - `build_windows.bat` - `output is placed under dist\monkey.exe` @@ -45,8 +47,7 @@ Tested on Ubuntu 16.04. 1. Install dependencies by running: - `sudo apt install python3-pip` - `python3.7 -m pip install pip` - - `sudo apt-get install python3.7-dev` - - `sudo apt-get install libffi-dev upx libssl-dev libc++1` + - `sudo apt-get install python3.7-dev libffi-dev upx libssl-dev libc++1` 2. Install the python packages listed in requirements.txt using pip - `cd [code location]/infection_monkey` @@ -61,10 +62,11 @@ Tested on Ubuntu 16.04. - Place the binaries under [code location]\infection_monkey\bin, under the names 'traceroute32', 'traceroute64' 5. To build, run in terminal: - `cd [code location]/infection_monkey` - `chmod +x build_linux.sh` - `./build_linux.sh` - `output is placed under dist/monkey` + - `cd [code location]/infection_monkey` + - `chmod +x build_linux.sh` + - `./build_linux.sh` + + output is placed under dist/monkey ### Sambacry diff --git a/monkey/monkey_island/readme.md b/monkey/monkey_island/readme.md index 7bbc53166..b333dab94 100644 --- a/monkey/monkey_island/readme.md +++ b/monkey/monkey_island/readme.md @@ -11,16 +11,12 @@ 2. Create folder "bin" under monkey_island 3. Place portable version of Python 3.7.4 - Download and install from: - - Install virtualenv using "python -m pip install virtualenv" - - Create a virtualenv using "python -m virtualenv --always-copy \Python37" Where is the path to the bin folder created on step 1. - - Run "python -m virtualenv --relocatable \Python37" - - Install the required python libraries using "\Python37\Scripts\python -m pip install -r monkey_island\requirements.txt" - - Copy DLLs from installation path (Usually C:\Python27\DLLs) to \Python37\DLLs - - (Optional) You may uninstall Python3.7 if you like. +4. Install Island's requirements + - `python -m pip install -r monkey_island\requirements.txt` 4. Setup mongodb (Use one of the following two options): - Place portable version of mongodb 1. Download from: - 2. Extract contents from bin folder to monkey_island\bin\mongodb. + 2. Extract contents of bin folder to monkey_island\bin\mongodb. 3. Create monkey_island\db folder. OR @@ -29,12 +25,12 @@ 5. Place portable version of OpenSSL - Download from: - - Extract content from bin folder to monkey_island\bin\openssl + - Extract contents to monkey_island\bin\openssl 6. Download and install Microsoft Visual C++ redistributable for Visual Studio 2017 - Download and install from: 7. Generate SSL Certificate - - run create_certificate.bat when your current working directory is monkey_island -8. Create the monkey_island\cc\binaries folder and put Infection Monkey binaries inside (binaries can be found in releases on github) + - run `./windows/create_certificate.bat` when your current working directory is monkey_island +8. Put Infection Monkey binaries inside monkey_island/cc/binaries (binaries can be found in releases on github or build from source) monkey-linux-64 - monkey binary for linux 64bit monkey-linux-32 - monkey binary for linux 32bit monkey-windows-32.exe - monkey binary for windows 32bit @@ -48,7 +44,7 @@ #### How to run -1. When your current working directory is monkey_island, run monkey_island\windows\run_server.bat +1. When your current working directory is monkey_island, run monkey_island\windows\run_server_py.bat ### On Linux @@ -73,7 +69,10 @@ monkey-linux-64 - monkey binary for linux 64bit monkey-linux-32 - monkey binary for linux 32bit monkey-windows-32.exe - monkey binary for windows 32bit - monkey-windows-64.exe - monkey binary for windows 64bi + monkey-windows-64.exe - monkey binary for windows 64bit + Also, if you're going to run monkeys on local machine execute: + - `chmod 755 ./monkey_island/cc/binaries/monkey-linux-64` + - `chmod 755 ./monkey_island/cc/binaries/monkey-linux-32` 6. Setup MongoDB (Use one of the two following options): - Download MongoDB and extract it to /var/monkey_island/bin/mongodb: diff --git a/monkey/monkey_island/windows/run_cc.bat b/monkey/monkey_island/windows/run_cc.bat index c1a2fd88e..c87f04cec 100644 --- a/monkey/monkey_island/windows/run_cc.bat +++ b/monkey/monkey_island/windows/run_cc.bat @@ -1,5 +1,5 @@ REM - Runs Monkey Island Server using python - @title C^&C Server @pushd .. -@monkey_island\bin\Python27\Scripts\python monkey_island.py -@popd \ No newline at end of file +@python monkey_island.py +@popd