monkey/windows.md at 28cf8b55cfaaeb201aae414bb391ad8bb7da9627

3.5 KiB

Raw Blame History

title

date

draft

pre

weight

Deployment

{{% notice tip %}} Don't get scared if the Infection Monkey gets flagged as malware during the installation. {{% /notice %}}

After running the installer, the following prompt should appear on the screen:

Follow the steps to complete the installation.
Run the Monkey Island by clicking on the desktop shortcut.

{{% notice info %}} If you're prompted to delete your data directory and you're not sure what to do, see the [FAQ]({{< ref "/faq/#i-updated-to-a-new-version-of-the-infection-monkey-and-im-being-asked-to-delete-my-existing-data-directory-why"

}}) for more information. {{% /notice %}}

Start Monkey Island with user-provided certificate

By default, Infection Monkey comes with a self-signed SSL certificate. In enterprise or other security-sensitive environments, it is recommended that the user provide Infection Monkey with a certificate that has been signed by a private certificate authority.

If you haven't already, run the Monkey Island by clicking on the desktop shortcut. This will populate MongoDB, as well as create and populate %AppData%\monkey_island.
Stop the Monkey Island process.
(Optional but recommended) Move your .crt and .key files to %AppData%\monkey_island.

Edit %AppData%\monkey_island\server_config.json to configure Monkey Island to use your certificate. Your config should look something like this:

{
  "log_level": "DEBUG",
  "environment": {
    "server_config": "password",
    "deployment": "windows"
  },
  "mongodb": {
    "start_mongodb": true
 },
  "ssl_certificate": {
    "ssl_certificate_file": "<PATH_TO_CRT_FILE>",
    "ssl_certificate_key_file": "<PATH_TO_KEY_FILE>"
  }
}

Run the Monkey Island by clicking on the desktop shortcut.
Access the Monkey Island web UI by pointing your browser at https://localhost:5000.

Troubleshooting

Support

Only English system locale is supported. If your command prompt gives output in a different language, the Infection Monkey is not guaranteed to work.

For supported Windows versions, take a look at the OS support page.

Missing Windows update

The installer requires Windows update #2999226. If you're having trouble running the installer, please make sure to install the update via Windows Update or manually from the link above.

Supported browsers

The Monkey Island supports Chrome (and Chrome-based) browsers. If your Windows server only has Internet Explorer installed, please install Chrome or a similar modern browser. You can download Google Chrome here.

Upgrading

To upgrade the Infection Monkey on Windows, download the new installer and run it. The new Monkey version will be installed over the old version.

If you'd like to keep your existing configuration, you can export it to a file using the Export config button and then import it to the new Monkey Island.

3.5 KiB Raw Blame History