SMB Exploiter - Agent Plugin for Infection Monkey

Introduction

SMB Exploiter is an Agent Plugin for Infection Monkey that executes a brute-force attack against a Server Message Block (SMB) server. It supports Versions 1, 2, and 3 of the SMB protocol.

For more information, see the SMB Exploiter Plugin documentation.

Development

Setting up the development environment

To create the resulting SMB archive, follow these steps:

1. Clone the Repository

   $ git clone https://github.com/guardicode/smb-exploiter.git
   $ cd smb-exploiter

2. Install development dependencies

   This project uses Poetry for managing dependencies and virtual environments, and pre-commit for managing pre-commit hooks.

   $ pip install pre-commit poetry
   $ pre-commit install -t pre-commit
   $ poetry install

Running the test suite

The test suite can be run with the following command:

poetry run pytest

Building the plugin

To build the plugin, run the Agent Plugin Builder.

poetry run build_agent_plugin .

The build tool will create SMB-Exploiter.tar, which can be installed in the Monkey Island.