Application de bureau pour la gestion de laboratoires de machines virtuelles VirtualBox, à destination des analystes en cybersécurité (étudiants, pentesteurs, chercheurs).
CyberLab Manager n'est pas un hyperviseur — c'est une couche de gestion au-dessus de VirtualBox. Elle permet d'organiser des VM en laboratoires thématiques (malware, pentest, réseau...), de les piloter, de gérer leurs snapshots, de tenir un journal d'analyse horodaté, et d'exporter tout le contenu souhaité en des rapports PDF complets.
Vous verrez ceci comme écran principal de l'application .
Appuyez sur le bouton Import VM en bas à gauche et un formulaire de création d'un laboratoire de travail apparaîtra .
Voici un exemple rempli pour la démonstration
Un message de confirmation devrait apparaître offrant la possibilité d'importer des VM immédiatement .
Si vous importez une machine une machine virtuelle, l'appli détectera vos VMs et vous offrira la possibilité de choisir , dans notre exemple, étant donné une seule machine présente , on l'a choisi .
De retour sur l'écran principale , vous pourez voir votre VM fraîchement importée.
Maintenant vous pourrez manager cette machine. Cliquez dessus et les options devraient apparaître un peu comme ceci
À présent cliquez sur le bouton vert Start à droite et la machine devrait démarrer en background , et vous devriez voir le bouton changer pour vous indiquer cela.
Vous pouvez aller checker cela en temps réel comme on l'a fait dans l'exemple .
Une fois votre travail fini vous pouvez rééteindre votre machine en appuyant sur le bouton maintenant devenu rouge Stop.
Juste en haut m bouton bleu ,vous pouvez décider d'exporter votre travail fait jusque là en format PDF.
Warning
Cette fonctionnalité est encore en perfection et nous travaillons activement pour apporter des améliorations plus poussées et professionnelles, toutefois , cela devrait fonctionner parfaitement.
Cela est un exemple de pdf que vous pourrez générer .
- Gestion de laboratoires — création, modification, suppression de laboratoires thématiques
- Import de VM — détection automatique des VM VirtualBox existantes, rattachement à un laboratoire (ou VM orphelines)
- Pilotage complet — démarrage, arrêt, sauvegarde d'état
- Snapshots — création et restauration d'instantanés VirtualBox
- Journal d'analyse — prise de notes horodatées par VM, persistées en base
- Export PDF — rapport récapitulatif par laboratoire (VM, statuts, snapshots, notes)
- Configuration — chemin VBoxManage et dossier d'export personnalisables
Le projet suit une architecture en couches avec séparation stricte des responsabilités :
tg.cyberlabmanager
├── model → Entités métier (Lab, VirtualMachine, Snapshot, JournalEntry, AuditEntry, VMStatus, AppConfig)
├── hypervisor → Intégration VirtualBox (IHypervisor, VBoxOrchestrator, exceptions)
├── data → Persistance SQLite (DatabaseManager)
├── pdf → Génération de rapports (PdfExporter, Apache PDFBox)
├── controller → Orchestration (LabController)
└── ui → Interface JavaFX
Chaque couche est développée indépendamment autour de contrats d'interface fermes, permettant un développement parallèle en équipe sans conflit d'intégration.
| Composant | Technologie |
|---|---|
| Langage | Java 17 |
| Interface graphique | JavaFX 21.0.6 |
| Build | Maven (JPMS / module tg.cyberlabmanager) |
| Persistance | SQLite (sqlite-jdbc) |
| Export PDF | Apache PDFBox |
| Tests | JUnit 5, Mockito |
| CI | GitHub Actions |
| Intégration hyperviseur | VirtualBox via VBoxManage (ProcessBuilder) |
- Java 17 (JDK)
- Maven (ou utiliser le wrapper
./mvnwinclus) - VirtualBox installé, avec
VBoxManageaccessible
git clone https://github.com/4rthur-Root/CyberLab.git
cd CyberLab
./mvnw javafx:run./mvnw testProjet réalisé en trinôme, avec une répartition claire des responsabilités formalisée dans un contrat d'interface dès le lancement du projet.
| Rôle | Responsabilité | Modules |
|---|---|---|
| Rôle 1(GAHOUNZO) — Lead Front-end / UX | Interface graphique JavaFX, orchestration via LabController |
ui, controller |
| Rôle 2(AKAKPO) — Back-end / Data | Persistance SQLite, export PDF, configuration | data, pdf |
| Rôle 3(KPODONOU) — Ingénieur VirtualBox / Intégration | Modèle métier, intégration VirtualBox | model, hypervisor |
Cette approche contractuelle — chaque rôle s'engageant sur des signatures de méthodes précises avant l'implémentation — a permis un développement parallèle sans blocage d'intégration majeur.
- Tests unitaires systématiques sur la logique métier et de parsing (couverture complète des couches
modelethypervisor) - Intégration continue via GitHub Actions à chaque push et pull request
- Revue de code obligatoire avant fusion sur les branches protégées (
develop,main) - Convention de branches :
feature/**→develop→main - Commits conventionnels en français pour un historique lisible
L'application répond au cahier des charges académique. Les pistes suivantes sont envisagées pour en faire un outil utilisable au-delà du cadre du cours :
- Support multi-hyperviseur (KVM/libvirt) pour une utilisation sur environnements Linux natifs
- Piste d'audit complète (traçabilité de chaque action sur les VM)
- Export et import de configuration de laboratoire (portabilité entre postes)
- Packaging natif multi-plateforme (
.exe,.deb,.rpm,.AppImage,.dmg) via jpackage - Interface en ligne de commande (CLI) pour l'automatisation
Projet réalisé dans le cadre d'un cours de développement logiciel. Merci à notre professeur pour l'encadrement et à VirtualBox / Apache PDFBox pour leurs outils open source.