CORE TopoGen

Gere topologias de rede CORE reproduzíveis a partir de arquivos XML de cenário usando uma GUI Web rica ou uma interface de linha de comando.

Índice

Planejamento de fonte única – edite cenários no navegador ou em qualquer editor XML e reproduza resultados com a CLI.
Pré-visualizações determinísticas – semente RNG opcional fixa expansão de hosts, posicionamento de roteadores, conectividade, serviços, segmentação e atribuição de vulnerabilidades.
Painel de logs ao vivo – transmita a saída da execução, filtre por nível ou texto/regex e alterne o acompanhamento automático para execuções longas.
Políticas de topologia ricas – malhas R2R por item de roteamento, agregação R2S, limites de agrupamento de hosts e re-homing de switches.
Artefatos em disco – scripts de tráfego, regras de segmentação, definições docker-compose, relatórios Markdown e resumos JSON são gravados em locais previsíveis para inspeção.
Compatível com Hardware-in-the-Loop – gerencie anexos HITL diretamente no editor; as opções são restritas a roteadores/switches existentes ou ao provisionamento de um novo roteador para manter as topologias determinísticas.

Veja a galeria de imagens da WebUI em docs/screenshots.md.

Python 3.10+ (3.11 recomendado)
CORE 9.2 ou mais recente com core-daemon em execução
Docker (opcional) para proxy reverso nginx/envoy ou alvos compose de vulnerabilidades

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

python main.py

Acessa http://127.0.0.1:9090 por padrão (o compose nginx do proxy reverso aponta para https://localhost).
No primeiro início, uma conta coreadmin / coreadmin é criada; altere-a imediatamente em Perfil → Alterar Senha.
Configure proxies reversos TLS com make host-web, make host-web-nginx ou make host-web PROXY=envoy. O script auxiliar scripts/dev_gen_certs.sh emite certificados autoassinados com suporte a SAN.
Nota do editor HITL: o menu suspenso “Anexar a” agora oferece Existing Router, Existing Switch ou New Router. A opção legada New Switch foi removida para evitar fan-out oculto de switches; cenários salvos que a utilizam são normalizados para Existing Router durante o carregamento.

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

Opções populares:

--scenario NAME selecione uma entrada de cenário específica
--host / --port substitua o endpoint gRPC do CORE (padrão 127.0.0.1:50051)
--layout-density {compact|normal|spacious} ajuste o espaçamento do mapa
--seg-include-hosts, --seg-allow-docker-ports, --nat-mode, --dnat-prob ajuste fino da segmentação
--traffic-pattern, --traffic-rate, --traffic-content substitua os padrões de tráfego

Salvar XML – O editor salva automaticamente, mas clicar em “Salvar XML” garante pré-visualizações consistentes.
(Opcional) Definir semente – Insira uma semente inteira para obter uma saída de topologia determinística.
Gerar Pré-visualização Completa – Mostra contagens de roteadores/hosts, políticas R2R/R2S, segmentação, serviços, tráfego e atribuições de vulnerabilidades antes de qualquer chamada ao CORE.
Revisar seções estruturadas – Alterne entre cartões estruturados e JSON bruto; o histórico armazena as últimas 25 pré-visualizações no armazenamento local.
Executar (Semente) – Inicia a CLI de forma assíncrona, transmite logs para o painel e grava um relatório Markdown em ./reports/.

O planejamento de hosts respeita as linhas Base Hosts (densidade) e Count; os metadados são gravados no XML (base_nodes, additive_nodes, combined_nodes, etc.) para fidelidade de ida e volta.
O planejamento de roteadores e vulnerabilidades captura contagens derivadas vs. explícitas via explicit_count, derived_count e total_planned.
O scenario_total_nodes em nível de cenário resume hosts, roteadores e alvos de vulnerabilidade planejados.
Helpers de parser expõem os metadados programaticamente: core_topo_gen.parsers.planning_metadata.parse_planning_metadata().
Planos Hardware-in-the-Loop persistem preferências por cenário (estado habilitado, lista de interfaces, escolha de anexo). Anexos são normalizados para existing_router, existing_switch ou new_router; valores legados new_switch são convertidos para existing_router para que as pré-visualizações permaneçam determinísticas e sobreposições de switches não sejam sintetizadas implicitamente.

O r2r_mode por item de roteamento suporta Exact, Uniform, NonUniform, Min, Max e malhas legadas vinculadas a --router-mesh-style.
Políticas R2S (r2s_mode, r2s_edges, opcional r2s_hosts_min/max) reagrupam hosts atrás de switches dedicados, com “Exact=1” agregando todos os hosts por roteador em um único switch.
O JSON de pré-visualização e as estatísticas de execução capturam graus de roteadores, contagens de agregação e coeficientes de Gini para verificações rápidas de equilíbrio.

Scripts de tráfego são gravados em /tmp/traffic (com serviços complementares) e respeitam substituições de padrão, taxa, jitter e dicas de conteúdo.
Scripts de segmentação são gravados em /tmp/segmentation junto com um segmentation_summary.json; modo NAT, probabilidade DNAT, inclusão de hosts e permissões de portas docker são configuráveis.
Vulnerabilidades Docker anexam arquivos docker-compose por nó em /tmp/vulns, com metadados incorporados aos nós CORE.
Plugins de tráfego personalizados podem se registrar via core_topo_gen.plugins.traffic.register() para código remetente/receptor personalizado.

Relatórios Markdown (./reports/scenario_report_<timestamp>.md) enumeram estatísticas de topologia, metadados de planejamento, resultados de segmentação e artefatos de execução. Cada execução também gera um resumo JSON junto ao arquivo Markdown (scenario_report_<timestamp>.json), além de CSVs de conectividade por execução quando dados de grau de roteadores estão disponíveis.
O histórico de execuções é persistido em outputs/run_history.json para a página de Relatórios.
A exclusão segura mantém os relatórios enquanto remove as saídas associadas em outputs/ quando cenários são removidos via GUI.