Omniscient

Automated Offensive Recon Framework
Projet perso cyber – Reconnaissance, Enumération & Reporting

---

📌 Présentation

Omniscient est un outil modulaire de reconnaissance automatisée, conçu pour assister les phases de pentest et de CTF (Il est actuellement uniquement utilisé avec des inputs HackTheBox et donc pour l'instant uniquement fonctionnel pour des boxs de ce type). Il permet de lancer rapidement une suite cohérente de scans, d’enrichir dynamiquement la cartographie d’une cible, et de produire un rapport clair et exploitable.

Le projet est en cours de développement et amené à évoluer vers une solution complète avec interface graphique, smart chaining (enchainement des outils selons résultats précédents), analyse de vulnérabilités, dockerisation et plus.

L'objectif final est d'avoir un outil complet, éducatif et intelligent avec une intégration d'un LLM en Model Context Protocol afin d'orienter l'exploitation post-reconnaissance. C'est une façon pour moi de progresser et de développer mes connaissances sur différents aspects qui m'intéresses.

🧱 Organisation du projet Omniscient

L’outil Omniscient a été pensé pour être modulaire, clair et évolutif, dans l’objectif de s’adapter à tous types d’environnements (CTF, lab d'entraînement, audits plus poussés) sans dépendre d’un fonctionnement figé.

🔧 Chaque type de service (FTP, SMB, Web, SSH, etc.) est traité par un module indépendant, situé dans un répertoire modules/. Cette approche permet d’ajouter ou désactiver des modules facilement, selon les besoins du moment.

🧠 La première étape est un scan Nmap intelligent, qui identifie les ports ouverts et les services actifs. Ces résultats sont ensuite parsés pour générer un fichier machine-state.json qui contient des "flags" activés (ex: has_http, has_smb, has_ad, etc.).

💡 Ces flags déclenchent ensuite automatiquement les modules pertinents grâce à un système de chaining dynamique.

📄 Chaque module produit un fichier de résultats .txt, alimente un JSON centralisé, et contribue à un rapport Markdown complet généré à la fin. Ce rapport regroupe tous les services détectés, les résultats d’analyse, et les premières pistes d’exploitation potentielles.

🧩 L’architecture actuelle permet aussi d’envisager (et c'est le but final du projet) l’intégration d’un LLM via un Model Context Protocol : pour transmettre automatiquement les résultats des scans à un modèle d’IA afin de générer des suggestions de chemin d’exploitation pertinents et même d'automatiser l'exploitation.

---

⚙️ Fonctionnalités actuelles et à venir

• Scan Nmap (TCP, UDP, vulnérabilités, résultats parsé pour permettre la réutilisation par d'autres modules)
• Reconnaissance Web (WhatWeb, énumération Gobuster)
• Enum SMB / FTP / SSH (test des partages, test accès invité, bruteforce léger)
• Machine-state.json centralisé (état machine enrichi dynamiquement pour permettre aux modules d'avoir plus d'infos)
• Smart chaining automatique de modules en fonction des services détectés
• Rapport Markdown généré automatiquement (à travailler)
• Structure organisée et évolutive (modules isolés et indépendants, config YAML)
• Reconnaissance AD en cours d'implémentation
• Scan de vulnérabilités
• Interface graphique
• Dockerisation
• Intégration Model Context Protocol
• Et bien plus :)

---

📁 Arborescence

Omniscient :

Arboresence d'environnement pentest :

Pour créer l'arbo d'environnement Pentest :

mkdir -p ~/Pentest/{01_tools,02_targets/HTB,02_targets/TryHackMe,03_notes/cheatsheets,04_reports,05_scripts,06_vuln-db,07_wordlists,08_tmp}

---

🚀 Utilisation

Lancement principal :

sudo -E python3 ~/Omniscient/omniscient/main.py --target <NomMachine> --platform <HTB> --ip <IP>

Mode auto (smart chaining)

sudo -E python3 ~/Omniscient/omniscient/module_launcher.py --mode auto --target <NomMachine> --platform <HTB> --ip <IP>

Mode all (tout exécuter sauf nmap)

sudo -E python3 ~/Omniscient/omniscient/module_launcher.py --mode all --target <NomMachine> --platform <HTB> --ip <IP>

Module unique

python3 ~/Omniscient/omniscient/module_launcher.py --module <NomModule> --target <NomMachine> --platform <HTB> --ip <IP>

---

🔧 Installation

git clone https://github.com/lapouj/Omniscient.git
cd Omniscient
pip install -r requirements.txt

⚡ Pré-requis

• Python 3.8+
• nmap, whatweb, gobuster, enum4linux, smbmap, ftp, sshpass, nc
• SecLists installé dans ~/Pentest/01_tools/
• OS Linux (distro offensive recommandée)

Pour installer les outils :

sudo apt install -y $(cat apt-packages.txt)

---

🤝 Contribuer

Le projet est en cours de développement. Toute idée, retour, contribution ou collaboration est bienvenue.

N'hésitez pas à me contacter via LinkedIn.