CORE TopoGen

Générez des topologies réseau CORE reproductibles à partir de fichiers XML de scénario en utilisant une interface Web riche ou une interface en ligne de commande.

Table des matières

• Points forts
• Captures d'écran
• Démarrage rapide
  • Prérequis
  • Installer les dépendances
  • Lancer l'interface Web
  • Exécuter la CLI
• Flux de travail Aperçu complet
• Plongée en profondeur des fonctionnalités
  • Sémantique de planification
  • Connectivité et agrégation des routeurs
  • Trafic, segmentation et services
  • Rapports et artefacts
• Aperçu de l'architecture
• Dépannage
• Documentation supplémentaire
• Contribuer
• Citation

Points forts

• Planification à source unique – éditez les scénarios dans le navigateur ou dans n'importe quel éditeur XML et reproduisez les résultats avec la CLI.
• Aperçus déterministes – une graine RNG optionnelle verrouille l'expansion des hôtes, le placement des routeurs, la connectivité, les services, la segmentation et l'affectation des vulnérabilités.
• Console de logs en direct – diffusez les sorties d'exécution, filtrez par niveau ou texte/regex, et activez le suivi automatique pour les longues exécutions.
• Politiques de topologie riches – maillages R2R par élément de routage, agrégation R2S, limites de regroupement d'hôtes et réaffectation de commutateurs.
• Artefacts sur disque – scripts de trafic, règles de segmentation, définitions docker-compose, rapports Markdown et résumés JSON sont écrits à des emplacements prévisibles pour inspection.
• Compatible Hardware-in-the-Loop – gérez les attachements HITL directement dans l'éditeur ; les options sont limitées aux routeurs/commutateurs existants ou à la mise à disposition d'un nouveau routeur pour garder les topologies déterministes.

Captures d'écran

Consultez la galerie d'images de l'interface Web docs/screenshots.md

Démarrage rapide

Prérequis

• Python 3.10+ (3.11 recommandé)
• CORE 9.2 ou plus récent avec core-daemon en cours d'exécution
• Docker (optionnel) pour le proxy inverse nginx/envoy ou les cibles compose de vulnérabilité

Installer les dépendances

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

Lancer l'interface Web

python main.py

• Accédez par défaut à http://127.0.0.1:9090 (le proxy inverse nginx cible https://localhost via docker-compose).
• Le premier démarrage crée un compte coreadmin / coreadmin ; changez-le immédiatement sous Profil → Changer le mot de passe.
• Configurez les proxys inverses TLS avec make host-web, make host-web-nginx ou make host-web PROXY=envoy. Le script d'aide scripts/dev_gen_certs.sh délivre des certificats auto-signés avec support SAN.
• Note de l'éditeur HITL : la liste déroulante « Attacher à » propose désormais Routeur existant, Commutateur existant ou Nouveau routeur. L'ancien choix Nouveau commutateur a été supprimé pour éviter l'extension cachée des commutateurs ; les scénarios sauvegardés qui l'utilisent sont normalisés en Routeur existant lors du chargement.

Exécuter la CLI

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

Options courantes :

• --scenario NAME choisir une entrée de scénario spécifique
• --host / --port remplacer le point de terminaison gRPC CORE (par défaut 127.0.0.1:50051)
• --layout-density {compact|normal|spacious} ajuster l'espacement de la carte
• --seg-include-hosts, --seg-allow-docker-ports, --nat-mode, --dnat-prob affiner la segmentation
• --traffic-pattern, --traffic-rate, --traffic-content remplacer les valeurs par défaut du trafic

Flux de travail Aperçu complet

1. Sauvegarder XML – L'éditeur sauvegarde automatiquement, mais cliquer sur « Sauvegarder XML » garantit des aperçus cohérents.
2. (Optionnel) Définir la graine – Entrez une graine entière pour obtenir une sortie de topologie déterministe.
3. Générer un aperçu complet – Affiche les comptes de routeurs/hôtes, les politiques R2R/R2S, la segmentation, les services, le trafic et les attributions de vulnérabilité avant tout appel CORE.
4. Examiner les sections structurées – Basculez entre les cartes structurées et le JSON brut ; l'historique stocke les 25 derniers aperçus dans le stockage local.
5. Exécuter (graine) – Lance la CLI de manière asynchrone, diffuse les logs dans la console et écrit un rapport Markdown dans ./reports/.

Plongée en profondeur des fonctionnalités

Sémantique de planification

• La planification des hôtes respecte les lignes Hôtes de base (densité) et Nombre ; les métadonnées sont écrites dans le XML (base_nodes, additive_nodes, combined_nodes, etc.) pour une fidélité aller-retour.
• La planification des routeurs et des vulnérabilités capture les comptes dérivés par rapport aux comptes explicites via explicit_count, derived_count et total_planned.
• Au niveau du scénario, scenario_total_nodes résume les hôtes, routeurs et cibles de vulnérabilité planifiés.
• Les assistants d'analyse exposent les métadonnées par programmation : core_topo_gen.parsers.planning_metadata.parse_planning_metadata().
• Les plans Hardware-in-the-Loop conservent les préférences par scénario (état activé, liste d'interfaces, choix d'attachement). Les attachements se normalisent en existing_router, existing_switch ou new_router ; les anciennes valeurs new_switch sont converties en existing_router afin que les aperçus restent déterministes et que les superpositions de commutateurs ne soient pas synthétisées implicitement.

Connectivité et agrégation des routeurs

• Par élément de routage, r2r_mode prend en charge Exact, Uniform, NonUniform, Min, Max et les maillages hérités liés à --router-mesh-style.
• Les politiques R2S (r2s_mode, r2s_edges, optionnel r2s_hosts_min/max) regroupent les hôtes derrière des commutateurs dédiés, avec « Exact=1 » agrégeant tous les hôtes par routeur en un seul commutateur.
• Le JSON d'aperçu et les statistiques d'exécution capturent les degrés des routeurs, les comptes d'agrégation et les coefficients de Gini pour des vérifications rapides d'équilibre.

Trafic, segmentation et services

• Les scripts de trafic atterrissent dans /tmp/traffic (avec des services compagnons) et respectent les surcharges pour les indices de motif, débit, gigue et contenu.
• Les scripts de segmentation atterrissent dans /tmp/segmentation accompagnés d'un segmentation_summary.json ; le mode NAT, la probabilité DNAT, l'inclusion des hôtes et les autorisations de ports Docker sont configurables.
• Les vulnérabilités Docker attachent des fichiers docker-compose par nœud dans /tmp/vulns, avec des métadonnées intégrées dans les nœuds CORE.
• Des plugins de trafic personnalisés peuvent s'enregistrer via core_topo_gen.plugins.traffic.register() pour du code émetteur/récepteur sur mesure.