monkey/chaos_monkey
Daniel Goldberg 875b7cb3a1 Merge pull request #58 from guardicore/bugfix/various-island-fixes
Bugfix/various island fixes
2017-10-15 10:54:03 +03:00
..
exploit Merge pull request #57 from guardicore/bugfix/fix-various-exploit-bugs 2017-10-09 10:43:51 +03:00
model minor fix in dropper 2017-08-28 10:41:11 +03:00
monkey_utils/sambacry_monkey_runner Fix SambaCry not working for non-root user 2017-10-02 17:11:51 +03:00
network Fix CR 2017-10-08 19:23:34 +03:00
system_info Fix mimikatz lowercase hostname comparison 2017-10-02 12:14:31 +03:00
test Don't crash when receiving unknown configuration variables 2016-09-27 23:56:26 +03:00
transport Fix inconsistent return value in send_head 2017-10-02 12:40:53 +03:00
build_linux.sh pyinstaller run clean 2015-12-31 09:57:29 +02:00
build_windows.bat remove fully qualified path 2017-10-02 12:40:53 +03:00
config.py Merge remote-tracking branch 'origin/develop' into bugfix/various-island-fixes 2017-10-09 10:53:32 +03:00
control.py PEP8+python exceptions 2017-10-02 12:40:53 +03:00
dropper.py PEP8 + Python exception 2017-10-02 12:40:53 +03:00
example.conf Merge remote-tracking branch 'origin/develop' into bugfix/various-island-fixes 2017-10-09 10:53:32 +03:00
main.py Expand config env variables on demand 2017-09-27 11:24:42 +03:00
monkey-linux.spec fix linux paths on spec 2017-08-31 17:56:35 +03:00
monkey.ico first commit 2015-08-30 10:27:35 +03:00
monkey.py Fix CR 2017-10-08 19:23:34 +03:00
monkey.spec sambacry: Add support for using both architectures 2017-08-30 10:16:54 +03:00
monkeyfs.py Added grequests to hidden imports. 2016-09-04 13:45:49 +03:00
readme.txt Updated compilation instructions 2017-10-08 16:13:42 +03:00
requirements.txt Require lower version of psutil for Windows 2003/XP and under 2017-10-09 14:39:11 +03:00
system_singleton.py PEP8 + Python exceptions 2017-10-02 12:40:53 +03:00
tunnel.py PEP8 + new exception format. 2017-10-02 12:40:53 +03:00

readme.txt

How to build a monkey binary from scratch.

The monkey is composed of three seperate parts.
* The Infection Monkey itself - PyInstaller compressed python archives
* Sambacry binaries - Two linux binaries, 32/64 bit.
* Mimikatz binaries - Two windows binaries, 32/64 bit.

--- Windows ---

1. Install python 2.7. Preferably you should use ActiveState Python which includes pywin32 built in. 
    You must use an up to date version, at least version 2.7.10
    http://www.activestate.com/activepython/downloads
    https://www.python.org/downloads/release/python-2712/
    If not using ActiveState, install pywin32, minimum build 219
    http://sourceforge.net/projects/pywin32/files/pywin32
3. a. install VCForPython27.msi
    https://aka.ms/vcpython27
   b. if not installed, install Microsoft Visual C++ 2010 SP1 Redistributable Package
    32bit: http://www.microsoft.com/en-us/download/details.aspx?id=8328
    64bit: http://www.microsoft.com/en-us/download/details.aspx?id=13523
4. Download the dependent python packages using 
    pip install -r requirements.txt
5. Download and extract UPX binary to [source-path]\monkey\chaos_monkey\bin\upx.exe:
    https://github.com/upx/upx/releases/download/v3.94/upx394w.zip
6. To build the final exe:
    1 cd [code location]/chaos_monkey
    build_windows.bat 
    output is in dist\monkey.exe

--- Linux ---

Tested on Ubuntu 16.04 and 17.04.

1. Run:
    sudo apt-get update
    sudo apt-get install python-pip python-dev libffi-dev upx libssl-dev libc++1
    Install the python packages listed in requirements.txt.
        Using pip install -r requirements.txt
    sudo apt-get install winbind dnet-common
2. Put source code in Code/monkey/chaos_monkey
3. To build, run in terminal:
    cd [code location]/chaos_monkey
    chmod +x build_linux.sh
    ./build_linux.sh
   output is in dist/monkey

-- Sambacry --

Sambacry requires two standalone binaries to execute remotely.
Compiling them requires gcc 
cd [code location]/chaos_monkey/monkey_utils/sambacry_monkey_runner
./build.sh

-- Mimikatz --

Mimikatz is required for the Monkey to be able to steal credentials on Windows. It's possible to either compile from sources (requires Visual Studio 2013 and up) or download the binaries from 
https://github.com/guardicore/mimikatz/releases/tag/1.0.0
Download both 32 and 64 bit DLLs and place them under [code location]\chaos_monkey\bin