Cantina

Cantina - OSCP-legal network recon orchestrator

Cantina는 OSCP에 적합한 네트워크 정찰 오케스트레이터입니다. 포트 발견, 서비스 열거, 플러그인 디스패치. 익스플로잇 없음. 자격 증명 스프레이 자동 실행 없음.

기능

대상 스캔 (quick / full / udp / vuln / recon / all / deep)
열린 서비스 분류
일치하는 서비스에 대해 열거 전용 플러그인 실행 (HTTP, SMB, FTP, SNMP, SSH 등)
포트별 아티팩트와 _commands.log 감사 로그 작성, 선택적 HTML/JSON 출력

요구 사항

Python 3.10+
사용 가능한 경우 Kali(또는 유사) 도구: nmap 및 플러그인이 호출하는 서비스 도구
소프트 의존성만: 없는 도구는 건너뛰며 치명적이지 않음

빠른 시작

# 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

Quiet CLI(배너 없음): python tools/cantina.py TARGET -q

플러그인

plugins/ 디렉터리(또는 --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는 해당 서비스에 대한 기존 모노레포 분기를 건너뛰므로 중복 실행되지 않습니다.

테스트

pip install pytest
python -m pytest tests/ -q

법적 고지

열거만 수행합니다. 승인된 대상과 본인 소유 랩 / OSCP 시험 범위에서만 사용하세요. 범위에 대한 책임은 사용자에게 있습니다.

디렉터리 구조

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

인기