Cantina

Cantina - orquestador de reconocimiento de red legal para OSCP

Cantina es un orquestador de reconocimiento de red legal para OSCP. Descubrimiento de puertos, enumeración de servicios y despacho de plugins. Sin explotación. Sin ejecución automática de rociado de credenciales.

Qué hace

Escanea objetivos (quick / full / udp / vuln / recon / all / deep)
Clasifica los servicios abiertos
Ejecuta plugins de solo enumeración para los servicios coincidentes (HTTP, SMB, FTP, SNMP, SSH y el resto)
Escribe artefactos por puerto, auditoría _commands.log, HTML/JSON opcional

Requisitos

Python 3.10+
Herramientas de Kali (o similares) cuando estén disponibles: nmap, y herramientas de servicio que los plugins llamen cuando estén presentes
Solo dependencias opcionales: las herramientas que falten se omiten, no son fatales

Inicio rápido

# list plugins (no scan)
python tools/cantina.py --list-plugins

# single host
python tools/cantina.py 10.10.10.5 -t quick

# recon with full scan + plugins
python tools/cantina.py 10.10.10.5 -t recon \
  --force-services tcp/80/http tcp/445/smb tcp/22/ssh \
  -o ./out -j

# multi-target concurrent
python tools/cantina.py -T hosts.txt -t all --max-workers 3 --timeout 90

CLI silenciosa (sin banner): python tools/cantina.py TARGET -q

Plugins

Coloca un módulo en plugins/ (o --plugins-dir):

PLUGIN = {
    "name": "my_enum",
    "services": ["ftp"],
    "ports": [21],
    "enabled": True,
    "replaces_builtin": True,
    "description": "FTP enum (enum only)",
    "legal": "enumeration-only; OSCP-safe; no exploit/spray auto-run",
}

def match(signals):
    return signals.get("svc_type") == "ftp" or int(signals.get("port") or 0) == 21

def run(ctx):
    art = ctx.port_dir / "plugin_my_enum.txt"
    art.write_text(f"enum note for {ctx.target}:{ctx.port}\n")
    return {"ok": True, "artifact": str(art)}

replaces_builtin: True omite la rama antigua del monorepo para ese servicio, de modo que no se ejecute dos veces.

Pruebas

pip install pytest
python -m pytest tests/ -q

Legal

Solo enumeración. Solo objetivos autorizados y laboratorio propio / ámbito del examen OSCP. Eres responsable del alcance.

Estructura

tools/              CLI tools (run with: python tools/<tool>.py)
  cantina.py          CLI + orchestrator
  cantina_plugins.py  discover / select / run
plugins/            service enum plugins
assets/banner.txt   CLI terminal banner
banner.jpg          README hero image
tests/              unit tests (stubbed tools)
lab/                optional multi-service lab ground truth
fixtures/           nmap parse fixtures

cantina

Más Populares