Proactive Land Uncovering & Monitoring

Pathogen Agent

*Beta version*

Description

This this tool is the working agent designed to work with Plum-Island

Technical requirements

Python 3.10 or >

Agent supported

nmap

Installation

Installation should stay simple.

Setup

sudo apt-get install nmap
git clone https://github.com/D4-project/Plum-Agent.git
cd Plum-Agent
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Configuration

cd src
python agent.py -s -island HOSTOFISLAND -agentkey XXXTHETOKENKEYXXXX

Execution

python agent -d

Help

$ ./agent.py --help
usage: agent.py [-h] (-o | -d | -s) [-island ISLAND] [-agentkey AGENTKEY] [-ipext IPEXT] [-v]

Plum Discovery Agent

options:
  -h, --help          show this help message and exit
  -o, --once          Run Once
  -d, --daemon        Run Endlessly
  -s, --setup         Setup configuration only
  -island ISLAND      Hostname or IP of the Plum Island controller
  -agentkey AGENTKEY  Agent Key
  -ipext IPEXT        Force External IP
  -v, --verbose       Enable debug output