prongs

Fast, custom security scanner

Requirements

• Python >=3.9

Installation

Option 1: Install from source using pip

• Requirements:
  • git
  • Python 3.9+

# Clone repo
git clone https://github.com/UoA-eResearch/prongs.git
cd prongs

# Create and activate virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install
pip install .

# Run
prongs --help

Option 2: Development setup using uv

• Requirements:
  • git
  • uv

# Clone repo
git clone https://github.com/UoA-eResearch/prongs.git
cd prongs

# Install dependencies (including dev tools)
uv sync --all-extras

# Run
uv run prongs --help

Option 3: Container

Pull the pre-built image from GitHub Container Registry:

docker pull ghcr.io/uoa-eresearch/prongs:latest

Or build locally:

docker build -f app/Dockerfile -t prongs .

Usage

Examples

• Execute password SSH check against two target networks:

prongs -s password-ssh -t 192.168.0.0/32,192.168.88.0/32

• Execute all scanners against target networks specified in a file:

echo -e "192.168.0.0/32\n192.168.88.0/32" > targets.txt
prongs -s password-ssh -f targets.txt

• Execute password SSH scanner using environment variables:

TARGET_CIDRS=192.168.0.0/32,192.168.88.0/24 prongs -s password-ssh -e

Running with Docker

docker run -e TARGET_CIDRS=192.168.0.0/32,192.168.88.0/24 ghcr.io/uoa-eresearch/prongs:latest