LSIT - Linux System Inventory Tool

LSIT est un outil d'inventaire et de cartographie d'infrastructure système développé en Python. Il permet d'auditer rapidement une machine Linux, d'extraire ses métriques vitales et de générer un rapport structuré ou de visualiser les données via un tableau de bord web.

Ce projet met en pratique les concepts d'Infrastructure as Code (IaC) et de développement d'outils d'administration en ligne de commande (CLI).

Fonctionnalités (v0.3.1)

• Auto-détection : Récupération du nom d'hôte, de la RAM totale et du modèle de CPU.
• Audit d'activité : Capture des processus actifs et cartographie de l'arborescence /home/vagrant.
• Audit de sécurité : Détection des ports réseau en écoute (ss -tuln) et identification des utilisateurs avec privilèges sudo.
• Monitoring système : Affichage de l'espace disque (df -h), de l'uptime et du load average.
• Interopérabilité : Exportation des rapports au format texte brut (.txt) ou structuré (.json).
• Tableau de bord web : Visualisation des données en temps réel via un serveur Flask intégré (port 8080), avec rafraîchissement automatique toutes les 5 secondes.
• API REST : Endpoint /api/donnees retournant les métriques au format JSON.
• Menu interactif SSH : Interface de navigation accessible directement depuis la session SSH.
• Horodatage : Traçabilité précise de l'heure de l'audit.
• Version dynamique : La version est lue automatiquement depuis le CHANGELOG.md.
• Automatisation Cron : Génération quotidienne automatique d'un rapport JSON à minuit.

Prérequis

Pour déployer le laboratoire d'environnement isolé, vous devez avoir installé sur votre machine hôte :

• Vagrant
• VirtualBox
• Git

Installation et Déploiement

L'environnement est entièrement automatisé. L'outil s'installe globalement sur la machine cible lors du provisionnement.

1. Clonez ce dépôt :

   git clone https://github.com/Deniz09OK/Linux-System-Inventory-Tool
   cd Linux-System-Inventory-Tool

2. Démarrez l'infrastructure (Debian 12) :

   vagrant up

3. Connectez-vous au serveur :

   vagrant ssh

Le port 8080 de la VM est automatiquement redirigé vers le port 8081 de la machine hôte.

Utilisation

Une fois connecté en SSH, le menu interactif se lance automatiquement. La commande lsit est également disponible globalement sur le système.

# Lancer le menu interactif (défaut)
lsit

# Générer directement un rapport texte
lsit --format txt

# Générer directement un rapport JSON structuré
lsit --format json

# Lancer directement le tableau de bord web sur le port 8080
lsit --serve

# Afficher la version
lsit -v

Menu interactif

===================================
   LSIT v0.3.1 - 2026-03-26
===================================
  1. Générer un rapport TXT
  2. Générer un rapport JSON
  3. Lancer le tableau de bord web
  4. Retour au menu principal
===================================

Tableau de bord web

Le tableau de bord web est accessible sur http://localhost:8081 (port forwardé depuis la VM) après le lancement via lsit --serve ou l'option 3 du menu interactif.

Il affiche en temps réel les informations suivantes (rafraîchissement automatique toutes les 5 secondes) :

Section	Contenu
Machine	Nom d'hôte de la machine
Processeur	Modèle du CPU
Mémoire RAM	Quantité totale de RAM
Uptime	Temps d'activité du système
Load Average	Charge moyenne (1/5/15 min)
Sudoers	Utilisateurs avec privilèges sudo
Espace disque	Sortie de df -h
Ports réseau en écoute	Sortie de ss -tuln
Arborescence /home/vagrant	Structure des dossiers (2 niveaux)
Processus actifs	Sortie de ps aux

API REST

L'endpoint /api/donnees retourne toutes les métriques au format JSON, permettant l'intégration avec d'autres outils de monitoring.

curl http://localhost:8081/api/donnees

Pour arrêter le serveur, tapez exit ou end dans le terminal.

Format des rapports

TXT (rapport_lsit.txt)

Date de l'audit : 2026-03-26 10:30:00
La cible a été identifiée. Nom de la machine : debian-vm
Mémoire totale : MemTotal: 2048000 kB
Modèle du CPU : Intel(R) Core(TM) i7-...

===================================
        PROCESSUS ACTIFS
===================================
...

===================================
      ARBORESCENCE DOSSIERS
===================================
...

===================================
       AUDIT DE SÉCURITÉ
===================================
Groupe Sudo : sudo:x:27:vagrant

Ports ouverts :
Netid  State   Local Address:Port  ...

JSON (rapport_lsit.json)

{
  "date": "2026-03-26 10:30:00",
  "machine": "debian-vm",
  "ram": "MemTotal: 2048000 kB",
  "cpu": "Intel(R) Core(TM) i7-...",
  "processus": "...",
  "arborescence": "...",
  "securite_ports": "Netid  State   Local Address:Port  ...",
  "securite_sudoers": "sudo:x:27:vagrant",
  "stockage": "Filesystem      Size  Used Avail Use% ...",
  "uptime": "10:30:00 up 2 days, 3:45, 1 user",
  "load_average": "0.15, 0.10, 0.05"
}

CI/CD — Versioning automatique

Le projet utilise un workflow GitHub Actions (versionning.yml) pour gérer le versioning sémantique automatiquement à chaque push sur main.

Préfixe de commit	Effet
feat: / ✨ / 🚀	Bump mineur (x.Y.0)
fix: / 🐛 / perf: / refactor:	Bump patch (x.y.Z)
BREAKING CHANGE / !:	Bump majeur (X.0.0)
docs: / autres	Pas de bump

Le workflow génère et commit automatiquement le CHANGELOG.md, puis crée et pousse le tag Git correspondant. Un mode dry-run est disponible via workflow_dispatch pour prévisualiser les changements sans les appliquer.

Structure du projet

Linux-System-Inventory-Tool/
├── .github/
│   └── workflows/
│       └── versionning.yml  # Workflow CI/CD de versioning sémantique
├── lsit.py                  # Script principal
├── Vagrantfile              # Configuration de la VM Debian 12
├── CHANGELOG.md             # Historique des versions
├── templates/
│   └── dashboard.html       # Template du tableau de bord web (Jinja2/Flask)
├── static/
│   └── style.css            # Styles du tableau de bord 
└── .gitignore