アーカイブ済み。このプロジェクトは custom-oscp-tooling に移行しました。 Cantina のコードはすべて、Star Wars の enum/アドバイザーツールスイートとともに、現在そちらに置かれています。このリポジトリは履歴保存のため読み取り専用として維持されています。

新しい場所: https://gitlab.com/WattoCyber/custom-oscp-tooling

実行方法: そのリポジトリから python tools/cantina.py

Cantina

Cantina - OSCP-legal network recon orchestrator

概要


何か	Cantina は OSCP 準拠のネットワーク偵察オーケストレーターです。ポート発見、サービス列挙、プラグインのディスパッチを行います。攻撃は行いません。認証情報スプレーの自動実行もありません。
対象者	列挙のみのネットワーク偵察オーケストレーションを、プラグインのディスパッチと監査ログ付きで必要とする OSCP 受講生およびラボ運営者。
そうでないもの	攻撃フレームワークではありません。認証情報スプレーの自動実行はありません。許可されたターゲットと自身のラボのみでの列挙です。

Cantina は OSCP 準拠のネットワーク偵察オーケストレーターです。ポート発見、サービス列挙、プラグインのディスパッチを行います。攻撃は行いません。認証情報スプレーの自動実行もありません。

機能

ターゲットをスキャンします（quick / full / udp / vuln / recon / all / deep）
オープンサービスを分類します
一致するサービスに対して列挙専用プラグインを実行します（HTTP、SMB、FTP、SNMP、SSH など）
ポートごとの成果物、_commands.log 監査ログ、オプションの HTML/JSON を書き出します

要件

Python 3.10+
Kali（または同等）のツールが利用可能な場合: nmap、およびプラグインが存在する場合に呼び出すサービスツール
ソフト依存のみ: 不足しているツールはスキップされ、致命的ではありません

クイックスタート

# プラグイン一覧（スキャンなし）
python tools/cantina.py --list-plugins

# 単一ホスト
python tools/cantina.py 10.10.10.5 -t quick

# フルスキャン + プラグインによる偵察
python tools/cantina.py 10.10.10.5 -t recon \
  --force-services tcp/80/http tcp/445/smb tcp/22/ssh \
  -o ./out -j

# 複数ターゲットの並行処理
python tools/cantina.py -T hosts.txt -t all --max-workers 3 --timeout 90

サイレント 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 -e ".[dev]"   # または: pip install pytest
python -m pytest tests/ -q
# 期待値: exit 0

ライブターゲットなしでの主要機能:

python cantina.py --list-plugins
# 期待値: プラグイン名が出力され、exit 0

法的注意事項

列挙のみです。許可されたターゲットと自身のラボ / OSCP 試験範囲のみです。範囲の責任はあなたにあります。

構成

tools/              CLI ツール（実行方法: python tools/<tool>.py）
  cantina.py          CLI + オーケストレーター
  cantina_plugins.py  検出 / 選択 / 実行
plugins/            サービス列挙プラグイン
assets/banner.txt   CLI ターミナルバナー
banner.jpg          README ヒーロー画像
tests/              単体テスト（スタブ化されたツール）
lab/                オプションのマルチサービスラボのグラウンドトゥルース
fixtures/           nmap パースフィクスチャ

cantina

人気

Cantina

概要

機能

要件

クイックスタート

プラグイン

オフライン成功シグナル

法的注意事項

構成