スクリーンショット

WebUI画像ギャラリーは docs/screenshots.md をご覧ください。

クイックスタート

前提条件

• Python 3.10+（3.11推奨）
• CORE 9.2以上でcore-daemonが実行中であること
• Docker（オプション）。nginx/envoyリバースプロキシまたは脆弱性composeターゲット用

依存関係のインストール

Web UIの起動

• デフォルトでは http://127.0.0.1:9090 にアクセスします（リバースプロキシ nginx のcomposeターゲットは https://localhost）。
• 初回起動時に coreadmin / coreadmin アカウントが作成されます。プロフィール → パスワード変更 で直ちに変更してください。
• TLSリバースプロキシは make host-web、make host-web-nginx、または make host-web PROXY=envoy で設定します。ヘルパースクリプト scripts/dev_gen_certs.sh はSAN対応の自己署名証明書を発行します。
• HITLエディタの注意：「Attach to」ドロップダウンには Existing Router、Existing Switch、New Router が用意されています。隠れたスイッチファンアウトを防ぐため、従来の New Switch オプションは削除されました。これを使用して保存されたシナリオは、読み込み時に Existing Router に正規化されます。

CLIの実行

主なオプション：

• --scenario NAME 特定のシナリオエントリを選択
• --host / --port CORE gRPCエンドポイントを上書き（デフォルトは 127.0.0.1:50051）
• --layout-density {compact|normal|spacious} マップの間隔を調整
• --seg-include-hosts、--seg-allow-docker-ports、--nat-mode、--dnat-prob セグメンテーションを微調整
• --traffic-pattern、--traffic-rate、--traffic-content トラフィックのデフォルトを上書き

フルプレビューワークフロー

1. XMLを保存 – エディタは自動保存しますが、「Save XML」をクリックすると一貫したプレビューが保証されます。
2. （オプション）シードを設定 – 整数のシードを入力すると、決定論的なトポロジ出力が得られます。
3. フルプレビューを生成 – CORE呼び出しの前に、ルーター/ホスト数、R2R/R2Sポリシー、セグメンテーション、サービス、トラフィック、脆弱性の割り当てを表示します。
4. 構造化セクションを確認 – 構造化カードと生JSONを切り替えられます。履歴は直近25件のプレビューをローカルストレージに保存します。
5. 実行（シード） – CLIを非同期で起動し、ログをドックにストリーミングし、Markdownレポートを ./reports/ に書き込みます。

機能の詳細

プランニングのセマンティクス

• ホストプランニングはベースホスト（密度）とカウント行を尊重します。往復の忠実性のために、メタデータはXML（base_nodes、additive_nodes、combined_nodes など）に書き込まれます。
• ルーターと脆弱性のプランニングは、explicit_count、derived_count、total_planned を通じて導出カウントと明示カウントを記録します。
• シナリオレベルの scenario_total_nodes は、計画されたホスト、ルーター、脆弱性ターゲットを要約します。
• パーサーヘルパーはメタデータをプログラムで公開します：core_topo_gen.parsers.planning_metadata.parse_planning_metadata()。
• Hardware-in-the-Loopプランはシナリオごとの設定（有効状態、インターフェースリスト、アタッチメントの選択）を保持します。アタッチメントは existing_router、existing_switch、または new_router に正規化されます。従来の new_switch 値は existing_router に強制変換されるため、プレビューは決定論的に保たれ、スイッチオーバーレイが暗黙的に合成されることはありません。

ルーター接続と集約

• ルーティング項目ごとの r2r_mode は Exact、Uniform、NonUniform、Min、Max、および --router-mesh-style に紐づく従来のメッシュをサポートします。
• R2Sポリシー（r2s_mode、r2s_edges、オプションの r2s_hosts_min/max）は、専用スイッチの背後にホストを再グループ化します。「Exact=1」はルーターごとのすべてのホストを単一のスイッチに集約します。
• プレビューJSONとランタイム統計は、迅速なバランス確認のためにルーターの次数、集約数、ジニ係数を記録します。

トラフィック、セグメンテーション、サービス

• トラフィックスクリプトは /tmp/traffic に配置され（付随サービスを含む）、パターン、レート、ジッター、コンテンツヒントの上書きを尊重します。
• セグメンテーションスクリプトは segmentation_summary.json とともに /tmp/segmentation に配置されます。NATモード、DNAT確率、ホストの包含、Dockerポートの許可は設定可能です。
• Docker脆弱性は /tmp/vulns にノードごとのdocker-composeファイルを添付し、メタデータはCOREノードに埋め込まれます。
• カスタムトラフィックプラグインは、独自の送信者/受信者コード用に core_topo_gen.plugins.traffic.register() を通じて登録できます。

レポートと成果物

• Markdownレポート（./reports/scenario_report_<timestamp>.md）は、トポロジ統計、プランニングメタデータ、セグメンテーション結果、ランタイム成果物を列挙します。各実行では、Markdownファイル（scenario_report_<timestamp>.json）とともにJSONサマリーも出力され、ルーター次数データが利用可能な場合は実行ごとの接続性CSVも出力されます。
• 実行履歴はレポートページ用に outputs/run_history.json に保持されます。
• 安全な削除では、GUIでシナリオが削除されたときに outputs/ 配下の関連出力を削除しつつ、レポートは保持します。

アーキテクチャ概要

トラブルシューティング

• core-python が見つからない – make host-web の前に WEBUI_PY を設定するか、python3 に依存してください。必要に応じてバックエンドは sys.executable にフォールバックします。
• TLS証明書フォルダが空（nginx/certs） – nginxをcomposeする前に scripts/dev_gen_certs.sh または make dev-certs を実行してください。
• core-daemon に到達できない – デーモンの状態とホスト/ポートを確認してください。GUIの実行モーダルは接続の問題を即座に表示します。
• Docker脆弱性がスキップされる – 脆弱性カタログからイメージがダウンロード/プルされ、ホストでDockerが利用可能であることを確認してください。
• ログドックが自動スクロールしない – 「Follow Off/On」トグルをクリックして自動フォローを再度有効にしてください。

追加ドキュメント

• API.md – Web UIバックエンドが公開するRESTエンドポイント
• SCENARIO_XML_SCHEMA.md – スキーマの解説と例

貢献

プルリクエストと問題報告を歓迎します！変更を送信する前に該当するpytestターゲット（pytest -q）を実行し、動作が変更された場合はドキュメントを最新の状態に保ってください。

引用：

@article{rodriguez2025agentcyte,

title={AgentCyTE: Leveraging Agentic AI to Generate Cybersecurity Training & Experimentation Scenarios},

author={Rodriguez, Ana M and Acosta, Jaime and Kotal, Anantaa and Piplai, Aritran},

journal={Annual Computer Security Applications Conference Workshop (ACSACW)},

year={2025}

}