diff --git a/README.md b/README.md index 32d530e74..f59de5094 100644 --- a/README.md +++ b/README.md @@ -6,137 +6,52 @@ Infection Monkey Welcome to the Infection Monkey! -The Infection Monkey is an open source security tool for testing a data center's resiliency to perimeter breaches and internal server infection. The Monkey uses various methods to self propagate across a data center and reports success to a centralized C&C server. To read more about the Monkey, visit https://www.guardicore.com/infectionmonkey/ +The Infection Monkey is an open source security tool for testing a data center's resiliency to perimeter breaches and internal server infection. The Monkey uses various methods to self propagate across a data center and reports success to a centralized Command and Control(C&C) server. -### http://www.guardicore.com/the-infected-chaos-monkey/ +The Infection Monkey is comprised of two parts: +* Chaos Monkey - A tool which infects other machines and propagates to them +* Monkey Island - A C&C server with a dedicated UI to visualize the Chaos Monkey's progress inside the data center -Features include: +To read more about the Monkey, visit http://infectionmonkey.com + +Main Features +--------------- + +The Infection Monkey uses the following techniques and exploits to propagate to other machines. * Multiple propagation techniques: * Predefined passwords - * Common exploits + * Common logical exploits + * Password stealing using mimikatz * Multiple exploit methods: * SSH * SMB * RDP * WMI * Shellshock -* A C&C server with a dedicated UI to visualize the Monkey's progress inside the data center + * Conficker + * SambaCry + * Elastic Search (CVE-2015-1427) + Getting Started --------------- -The Infection Monkey is comprised of two parts: the Monkey and the C&C server. -The monkey is the tool which infects other machines and propagates to them, while the C&C server collects all Monkey reports and displays them to the user. - ### Requirements The C&C Server has been tested on Ubuntu 14.04,15.04 and 16.04. -The Monkey itself has been tested on Windows XP, 7, 8.1 and 10. The Linux build has been tested on Ubuntu server 14.04 and 15.10. +The Monkey itself has been tested on Windows XP, 7, 8.1 and 10. The Linux build has been tested on Ubuntu server (multiple versions). ### Installation +For off-the-shelf use, download a Debian package from our website and follow the guide [written in our blog](https://www.guardicore.com/2016/07/infection-monkey-loose-2/). Warning! The Debian package will uninstall the python library 'bson' because of an issue with pymongo. You can reinstall it later, but monkey island will probably not work. -For off-the-shelf use, download our Debian package from our website and follow the guide [written in our blog](https://www.guardicore.com/2016/07/infection-monkey-loose-2/). - To manually set up and the C&C server follow the instructions on [Monkey Island readme](monkey_island/readme.txt). If you wish to compile the binaries yourself, follow the instructions under Building the Monkey from Source. - -### Initial configuration. -Whether you're downloading or building the Monkey from source, the Infection Monkey is comprised of 4 executable files for different platforms plus a default configuration file. +To manually set up and the C&C server follow the instructions on [Monkey Island readme](monkey_island/readme.txt). If you wish to compile the binaries yourself, follow the instructions under Building the Monkey from Source. -Monkey configuration is stored in two places: -1. By default, the Monkey uses a local configuration file (usually, config.bin). This configuration file must include the address of the Monkey's C&C server. -2. After successfully connecting to the C&C server, the monkey downloads a new configuration from the server and discards the local configuration. It is possible to change the default configuration from the C&C server's UI. +### Start Infecting -In both cases the command server hostname should be modified to point to your local instance of the Monkey Island (note that this doesn't require connectivity right off the bat). In addition, to improve the Monkey's chances of spreading, you can pre-seed it with credentials and usernames commonly used. - -Both configuration options use a JSON format for specifying options; see "Options" below for details. - -### Running the C&C Server - -To run the C&C Server, install our infected Monkey debian package on a specific server. The initial infected machine doesn't require a direct link to this server. - -### Unleashing the Monkey - -Once configured, run the monkey using ```./monkey-linux-64 m0nk3y -c config.bin -s 41.50.73.31:5000``` (Windows is identical). This can be done at multiple points in the network simultaneously. - -Command line options include: -* `-c`, `--config`: set configuration file. JSON file with configuration values, will override compiled configuration. -* `-p`, `--parent`: set monkey’s parent uuid, allows better recognition of exploited monkeys in c&c -* `-t`, `--tunnel`: ip:port, set default tunnel for Monkey when connecting to c&c. -* `-d`, `--depth` : sets the Monkey's current operation depth. - - -How the Monkey works ---------------------- - -1. Wakeup connection to c&c, sends basic info of the current machine and the configuration the monkey uses to the c&c. - 1. First try direct connection to c&c. - 2. If direct connection fails, try connection through a tunnel, a tunnel is found according to specified parameter (the default tunnel) or by sending a multicast query and waiting for another monkey to answer. - 3. If no connection can be made to c&c, continue without it. -2. If a firewall app is running on the machine (supports Windows Firewall for Win XP and Windows Advanced Firewall for Win 7+), try to add a rule to allow all our traffic. -3. Startup of tunnel for other Monkeys (if connection to c&c works). - 1. Firewall is checked to allow listening sockets (if we failed to add a rule to Windows firewall for example, the tunnel will not be created) - 2. Will answer multicast requests from other Monkeys in search of a tunnel. -4. Running exploitation sessions, will run x sessions according to configuration: - 1. Connect to c&c and get the latest configuration - 2. Scan ip ranges according to configuration. - 3. Try fingerprinting each host that answers, using the classes defined in the configuration (SMBFinger, SSHFinger, etc) - 4. Try exploitation on each host found, for each exploit class in configuration: - 1. check exploit class supports target host (can be disabled by configuration) - 2. each exploitation class will use the data acquired in fingerprinting, or during the exploit, to find the suitable Monkey executable for the host from the c&c. - 1. If c&c connection fails, and the source monkey’s executable is suitable, we use it. - 2. If a suitable executable isn’t found, exploitation will fail. - 3. Executables are cached in memory. - 5. will skip hosts that are already exploited in next run - 6. will skip hosts that failed during exploitation in next run (can be disabled by configuration) -5. Close tunnel before exiting -Wait for monkeys using the tunnel to unregister for it -Cleanup -Remove firewall rules if added - -Configuration Options ---------------------- - -Key | Type | Description | Possible Values ---- | ---- | ----------- | --------------- -alive | bool | sets whether or not the monkey is alive. if false will stop scanning and exploiting -command_servers | array | addresses of c&c servers to try to connect | example: ["russian-mail-brides.com:5000"] -singleton_mutex_name | string | string of the mutex name for single instance | example: {2384ec59-0df8-4ab9-918c-843740924a28} -self_delete_in_cleanup | bool | sets whether or not to self delete the monkey executable when stopped -use_file_logging | bool | sets whether or not to use a log file -monkey_log_path_[windows/linux] | string | file path for monkey logger. -kill_file_path_[windows/linux] | string | file path that the Monkey checks to prevent running -timeout_between_iterations | int | how long to wait between scan iterations -max_iterations | int | how many scan iterations to perform on each run -internet_services | array | addresses of internet servers to ping and check if the monkey has internet acccess -victims_max_find | int | how many victims to look for in a single scan iteration -victims_max_exploit | int | how many victims to exploit before stopping -retry_failed_explotation | bool | sets whether or not to retry failed hosts on next scan -local_network_scan | bool | sets whether to auto detect and scan local subnets -range_class | class name | sets which ip ranges class is used to construct the list of ips to scan | `FixedRange` - scan list is a static ips list, `RelativeRange` - scan list will be constructed according to ip address of the machine and size of the scan, `ClassCRange` - will scan the entire class c the machine is in. -range_fixed | tuple of strings | list of ips to scan -RelativeRange range_size | int | number of hosts to scan in relative range -scanner_class | class name | sets which scan class to use when scanning for hosts to exploit | `TCPScanner` - searches for hosts according to open tcp ports, `PingScanner` - searches for hosts according to ping scan -finger_classes | tuple of class names | sets which fingerprinting classes to use | in the list: `SMBFinger` - get host os info by checking smb info, `SSHFinger` - get host os info by checking ssh banner, `PingScanner` - get host os type by checking ping ttl. For example: `(SMBFinger, SSHFinger, PingScanner)` -exploiter_classes | tuple of class names | | `SmbExploiter` - exploit using smb connection, `WmiExploiter` - exploit using wmi connection, `RdpExploiter` - exploit using rdp connection, `Ms08_067_Exploiter` - exploit using ms08_067 smb exploit, `SSHExploiter` - exploit using ssh connection -tcp_target_ports | list of int | which ports to scan using TCPScanner -tcp_scan_timeout | int | timeout for tcp connection in tcp scan (in milliseconds) -tcp_scan_interval | int | time to wait between ports in the tcp scan (in milliseconds) -tcp_scan_get_banner | bool | sets whether or not to read a banner from the tcp ports when scanning -ping_scan_timeout | int | timeout for the ping command (in milliseconds) utilised by PingScanner -skip_exploit_if_file_exist | bool | sets whether or not to abort exploit if the monkey already exists in target, used by SmbExploiter -psexec_user | string | user to use for connection, utilised by SmbExploiter/WmiExploiter/RdpExploiter -psexec_passwords | list of strings | list of passwords to use when trying to exploit -rdp_use_vbs_download | bool | sets whether to use vbs payload for rdp exploitation in RdpExploiter. If false, bits payload is used (will fail if bitsadmin.exe doesn’t exist) -ms08_067_exploit_attempt | int | number of times to try and exploit using ms08_067 exploit -ms08_067_remote_user_add | string | user to add to target when using ms08_067 exploit -ms08_067_remote_user_pass | string | password of the user the exploit will add -ssh_user | string | user to use for ssh connection, used by SSHExploiter -ssh_passwords | list of strings | list of passwords to use when trying to exploit using SSHExploiter -dropper_set_date | bool | whether or not to change the monkey file date to match other files -dropper_target_path_[windows/linux] | string | path for the dropper -serialize_config | bool | sets whether or not to locally save the running configuration after finishing +After installing the Infection Monkey on a server of your choice, just browse https://your-server-ip:5000 and follow the instructions to start infecting. Building the Monkey from source @@ -146,46 +61,6 @@ If you want to build the monkey from source instead of using our provided packag License ======= -Copyright (c) 2016 Guardicore Ltd +Copyright (c) 2017 Guardicore Ltd -See the [LICENSE](LICENSE) file for license rights and limitations (GPLv3). - -Dependent packages ---------------------- - -Dependency | License | Notes -----------------------------|----------------------------|---------------------------- - libffi-dev | https://github.com/atgreen/libffi/blob/master/LICENSE - PyCrypto | Public domain - upx | Custom license, http://upx.sourceforge.net/upx-license.html - bson | BSD - enum34 | BSD - pyasn1 | BSD - psutil | BSD - flask | BSD - flask-Pymongo | BSD - Flask-Restful | BSD - python-dateutil | Simplified BSD - zope | ZPL 2.1 - Bootstrap | MIT - Bootstrap Switch | Apache 2.0 - Bootstrap Dialog | MIT - JSON Editor | MIT - Datatables | MIT - jQuery | MIT - cffi | MIT - twisted | MIT - typeahead.js | MIT - Font Awesome | MIT - vis.js | MIT/Apache 2.0 - impacket | Apache Modified - Start Bootstrap (UI Theme) | Apache 2.0 - requests | Apache 2.0 - grequests | BSD - odict | Python Software Foundation License - paramiko | LGPL - rdpy | GPL-3 - winbind | GPL-3 - pyinstaller | GPL - Celery | BSD - mimikatz | CC BY 4.0 | We use an altered version of mimikatz made by gentilkiwi: https://github.com/guardicore/mimikatz +See the [LICENSE](LICENSE) file for license rights and limitations (GPLv3). \ No newline at end of file diff --git a/chaos_monkey/config.py b/chaos_monkey/config.py index e1d830978..e62820816 100644 --- a/chaos_monkey/config.py +++ b/chaos_monkey/config.py @@ -183,7 +183,6 @@ class Configuration(object): local_network_scan = True range_class = FixedRange - range_size = 1 range_fixed = ['', ] blocked_ips = ['', ] diff --git a/chaos_monkey/example.conf b/chaos_monkey/example.conf index 05e8f0f5a..6f70f888a 100644 --- a/chaos_monkey/example.conf +++ b/chaos_monkey/example.conf @@ -52,7 +52,6 @@ "ms08_067_remote_user_add": "Monkey_IUSER_SUPPORT", "ms08_067_remote_user_pass": "Password1!", "ping_scan_timeout": 10000, - "range_size": 30, "rdp_use_vbs_download": true, "smb_download_timeout": 300, "smb_service_name": "InfectionMonkey", diff --git a/chaos_monkey/network/range.py b/chaos_monkey/network/range.py index 5163a6aad..fdd29bc09 100644 --- a/chaos_monkey/network/range.py +++ b/chaos_monkey/network/range.py @@ -45,7 +45,7 @@ class RelativeRange(NetworkRange): def __init__(self, base_address, shuffle=True): base_address = struct.unpack(">L", socket.inet_aton(base_address))[0] super(RelativeRange, self).__init__(base_address, shuffle=shuffle) - self._size = self._config.range_size + self._size = 1 def __repr__(self): return "" % (socket.inet_ntoa(struct.pack(">L", self._base_address - self._size)), diff --git a/chaos_monkey/readme.txt b/chaos_monkey/readme.txt index 4a3a965dd..21f3d0015 100644 --- a/chaos_monkey/readme.txt +++ b/chaos_monkey/readme.txt @@ -1,6 +1,6 @@ How to build a monkey binary from scratch. -The monkey is composed of three seperate parts. +The monkey is composed of three separate 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. @@ -9,8 +9,7 @@ The monkey is composed of three seperate parts. 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/ + https://www.python.org/download/releases/2.7/ If not using ActiveState, install pywin32, minimum build 219 http://sourceforge.net/projects/pywin32/files/pywin32 3. a. install VCForPython27.msi @@ -23,9 +22,9 @@ The monkey is composed of three seperate parts. 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 + cd [code location]/chaos_monkey build_windows.bat - output is in dist\monkey.exe + output is placed under dist\monkey.exe --- Linux --- @@ -34,20 +33,19 @@ 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 + Install the python packages listed in requirements.txt using pip + pip install -r requirements.txt +2. Place the 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 + output is placed under dist/monkey -- Sambacry -- Sambacry requires two standalone binaries to execute remotely. -Compiling them requires gcc +Compiling them requires gcc. cd [code location]/chaos_monkey/monkey_utils/sambacry_monkey_runner ./build.sh @@ -55,4 +53,4 @@ cd [code location]/chaos_monkey/monkey_utils/sambacry_monkey_runner 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 +Download both 32 and 64 bit DLLs and place them under [code location]\chaos_monkey\bin \ No newline at end of file diff --git a/monkey_island/cc/resources/root.py b/monkey_island/cc/resources/root.py index 781926818..3f5ee9dd4 100644 --- a/monkey_island/cc/resources/root.py +++ b/monkey_island/cc/resources/root.py @@ -29,7 +29,7 @@ class Root(flask_restful.Resource): ConfigService.init_config() return jsonify(status='OK') elif action == "killall": - mongo.db.monkey.update({}, {'$set': {'config.alive': False, 'modifytime': datetime.now()}}, upsert=False, + mongo.db.monkey.update({'dead': False}, {'$set': {'config.alive': False, 'modifytime': datetime.now()}}, upsert=False, multi=True) return jsonify(status='OK') else: diff --git a/monkey_island/cc/services/config.py b/monkey_island/cc/services/config.py index 7f7f0a227..200e24029 100644 --- a/monkey_island/cc/services/config.py +++ b/monkey_island/cc/services/config.py @@ -191,10 +191,13 @@ SCHEMA = { "description": "Determines whether the monkey should scan its subnets additionally" }, "depth": { - "title": "Depth" + WARNING_SIGN, + "title": "Distance from island", "type": "integer", "default": 2, - "description": "Amount of hops allowed for the monkey to spread" + "description": + "Amount of hops allowed for the monkey to spread from the island. " + + WARNING_SIGN + + " Note that setting this value too high may result in the monkey propagating too far" } } }, @@ -208,28 +211,17 @@ SCHEMA = { "default": "FixedRange", "enum": [ "FixedRange", - "RelativeRange", "ClassCRange" ], "enumNames": [ "Fixed Range", - "Relative Range", "Class C Range" ], "description": "Determines which class to use to determine scan range." " Fixed Range will scan only specific IPs listed under Fixed range IP list." - " Relative Range will scan the closest ips to the machine's IP." " Class C Range will scan machines in the Class C network the monkey's on." }, - "range_size": { - "title": "Relative range size", - "type": "integer", - "default": 1, - "description": - "Determines the size of the RelativeRange - amount of IPs to scan" - " (Only relevant for Relative Range)" - }, "range_fixed": { "title": "Fixed range IP list", "type": "array", @@ -304,12 +296,14 @@ SCHEMA = { "description": "Determines the maximum number of machines the monkey is allowed to scan" }, "victims_max_exploit": { - "title": "Max victims to exploit" + WARNING_SIGN, + "title": "Max victims to exploit", "type": "integer", "default": 7, "description": "Determines the maximum number of machines the monkey" - " is allowed to successfully exploit" + " is allowed to successfully exploit. " + WARNING_SIGN + + " Note that setting this value too high may result in the monkey propagating to " + "a high number of machines" }, "timeout_between_iterations": { "title": "Wait time between iterations", @@ -587,7 +581,7 @@ SCHEMA = { "type": "object", "properties": { "exploiter_classes": { - "title": "Exploits" + WARNING_SIGN, + "title": "Exploits", "type": "array", "uniqueItems": True, "items": { @@ -601,7 +595,9 @@ SCHEMA = { "SambaCryExploiter", "ElasticGroovyExploiter" ], - "description": "Determines which exploits to use" + "description": + "Determines which exploits to use. " + WARNING_SIGN + + " Note that using unsafe exploits may cause crashes of the exploited machine/service" }, "skip_exploit_if_file_exist": { "title": "Skip exploit if file exists", diff --git a/monkey_island/cc/services/node.py b/monkey_island/cc/services/node.py index 128ca344d..3acd66b75 100644 --- a/monkey_island/cc/services/node.py +++ b/monkey_island/cc/services/node.py @@ -31,7 +31,7 @@ class NodeService: # node is infected new_node = NodeService.monkey_to_net_node(monkey) for key in monkey: - if key not in ["_id", "modifytime", "parent", "dead"]: + if key not in ['_id', 'modifytime', 'parent', 'dead', 'description']: new_node[key] = monkey[key] else: @@ -209,8 +209,14 @@ class NodeService: @staticmethod def set_monkey_dead(monkey, is_dead): + props_to_set = {'dead': is_dead} + + # Cancel the force kill once monkey died + if is_dead: + props_to_set['config.alive'] = True + mongo.db.monkey.update({"guid": monkey['guid']}, - {'$set': {'dead': is_dead}}, + {'$set': props_to_set}, upsert=False) @staticmethod @@ -255,9 +261,10 @@ class NodeService: {'dead': {'$ne': True}, 'keepalive': {'$gte': datetime.now() - timedelta(minutes=10)}}): return + # config.alive is changed to true to cancel the force kill of dead monkeys mongo.db.monkey.update( {'keepalive': {'$lte': datetime.now() - timedelta(minutes=10)}, 'dead': {'$ne': True}}, - {'$set': {'dead': True, 'modifytime': datetime.now()}}, upsert=False, multi=True) + {'$set': {'dead': True, 'config.alive': True, 'modifytime': datetime.now()}}, upsert=False, multi=True) @staticmethod def is_any_monkey_alive(): diff --git a/monkey_island/cc/ui/package.json b/monkey_island/cc/ui/package.json index d744b8c89..64d7643ce 100644 --- a/monkey_island/cc/ui/package.json +++ b/monkey_island/cc/ui/package.json @@ -64,11 +64,8 @@ "bootstrap": "^3.3.7", "core-js": "^2.5.1", "fetch": "^1.1.0", - "github-markdown-css": "^2.8.0", - "marked": "^0.3.6", "normalize.css": "^4.0.0", "prop-types": "^15.5.10", - "raw-loader": "^0.5.1", "react": "^15.6.1", "react-bootstrap": "^0.31.2", "react-copy-to-clipboard": "^5.0.0", diff --git a/monkey_island/cc/ui/src/components/Main.js b/monkey_island/cc/ui/src/components/Main.js index 34e6f0137..a05197559 100644 --- a/monkey_island/cc/ui/src/components/Main.js +++ b/monkey_island/cc/ui/src/components/Main.js @@ -10,7 +10,7 @@ import MapPage from 'components/pages/MapPage'; import TelemetryPage from 'components/pages/TelemetryPage'; import StartOverPage from 'components/pages/StartOverPage'; import ReportPage from 'components/pages/ReportPage'; -import ReadMePage from 'components/pages/ReadMePage'; +import LicensePage from 'components/pages/LicensePage'; require('normalize.css/normalize.css'); require('react-data-components/css/table-twbs.css'); @@ -101,12 +101,12 @@ class AppComponent extends React.Component {
  • 4. - Pen. Test Report + Security Report
  • - 5. + Start Over
    • @@ -115,18 +115,19 @@ class AppComponent extends React.Component {
    • Configuration
      • -
    • Monkey Telemetry
      • -
    • Read Me
      • +
    • Log
    -
    +
    Powered by GuardiCore
    - +
    + License +
    ( )} /> @@ -136,7 +137,7 @@ class AppComponent extends React.Component { ( )} /> ( )} /> ( )} /> - ( )} /> + ( )} /> diff --git a/monkey_island/cc/ui/src/components/pages/ConfigurePage.js b/monkey_island/cc/ui/src/components/pages/ConfigurePage.js index 5b239d1f8..92d6a5687 100644 --- a/monkey_island/cc/ui/src/components/pages/ConfigurePage.js +++ b/monkey_island/cc/ui/src/components/pages/ConfigurePage.js @@ -17,7 +17,8 @@ class ConfigurePageComponent extends React.Component { saved: false, reset: false, sections: [], - selectedSection: 'basic' + selectedSection: 'basic', + allMonkeysAreDead: true }; } @@ -36,6 +37,7 @@ class ConfigurePageComponent extends React.Component { selectedSection: 'basic' }) }); + this.updateMonkeysRunning(); } onSubmit = ({formData}) => { @@ -99,6 +101,17 @@ class ConfigurePageComponent extends React.Component { }); }; + updateMonkeysRunning = () => { + fetch('/api') + .then(res => res.json()) + .then(res => { + // This check is used to prevent unnecessary re-rendering + this.setState({ + allMonkeysAreDead: (!res['completed_steps']['run_monkey']) || (res['completed_steps']['infection_done']) + }); + }); + }; + render() { let displayedSchema = {}; if (this.state.schema.hasOwnProperty('properties')) { @@ -107,7 +120,7 @@ class ConfigurePageComponent extends React.Component { } return ( - +

    Monkey Configuration

    :
    @@ -131,14 +144,14 @@ class ConfigurePageComponent extends React.Component { onSubmit={this.onSubmit} onChange={this.onChange}>
    -
    - - Changing the configuration will only apply to new infections. -
    -
    - - Changing config values with the ⚠ mark may result in the monkey propagating too far or using dangerous exploits. -
    + { this.state.allMonkeysAreDead ? + '' : +
    + + Some monkeys are currently running. Note that changing the configuration will only apply to new + infections. +
    + }
    - +
    + + +
    ) @@ -160,13 +160,31 @@ class MapPageComponent extends React.Component { return (
    {this.renderKillDialogModal()} - -

    Infection Map

    - - - + +

    3. Infection Map

    +
    + Legend: + Exploit + | + Scan + | + Tunnel + | + Island Communication +
    + { + /* +
    +
    + 2017-10-16 16:00:05 + monkey-elastic + bla bla +
    +
    + */ + }
    diff --git a/monkey_island/cc/ui/src/components/pages/ReadMePage.js b/monkey_island/cc/ui/src/components/pages/ReadMePage.js deleted file mode 100644 index 199e4c623..000000000 --- a/monkey_island/cc/ui/src/components/pages/ReadMePage.js +++ /dev/null @@ -1,53 +0,0 @@ -import React from 'react'; -import {Col, Nav, NavItem} from 'react-bootstrap'; -var marked = require('marked'); - -var aboutDoc = require('raw!../../readme/About.md'); -var usageDoc = require('raw!../../readme/Usage.md'); -var howItWorksDoc = require('raw!../../readme/HowItWorks.md'); -var licenseDoc = require('raw!../../readme/License.md'); - -class ReadMePageComponent extends React.Component { - constructor(props) { - super(props); - - this.sectionKeys = ['about', 'howItWorks', 'usage', 'license']; - this.sections = - { - about: {title: 'About', data: aboutDoc}, - usage: {title: 'Usage', data: usageDoc}, - howItWorks: {title: 'How It Works', data: howItWorksDoc}, - license: {title: 'License', data: licenseDoc} - }; - - this.state = { - selectedSection: this.sectionKeys[0] - } - } - - setSelectedSection = (key) => { - this.setState({ - selectedSection: key - }); - }; - - render() { - - return ( - -

    Read Me

    - -
    -
    - - ); - } -} - -export default ReadMePageComponent; diff --git a/monkey_island/cc/ui/src/components/pages/ReportPage.js b/monkey_island/cc/ui/src/components/pages/ReportPage.js index c607a99fe..633fadc12 100644 --- a/monkey_island/cc/ui/src/components/pages/ReportPage.js +++ b/monkey_island/cc/ui/src/components/pages/ReportPage.js @@ -8,9 +8,9 @@ class ReportPageComponent extends React.Component { render() { return ( - -

    Penetration Test Report

    -
    + +

    4. Security Report

    +

    Under construction

    diff --git a/monkey_island/cc/ui/src/components/pages/RunMonkeyPage.js b/monkey_island/cc/ui/src/components/pages/RunMonkeyPage.js index 95b819660..5574a73ba 100644 --- a/monkey_island/cc/ui/src/components/pages/RunMonkeyPage.js +++ b/monkey_island/cc/ui/src/components/pages/RunMonkeyPage.js @@ -1,5 +1,5 @@ import React from 'react'; -import {Button, Col, Well, Nav, NavItem} from 'react-bootstrap'; +import {Button, Col, Well, Nav, NavItem, Collapse} from 'react-bootstrap'; import CopyToClipboard from 'react-copy-to-clipboard'; import {Icon} from 'react-fa'; import {Link} from 'react-router-dom'; @@ -10,10 +10,11 @@ class RunMonkeyPageComponent extends React.Component { super(props); this.state = { ips: [], - selectedIp: '0.0.0.0', runningOnIslandState: 'not_running', runningOnClientState: 'not_running', - selectedSection: 'windows-32' + selectedIp: '0.0.0.0', + selectedOs: 'windows-32', + showManual: false }; } @@ -21,7 +22,8 @@ class RunMonkeyPageComponent extends React.Component { fetch('/api') .then(res => res.json()) .then(res => this.setState({ - ips: res['ip_addresses'] + ips: res['ip_addresses'], + selectedIp: res['ip_addresses'][0] })); fetch('/api/local-monkey') @@ -80,17 +82,17 @@ class RunMonkeyPageComponent extends React.Component { }); }; - generateCmdDiv(ip) { - let isLinux = (this.state.selectedSection.split('-')[0] === 'linux'); - let is32Bit = (this.state.selectedSection.split('-')[1] === '32'); + generateCmdDiv() { + let isLinux = (this.state.selectedOs.split('-')[0] === 'linux'); + let is32Bit = (this.state.selectedOs.split('-')[1] === '32'); let cmdText = ''; if (isLinux) { - cmdText = this.generateLinuxCmd(ip, is32Bit); + cmdText = this.generateLinuxCmd(this.state.selectedIp, is32Bit); } else { - cmdText = this.generateWindowsCmd(ip, is32Bit); + cmdText = this.generateWindowsCmd(this.state.selectedIp, is32Bit); } return ( - +
    @@ -147,22 +162,40 @@ class RunMonkeyPageComponent extends React.Component { */ }

    -
    -

    - Run one of those snippets on a host for infecting it with a Monkey: -
    - (The IP address is used as the monkey's C&C address) -

    - - {this.state.ips.map(ip => this.generateCmdDiv(ip))} -
    +

    + OR +

    +

    + +

    + +
    +

    + Choose the operating system where you want to run the monkey + {this.state.ips.length > 1 ? ', and the interface to communicate with.' : '.'} +

    + + {this.state.ips.length > 1 ? + + :
    + } +

    + Copy the following command to your machine and run it with Administrator or root privileges. +

    + {this.generateCmdDiv()} +
    + +

    Go ahead and monitor the ongoing infection in the Infection Map view.

    diff --git a/monkey_island/cc/ui/src/components/pages/RunServerPage.js b/monkey_island/cc/ui/src/components/pages/RunServerPage.js index d601e1915..5143f24fc 100644 --- a/monkey_island/cc/ui/src/components/pages/RunServerPage.js +++ b/monkey_island/cc/ui/src/components/pages/RunServerPage.js @@ -5,27 +5,26 @@ import {Link} from 'react-router-dom'; class RunServerPageComponent extends React.Component { constructor(props) { super(props); - this.state = {ip: '0.0.0.0'}; - } - - componentDidMount() { - fetch('/api') - .then(res => res.json()) - .then(res => this.setState({ip: res['ip_addresses'][0]})); } render() { return ( - -

    Monkey Island C&C Server

    -
    -

    Your Monkey Island server is up and running on {this.state.ip} 👏 👏

    + +

    1. Monkey Island C&C Server

    +
    +

    Congrats! You have successfully set up the Monkey Island server. 👏 👏

    +

    + The Infection Monkey is an open source security tool for testing a data center's resiliency to perimeter + breaches and internal server infections. + The Monkey uses various methods to propagate across a data + center and reports to this Command and Control (C&C) server. +

    +

    + To read more about the Monkey, visit infectionmonkey.com +

    Go ahead and run the monkey.

    -

    - (You can make further adjustments by configuring the monkey) -

    ); diff --git a/monkey_island/cc/ui/src/components/pages/StartOverPage.js b/monkey_island/cc/ui/src/components/pages/StartOverPage.js index 543f9465b..2889a7067 100644 --- a/monkey_island/cc/ui/src/components/pages/StartOverPage.js +++ b/monkey_island/cc/ui/src/components/pages/StartOverPage.js @@ -33,7 +33,7 @@ class StartOverPageComponent extends React.Component { return ( this.setState({showCleanDialog: false})}> this.setState({showCleanDialog: false})}> -

    Reset environment

    +

    Reset environment

    Are you sure you want to reset the environment?

    @@ -46,17 +46,19 @@ class StartOverPageComponent extends React.Component { :
    } - - +
    + + +
    ) @@ -64,16 +66,13 @@ class StartOverPageComponent extends React.Component { render() { return ( - + {this.renderCleanDialogModal()}

    Start Over

    - In order to reset the entire environment, all monkeys will be ordered to kill themselves - and the database will be cleaned up. -

    -

    - After that you could go back to the Run Monkey page to start new infections. + If you are finished and want to start over with a fresh configuration, erase the logs and clear the map + you can go ahead and

    + You don't have to reset the environment to keep running monkeys. You can continue and Run More Monkeys as you wish, and see the results on the Infection Map without deleting anything.
    diff --git a/monkey_island/cc/ui/src/components/pages/TelemetryPage.js b/monkey_island/cc/ui/src/components/pages/TelemetryPage.js index d27adfcfa..03c57807e 100644 --- a/monkey_island/cc/ui/src/components/pages/TelemetryPage.js +++ b/monkey_island/cc/ui/src/components/pages/TelemetryPage.js @@ -29,8 +29,8 @@ class TelemetryPageComponent extends React.Component { render() { return ( - -

    Monkey Telemetry

    + +

    Log

    {text}}> + + + ); + } + osRow(asset) { return ( Operating System - {asset.os} + {asset.os.charAt(0).toUpperCase() + asset.os.slice(1)} ); } @@ -34,26 +43,20 @@ class PreviewPaneComponent extends React.Component { accessibleRow(asset) { return ( - Accessible From + + Accessible From  + {this.generateToolTip('List of machine which can access this one using a network protocol')} + {asset.accessible_from_nodes.map(val =>
    {val}
    )} ); } - descriptionRow(asset) { + statusRow(asset) { return ( - Description - {asset.description} - - ); - } - - aliveRow(asset) { - return ( - - Alive - {(!asset.dead).toString()} + Status + {(asset.dead) ? 'Dead' : 'Alive'} ); } @@ -72,10 +75,14 @@ class PreviewPaneComponent extends React.Component { forceKillRow(asset) { return ( - Force Kill + + Force Kill  + {this.generateToolTip('If this is on, monkey will die next time it communicates')} + - this.forceKill(e, asset)} /> + this.forceKill(e, asset)} /> + ); @@ -88,7 +95,10 @@ class PreviewPaneComponent extends React.Component { return (
    -

    Timeline

    +

    + Exploit Timeline  + {this.generateToolTip('Timeline of exploit attempts. Red is successful. Gray is unsuccessful')} +

      { asset.exploits.map(exploit =>
    • @@ -124,9 +134,8 @@ class PreviewPaneComponent extends React.Component {
      - {this.descriptionRow(asset)} - {this.aliveRow(asset)} {this.osRow(asset)} + {this.statusRow(asset)} {this.ipsRow(asset)} {this.servicesRow(asset)} {this.accessibleRow(asset)} @@ -214,7 +223,7 @@ class PreviewPaneComponent extends React.Component { { !info ? - Select an item on the map for a preview + Select an item on the map for a detailed look :
      diff --git a/monkey_island/cc/ui/src/images/map-legend.png b/monkey_island/cc/ui/src/images/map-legend.png deleted file mode 100644 index 4b7759a09..000000000 Binary files a/monkey_island/cc/ui/src/images/map-legend.png and /dev/null differ diff --git a/monkey_island/cc/ui/src/readme/About.md b/monkey_island/cc/ui/src/readme/About.md deleted file mode 100644 index 123f09413..000000000 --- a/monkey_island/cc/ui/src/readme/About.md +++ /dev/null @@ -1,30 +0,0 @@ -About -======= - -Welcome to the Infection Monkey! - -The Infection Monkey is an open source security tool for testing a data center's resiliency to perimeter breaches and internal server infection. The Monkey uses various methods to self propagate across a data center and reports success to a centralized C&C server. To read more about the Monkey, visit https://www.infectionmonkey.com - -Features include: - -* Multiple propagation techniques: - * Predefined passwords - * Common exploits - * Password stealing using mimikatz -* Multiple exploit methods: - * SSH - * SMB - * RDP - * WMI - * Shellshock - * SambaCry - * Elastic Search - -* A C&C server with a dedicated UI to visualize the Monkey's progress inside the data center - -The Infection Monkey is comprised of two parts: the Monkey and the C&C server. -The monkey is the tool which infects other machines and propagates to them, while the C&C server collects all Monkey reports and displays them to the user. - -Building the Monkey from source -------------------------------- -If you want to build the monkey from source instead of using our provided packages, follow the instructions at the readme files under [chaos_monkey](chaos_monkey) and [monkey_island](monkey_island). \ No newline at end of file diff --git a/monkey_island/cc/ui/src/readme/HowItWorks.md b/monkey_island/cc/ui/src/readme/HowItWorks.md deleted file mode 100644 index 763ecfd70..000000000 --- a/monkey_island/cc/ui/src/readme/HowItWorks.md +++ /dev/null @@ -1,41 +0,0 @@ -How It Works -======= - -Whether you're downloading or building the Monkey from source, the Infection Monkey is comprised of 4 executable files for different platforms plus a default configuration file. - -Monkey configuration is stored in two places: -1. By default, the Monkey uses a local configuration file (usually, config.bin). This configuration file must include the address of the Monkey's C&C server. -2. After successfully connecting to the C&C server, the monkey downloads a new configuration from the server and discards the local configuration. It is possible to change the default configuration from the C&C server's UI. - -In both cases the command server hostname should be modified to point to your local instance of the Monkey Island (note that this doesn't require connectivity right off the bat). In addition, to improve the Monkey's chances of spreading, you can pre-seed it with credentials and usernames commonly used. - -Both configuration options use a JSON format for specifying options; see "Options" below for details. - -How the Monkey works ---------------------- - -1. Wakeup connection to c&c, sends basic info of the current machine and the configuration the monkey uses to the c&c. - 1. First try direct connection to c&c. - 2. If direct connection fails, try connection through a tunnel, a tunnel is found according to specified parameter (the default tunnel) or by sending a multicast query and waiting for another monkey to answer. - 3. If no connection can be made to c&c, continue without it. -2. If a firewall app is running on the machine (supports Windows Firewall for Win XP and Windows Advanced Firewall for Win 7+), try to add a rule to allow all our traffic. -3. Startup of tunnel for other Monkeys (if connection to c&c works). - 1. Firewall is checked to allow listening sockets (if we failed to add a rule to Windows firewall for example, the tunnel will not be created) - 2. Will answer multicast requests from other Monkeys in search of a tunnel. -4. Running exploitation sessions, will run x sessions according to configuration: - 1. Connect to c&c and get the latest configuration - 2. Scan ip ranges according to configuration. - 3. Try fingerprinting each host that answers, using the classes defined in the configuration (SMBFinger, SSHFinger, etc) - 4. Try exploitation on each host found, for each exploit class in configuration: - 1. check exploit class supports target host (can be disabled by configuration) - 2. each exploitation class will use the data acquired in fingerprinting, or during the exploit, to find the suitable Monkey executable for the host from the c&c. - 1. If c&c connection fails, and the source monkey’s executable is suitable, we use it. - 2. If a suitable executable isn’t found, exploitation will fail. - 3. Executables are cached in memory. - 5. will skip hosts that are already exploited in next run - 6. will skip hosts that failed during exploitation in next run (can be disabled by configuration) -5. Close tunnel before exiting -Wait for monkeys using the tunnel to unregister for it -Cleanup -Remove firewall rules if added - diff --git a/monkey_island/cc/ui/src/readme/License.md b/monkey_island/cc/ui/src/readme/License.md deleted file mode 100644 index dc85fd0e3..000000000 --- a/monkey_island/cc/ui/src/readme/License.md +++ /dev/null @@ -1,45 +0,0 @@ -License -======= -Copyright (c) 2016 Guardicore Ltd - -See the [LICENSE](LICENSE) file for license rights and limitations (GPLv3). - -Dependent packages ---------------------- - -Dependency | License | Notes -----------------------------|----------------------------|---------------------------- - libffi-dev | https://github.com/atgreen/libffi/blob/master/LICENSE - PyCrypto | Public domain - upx | Custom license, http://upx.sourceforge.net/upx-license.html - bson | BSD - enum34 | BSD - pyasn1 | BSD - psutil | BSD - flask | BSD - flask-Pymongo | BSD - Flask-Restful | BSD - python-dateutil | Simplified BSD - zope | ZPL 2.1 - Bootstrap | MIT - Bootstrap Switch | Apache 2.0 - Bootstrap Dialog | MIT - JSON Editor | MIT - Datatables | MIT - jQuery | MIT - cffi | MIT - twisted | MIT - typeahead.js | MIT - Font Awesome | MIT - vis.js | MIT/Apache 2.0 - impacket | Apache Modified - Start Bootstrap (UI Theme) | Apache 2.0 - requests | Apache 2.0 - grequests | BSD - odict | Python Software Foundation License - paramiko | LGPL - rdpy | GPL-3 - winbind | GPL-3 - pyinstaller | GPL - Celery | BSD - mimikatz | CC BY 4.0 | We use an altered version of mimikatz made by gentilkiwi: https://github.com/guardicore/mimikatz diff --git a/monkey_island/cc/ui/src/readme/Usage.md b/monkey_island/cc/ui/src/readme/Usage.md deleted file mode 100644 index 45e2b01ac..000000000 --- a/monkey_island/cc/ui/src/readme/Usage.md +++ /dev/null @@ -1,10 +0,0 @@ -Usage -======= - -Once configured, run the monkey using ```./monkey-linux-64 m0nk3y -c config.bin -s 41.50.73.31:5000``` (Windows is identical). This can be done at multiple points in the network simultaneously. - -Command line options include: -* `-c`, `--config`: set configuration file. JSON file with configuration values, will override compiled configuration. -* `-p`, `--parent`: set monkey’s parent uuid, allows better recognition of exploited monkeys in c&c -* `-t`, `--tunnel`: ip:port, set default tunnel for Monkey when connecting to c&c. -* `-d`, `--depth` : sets the Monkey's current operation depth. diff --git a/monkey_island/cc/ui/src/styles/App.css b/monkey_island/cc/ui/src/styles/App.css index 300e14cf8..9ecf08cbb 100644 --- a/monkey_island/cc/ui/src/styles/App.css +++ b/monkey_island/cc/ui/src/styles/App.css @@ -270,6 +270,33 @@ body { background: #d30d09; } +.telemetry-console { + z-index: 2; + position: absolute; + bottom: 0; + left: 0; + right: 0; + height: 70px; + background: rgba(0,0,0,0.7); + border-radius: 5px; + border: 3px solid #aaa; + padding: 0.5em; + color: white; + font-family: Consolas, "Courier New", monospace; +} + +.telemetry-console .date { + color: #ccc; +} + +.telemetry-console .source { + font-weight: bold; +} + +.map-legend { + font-size: 18px; +} + /* * Full Logs Page */ @@ -314,6 +341,11 @@ body { width: 100px; } +.license-link a:link, .license-link a:visited { + color: #797979 !important; + font-size: 0.9em; +} + .data-table-container .pagination { margin: 0 !important; } diff --git a/monkey_island/readme.txt b/monkey_island/readme.txt index d5cae317c..2feaaa1ab 100644 --- a/monkey_island/readme.txt +++ b/monkey_island/readme.txt @@ -1,26 +1,24 @@ How to set C&C server: ---------------- On Windows ----------------: -1. Create bin folder - 1.1. create folder "bin" under monkey_island +1. Create folder "bin" under monkey_island 2. Place portable version of Python 2.7 2.1. Download and install from: https://www.python.org/download/releases/2.7/ - 2.2. Download & Run get-pip.py from: https://bootstrap.pypa.io/get-pip.py - 2.3. Install required python libraries using "python -m pip install -r monkey_island\requirements.txt" - 2.4. Copy Contents from Installation path (Usually C:\Python27) to monkey_island\bin\Python27 - 2.5. Copy Python27.dll from System32 folder (Usually C:\Windows\System32) to monkey_island\bin\Python27 - 2.6. (Optional) You may uninstall Python27 if you like. + 2.2. Install the required python libraries using "python -m pip install -r monkey_island\requirements.txt" + 2.3. Copy contents from installation path (Usually C:\Python27) to monkey_island\bin\Python27 + 2.4. Copy Python27.dll from System32 folder (Usually C:\Windows\System32 or C:\Python27) to monkey_island\bin\Python27 + 2.5. (Optional) You may uninstall Python27 if you like. 3. Place portable version of mongodb - 3.1. Download from: http://downloads.mongodb.org/win32/mongodb-win32-x86_64-2008plus-ssl-latest.zip + 3.1. Download from: https://downloads.mongodb.org/win32/mongodb-win32-x86_64-2008plus-ssl-latest.zip 3.2. Extract contents from bin folder to monkey_island\bin\mongodb. 4. Place portable version of OpenSSL - 4.1. Download from: http://downloads.sourceforge.net/gnuwin32/openssl-0.9.8h-1-bin.zip + 4.1. Download from: https://indy.fulgan.com/SSL/openssl-1.0.2l-i386-win32.zip 4.2. Extract content from bin folder to monkey_island\bin\openssl -5. Download and install Microsoft Visual C++ Redisutable for Visual Studio 2017 +5. Download and install Microsoft Visual C++ redistributable for Visual Studio 2017 5.1. Download and install from: https://go.microsoft.com/fwlink/?LinkId=746572 6. Generate SSL Certificate 6.1. run create_certificate.bat when your current working directory is monkey_island -7. Put chaos monkey binaries in monkey_island\cc\binaries (create folder if it doesn't exist): +7. Create the monkey_island\cc\binaries folder and put chaos monkey binaries inside 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 @@ -29,10 +27,11 @@ How to set C&C server: 8.1. Download and install from: https://www.npmjs.com/get-npm 9. Build Monkey Island frontend 9.1. cd to 'monkey_island\cc\ui' - 9.2. run 'npm run dist' + 9.2. run 'npm update' + 9.3. run 'npm run dist' How to run: -1. start monkey_island\windows\run_server.bat (when your current working directory is monkey_island) +1. When your current working directory is monkey_island, run monkey_island\windows\run_server.bat ---------------- On Linux ----------------: 1. Create the following directories: @@ -44,6 +43,7 @@ How to run: 2. Install the packages from monkey_island/requirements.txt: sudo python -m pip install -r /var/monkey_island/requirements.txt + If pip is not installed, install the python-pip package. Make sure the server is running Python 2.7 and not Python 3+. 3. put monkey binaries in /var/monkey_island/cc/binaries monkey-linux-64 - monkey binary for linux 64bit @@ -52,8 +52,8 @@ How to run: monkey-windows-64.exe - monkey binary for windows 64bi 4. Download MongoDB and extract it to /var/monkey_island/bin/mongodb - for debian64 - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-debian71-3.0.7.tgz - for ubuntu64 14.10 - https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1410-clang-3.0.7.tgz + for debian64 - https://downloads.mongodb.org/linux/mongodb-linux-x86_64-debian81-latest.tgz + for ubuntu64 16.10 - https://downloads.mongodb.org/linux/mongodb-linux-x86_64-ubuntu1604-latest.tgz find more at - https://www.mongodb.org/downloads#production untar.gz with: tar -zxvf filename.tar.gz -C /var/monkey_island/bin/mongodb (make sure the content of the mongo folder is in this directory, meaning this path exists: @@ -72,7 +72,8 @@ How to run: 9. Build Monkey Island frontend 9.1. cd to 'monkey_island/cc/ui' - 9.2. run 'npm run dist' + 9.2. run 'npm update' + 9.3. run 'npm run dist' How to run: -1. run run.sh +1. run run.sh (located under /linux)