CORE TopoGen

Genera topologías de red CORE reproducibles a partir de archivos XML de escenarios mediante una GUI web completa o una interfaz de línea de comandos.

Tabla de contenidos

Planificación de una única fuente – edita escenarios en el navegador o en cualquier editor XML y reproduce los resultados con la CLI.
Vistas previas deterministas – la semilla RNG opcional fija la expansión de hosts, la colocación de routers, la conectividad, los servicios, la segmentación y la asignación de vulnerabilidades.
Panel de registros en vivo – transmite la salida de ejecución, filtra por nivel o texto/regex y alterna el seguimiento automático para ejecuciones largas.
Políticas de topología enriquecidas – mallas R2R por elemento de enrutamiento, agregación R2S, límites de agrupación de hosts y re-homing de switches.
Artefactos en disco – los scripts de tráfico, las reglas de segmentación, las definiciones de docker-compose, los informes Markdown y los resúmenes JSON se escriben en ubicaciones predecibles para su inspección.
Compatibilidad con Hardware-in-the-Loop – gestiona los adjuntos HITL directamente en el editor; las opciones se limitan a routers/switches existentes o al aprovisionamiento de un nuevo router para mantener topologías deterministas.

Consulta la galería de imágenes de la interfaz web docs/screenshots.md.

Python 3.10+ (se recomienda 3.11)
CORE 9.2 o superior con core-daemon en ejecución
Docker (opcional) para el proxy inverso nginx/envoy o los objetivos de compose de vulnerabilidades

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

python main.py

Visita http://127.0.0.1:9090 por defecto (el proxy inverso nginx apunta a https://localhost).
El primer arranque crea una cuenta coreadmin / coreadmin; cámbiala de inmediato en Profile → Change Password.
Configura los proxies inversos TLS con make host-web, make host-web-nginx, o make host-web PROXY=envoy. El script auxiliar scripts/dev_gen_certs.sh emite certificados autofirmados con soporte SAN.
Nota del editor HITL: el desplegable “Attach to” ahora ofrece Existing Router, Existing Switch o New Router. La opción heredada New Switch se eliminó para evitar el fan-out oculto de switches; los escenarios guardados que la usan se normalizan a Existing Router durante la carga.

python -m core_topo_gen.cli --xml path/to/scenario.xml --seed 42 --verbose

Opciones populares:

--scenario NAME selecciona una entrada de escenario concreta
--host / --port sobrescriben el endpoint gRPC de CORE (por defecto 127.0.0.1:50051)
--layout-density {compact|normal|spacious} ajusta el espaciado del mapa
--seg-include-hosts, --seg-allow-docker-ports, --nat-mode, --dnat-prob ajustan la segmentación
--traffic-pattern, --traffic-rate, --traffic-content sobrescriben los valores de tráfico predeterminados

Guardar XML – El editor guarda automáticamente, pero pulsar “Save XML” garantiza vistas previas coherentes.
(Opcional) Establecer semilla – Ingresa una semilla entera para obtener una topología de salida determinista.
Generar vista previa completa – Muestra los recuentos de routers/hosts, las políticas R2R/R2S, la segmentación, los servicios, el tráfico y las asignaciones de vulnerabilidades antes de cualquier llamada a CORE.
Revisar secciones estructuradas – Alterna entre tarjetas estructuradas y JSON sin procesar; el historial guarda las últimas 25 vistas previas en el almacenamiento local.
Ejecutar (semilla) – Lanza la CLI de forma asíncrona, transmite los registros al panel y escribe un informe Markdown en ./reports/.

La planificación de hosts respeta las filas Base Hosts (densidad) y Count; los metadatos se escriben en el XML (base_nodes, additive_nodes, combined_nodes, etc.) para garantizar la fidelidad de ida y vuelta.
La planificación de routers y vulnerabilidades captura recuentos derivados frente a explícitos mediante explicit_count, derived_count y total_planned.
scenario_total_nodes a nivel de escenario resume los hosts, routers y objetivos de vulnerabilidad planificados.
Los ayudantes del parser exponen los metadatos mediante programación: core_topo_gen.parsers.planning_metadata.parse_planning_metadata().
Los planes Hardware-in-the-Loop persisten las preferencias por escenario (estado habilitado, lista de interfaces, elección de adjunto). Los adjuntos se normalizan a existing_router, existing_switch o new_router; los valores heredados new_switch se convierten a existing_router para que las vistas previas sigan siendo deterministas y no se sinteticen overlays de switches implícitamente.

r2r_mode por elemento de enrutamiento admite Exact, Uniform, NonUniform, Min, Max y mallas heredadas vinculadas a --router-mesh-style.
Las políticas R2S (r2s_mode, r2s_edges, opcionalmente r2s_hosts_min/max) reagrupan hosts detrás de switches dedicados, con “Exact=1” agregando todos los hosts de cada router en un único switch.
El JSON de vista previa y las estadísticas de ejecución capturan grados de router, recuentos de agregación y coeficientes de Gini para comprobaciones rápidas de equilibrio.

Los scripts de tráfico se colocan en /tmp/traffic (con servicios complementarios) y respetan las sobrescrituras de patrón, tasa, jitter e indicaciones de contenido.
Los scripts de segmentación se colocan en /tmp/segmentation junto con segmentation_summary.json; el modo NAT, la probabilidad DNAT, la inclusión de hosts y los permisos de puertos docker son configurables.
Las vulnerabilidades Docker adjuntan archivos docker-compose por nodo en /tmp/vulns, con metadatos incrustados en los nodos CORE.
Los plugins de tráfico personalizados pueden registrarse mediante core_topo_gen.plugins.traffic.register() para código de emisor/receptor a medida.